Skip to main content
GET
/
dev
/
fees
cURL
curl --request GET \
  --url https://api.example.com/dev/fees \
  --header 'x-dev-auth: <x-dev-auth>'
{
  "id": "<string>",
  "name": "<string>",
  "pendingFeesUusdc": 123,
  "lockedFeesUusdc": 123,
  "unclaimedFeesUusdc": 123,
  "payoutChain": "<string>",
  "signerAddress": "<string>"
}
Query fee balances for your authenticated developer account.

​
Authentication

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

​
X-Dev-Auth Format

{
  "devAccountId": "your-dev-account-id",
  "action": "<action>",
  "expiry": 1734567890,
  "signature": "0x..."
}
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:
StateDescription
PendingFees from trades that haven’t been confirmed yet
LockedFees locked for payout (awaiting operator settlement)
UnclaimedFees available to claim via the vault contract
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
number
required

Fees pending confirmation (µUSDC)

​
lockedFeesUusdc
number
required

Fees locked for payout (µUSDC)

​
unclaimedFeesUusdc
number
required

Fees available to claim (µUSDC)

​
payoutChain
string
required

Chain for fee payouts

​
signerAddress
string
required

Address receiving fee payouts