Skip to main content
GET
cURL
Query fee balances for your authenticated developer account.

Authentication

This endpoint requires EIP-712 signature-based authentication via the X-Dev-Auth header.
string
required
JSON-encoded authentication payload containing the signed message.

X-Dev-Auth Format

The signature must be an EIP-712 typed data signature with:
  • Domain: { name: "BisonDevAuth", version: "1" }
  • Primary Type: DevAccountAuth
  • Message Fields:
    • devAccountId (string): Your dev account identifier
    • action (string): The action being performed (see endpoint docs)
    • expiry (uint256): Unix timestamp when signature expires (max 5 minutes in future)
The signature must be signed by the wallet associated with your dev account’s signerAddress. The action field must be "fees" for this endpoint.

Fee States

Fees progress through the following states: Only unclaimed fees can be claimed. Pending and locked fees will become claimable after the settlement process completes.

Headers

x-dev-auth
string
required

JSON-encoded auth payload: { devAccountId, action, expiry, signature }. Signature is EIP-712 typed data signed by the dev account signer.

Example:

"{\"devAccountId\":\"my-dev-account\",\"action\":\"info\",\"expiry\":1734567890,\"signature\":\"0x...\"}"

Response

Dev account fee balances

id
string
required

Dev account ID

name
string
required

Dev account name

pendingFeesUusdc
string
required

Fees pending confirmation (µUSDC)

lockedFeesUusdc
string
required

Fees locked for payout (µUSDC)

unclaimedFeesUusdc
string
required

Fees available to claim (µUSDC)

payoutChain
string
required

Chain for fee payouts

signerAddress
string
required

Address receiving fee payouts