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

# Bridge Integrator Fees

> [Alpha Preview] Off-chain integrator fee balance of a fee wallet, and its recent claims.

> [!WARNING]
>
> **Alpha Preview** — Endpoints and response shape may change without notice.

Quotes made with [`feePayout=claim`](https://docs.mobula.io/rest-api-reference/endpoint/bridge-quote#claim-mode)
don't pay the integrator fee at fill. Each `feeWallet` builds up an off-chain
balance instead, and withdraws it in USDC whenever it wants:

1. **Balance** — `GET /api/2/bridge/integrator-fees/{address}` (this page).
2. **Prepare** — [`POST /api/2/bridge/integrator-fees/{address}/claim`](https://docs.mobula.io/rest-api-reference/endpoint/bridge-integrator-fees-claim)
   returns the message the fee wallet signs.
3. **Submit** — [`POST /api/2/bridge/integrator-fees/claims/{claimId}`](https://docs.mobula.io/rest-api-reference/endpoint/bridge-integrator-fees-claim-submit)
   with the signature. Mobula sends the USDC.

## Path parameter

| Name | Notes |
| - | - |
| `address` | The fee wallet: EVM (`0x…`) or Solana (base58). Anything else returns `400`. |

## Response

```json theme={null}
{
  "data": {
    "address": "0xyourfeewallet",
    "availableUsd": 312.79544,
    "earnedUsd": 845.12,
    "paidUsd": 500,
    "pendingUsd": 32.32456,
    "claims": [
      {
        "claimId": "6f1c2a9e-4b7d-4c1e-9a53-2d8f0e7b1c44",
        "status": "sending",
        "chainId": "evm:8453",
        "recipient": "0xYourFeeWallet",
        "amountUsd": 32.32456,
        "networkFeeUsd": 0.0041,
        "receiveAmount": "32.32046",
        "txHash": "0x…",
        "error": null,
        "createdAt": "2026-10-20T09:12:03.000Z",
        "updatedAt": "2026-10-20T09:12:05.000Z"
      }
    ]
  }
}
```

* `earnedUsd` — credits of every intent that filled. Refunded intents never count.
* `paidUsd` — claims already paid. `pendingUsd` — claims accepted and not paid yet.
* `availableUsd` = `earnedUsd − paidUsd − pendingUsd`: what a new claim can take.
* `claims` — the 20 most recent claims, newest first. See
  [claim statuses](https://docs.mobula.io/rest-api-reference/endpoint/bridge-integrator-fees-claim-submit#claim-statuses).

EVM addresses come back lowercased. Responses are never cached.


## OpenAPI

````yaml get /2/bridge/integrator-fees/{address}
openapi: 3.0.0
info:
  version: 1.0.0
  title: Mobula API
  description: >-
    Documentation of the Mobula API


    **Demo API**: The default server (demo-api.mobula.io) is a demo API with
    rate limits.

    For production use, please use api.mobula.io with an API key from
    https://admin.mobula.io
servers:
  - url: https://demo-api.mobula.io/api/
    description: Demo API (rate limited, for testing only)
  - url: https://api.mobula.io/api/
    description: Production API (requires API key)
security: []
tags:
  - name: V2 - Token
    description: Token details, price, security, ATH, and holder data
  - name: V2 - Market Data
    description: Market details, OHLCV history, and lighthouse metrics
  - name: V2 - Trades
    description: Token trades, enriched trades, and trade filters
  - name: V2 - Wallet
    description: Wallet positions, activity, trades, analysis, and labels
  - name: V2 - Assets
    description: Cross-chain asset details and price history
  - name: V2 - Swap
    description: Swap quoting and execution
  - name: V2 - Perps
    description: Perpetual futures quoting, execution, and positions
  - name: V2 - Bridge
    description: Cross-chain bridge quoting and intent status (Alpha Preview)
  - name: V2 - DeFi
    description: Bonding pools and pulse data
  - name: V2 - Search
    description: Universal fast search
  - name: V2 - Usage
    description: Per-key API and WebSocket usage history
  - name: V2 - Blockchains
    description: System metadata and chain listings
  - name: V2 - Prediction Markets
    description: >-
      Polymarket markets/events, wallet positions, and the full execution stack
      (auth, order build/submit/cancel, approvals, pUSD wrap/unwrap, deploy,
      deposit/withdraw, redeem). Alpha — see /api/2/pm/*.
  - name: V1 - Market Data
    description: Market prices, history, sparklines, pairs, and multi-data
  - name: V1 - Wallet
    description: Wallet portfolio, transactions, history, and NFTs
  - name: V1 - Token
    description: First buyers
  - name: V1 - Trades
    description: Market trades by pair
  - name: V1 - Metadata
    description: Token metadata, categories, and news
  - name: V1 - Assets
    description: List all assets
  - name: V1 - Search
    description: Search for assets, tokens, and pairs
  - name: V1 - DeFi
    description: Bonding pool pulse data
  - name: V1 - Blockchains
    description: Blockchain listings, pairs, and stats
  - name: V1 - Webhooks
    description: Webhook management
  - name: V1 - Feed
    description: Custom feed creation
paths:
  /2/bridge/integrator-fees/{address}:
    get:
      tags:
        - V2 - Bridge
      summary: Get an integrator fee balance
      description: >-
        [Alpha Preview] Off-chain integrator fee balance of a fee wallet,
        credited by intents quoted with `feePayout=claim` once they fill, and
        its 20 most recent claims. availableUsd = earnedUsd - paidUsd -
        pendingUsd.
      parameters:
        - schema:
            type: string
            description: Fee wallet, EVM (0x…) or Solana (base58).
          required: true
          description: Fee wallet, EVM (0x…) or Solana (base58).
          name: address
          in: path
      responses:
        '200':
          description: Balance and recent claims.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      address:
                        type: string
                        description: The fee wallet, EVM lowercased.
                      availableUsd:
                        type: number
                        description: What a new claim can take.
                      earnedUsd:
                        type: number
                        description: >-
                          Credits of every intent that filled. Refunded intents
                          never count.
                      paidUsd:
                        type: number
                        description: Claims already paid.
                      pendingUsd:
                        type: number
                        description: Claims accepted and not paid yet.
                      claims:
                        type: array
                        description: The 20 most recent claims, newest first.
                        items:
                          type: object
                          properties:
                            claimId:
                              type: string
                            status:
                              type: string
                              enum:
                                - pending
                                - sending
                                - paid
                                - failed
                              description: >-
                                pending → sending → paid | failed. A failed
                                claim paid nothing and its amount is back in
                                availableUsd.
                            chainId:
                              type: string
                            recipient:
                              type: string
                            amountUsd:
                              type: number
                              description: Debited from the balance.
                            networkFeeUsd:
                              type: number
                              description: Payout network cost, deducted from what is sent.
                            receiveAmount:
                              type: string
                              nullable: true
                              description: USDC sent, in human units.
                            txHash:
                              type: string
                              nullable: true
                            error:
                              type: string
                              nullable: true
                              description: Why the claim failed (failed claims only).
                            createdAt:
                              type: string
                            updatedAt:
                              type: string
                    required:
                      - address
                      - availableUsd
                      - earnedUsd
                      - paidUsd
                      - pendingUsd
                      - claims
                required:
                  - data
        '400':
          description: The address is not an EVM or Solana address.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.