> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bison.markets/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Dev Account Fees

Query fee balances for your authenticated developer account.

## Authentication

This endpoint requires EIP-712 signature-based authentication via the `X-Dev-Auth` header.

<ParamField header="X-Dev-Auth" type="string" required>
  JSON-encoded authentication payload containing the signed message.
</ParamField>

### X-Dev-Auth Format

```json theme={null}
{
  "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:

| State         | Description                                           |
| ------------- | ----------------------------------------------------- |
| **Pending**   | Fees from trades that haven't been confirmed yet      |
| **Locked**    | Fees locked for payout (awaiting operator settlement) |
| **Unclaimed** | Fees 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.


## OpenAPI

````yaml GET /dev/fees
openapi: 3.0.0
info:
  version: 1.0.0
  title: Bison API
servers: []
security: []
paths:
  /dev/fees:
    get:
      parameters:
        - schema:
            type: string
            description: >-
              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..."}
          required: true
          description: >-
            JSON-encoded auth payload: { devAccountId, action, expiry, signature
            }. Signature is EIP-712 typed data signed by the dev account signer.
          name: x-dev-auth
          in: header
      responses:
        '200':
          description: Dev account fee balances
          content:
            application/json:
              schema:
                type: object
                properties:
                  id:
                    type: string
                    description: Dev account ID
                  name:
                    type: string
                    description: Dev account name
                  pendingFeesUusdc:
                    type: string
                    description: Fees pending confirmation (µUSDC)
                  lockedFeesUusdc:
                    type: string
                    description: Fees locked for payout (µUSDC)
                  unclaimedFeesUusdc:
                    type: string
                    description: Fees available to claim (µUSDC)
                  payoutChain:
                    type: string
                    description: Chain for fee payouts
                  signerAddress:
                    type: string
                    description: Address receiving fee payouts
                required:
                  - id
                  - name
                  - pendingFeesUusdc
                  - lockedFeesUusdc
                  - unclaimedFeesUusdc
                  - payoutChain
                  - signerAddress
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                required:
                  - error

````