LI.FI Integrators API

The Integrators API from LI.FI — 2 operation(s) for integrators.

Operations 2

GET /v1/integrators/{integratorId} Get integrator's collected fees data for all supported chains
GET /v1/integrators/{integratorId}/withdraw/{chainId} Get transaction request for withdrawing collected integrator's fees by chain

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/lifi-integrators-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

lifi-integrators-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: LI.FI Integrators API
  version: 1.0.0
  description: LI.FI provides the best cross-chain swap across all liquidity pools and bridges.
servers:
- url: https://li.quest
  description: LI.FI Production Environment
- url: https://staging.li.quest
  description: LI.FI Staging Environment
tags:
- name: Integrators
paths:
  /v1/integrators/{integratorId}:
    get:
      parameters:
      - example: fee-demo
        name: integratorId
        description: Id of the integrator that requests fee balances
        schema:
          type: string
        in: path
        required: true
      - name: x-lifi-api-key
        description: Authentication header, register in the LI.FI Partner Portal (https://portal.li.fi/ ) to get your API Key.
        schema:
          type: string
        in: header
      responses:
        '200':
          $ref: '#/components/responses/IntegratorResponse'
        '404':
          $ref: '#/components/responses/InvalidIntegratorRequest'
      summary: Get integrator's collected fees data for all supported chains
      description: 'This endpoint can be used to request all integrator''s collected fees data by tokens for all supported chains.

        The endpoint returns an `Integrator` object which contains the integrator id and an array of fee balances for all supported chains.'
      tags:
      - Integrators
  /v1/integrators/{integratorId}/withdraw/{chainId}:
    get:
      parameters:
      - example: fee-demo
        name: integratorId
        description: Id of the integrator that requests fee withdrawal
        schema:
          type: string
        in: path
        required: true
      - example: 137
        name: chainId
        description: Specify chainId from which funds should be withdrawn
        schema:
          type: string
        in: path
        required: true
      - example:
        - '0x0000000000000000000000000000000000000000'
        name: tokenAddresses
        description: Specify tokens from which funds should be withdraw
        schema:
          type: array
          items:
            type: string
        in: query
        required: false
      - name: x-lifi-api-key
        description: Authentication header, register in the LI.FI Partner Portal (https://portal.li.fi/ ) to get your API Key.
        schema:
          type: string
        in: header
      responses:
        '200':
          $ref: '#/components/responses/IntegratorWithdrawalTransactionResponse'
        '400':
          $ref: '#/components/responses/InvalidIntegratorWithdrawalRequest'
        '404':
          $ref: '#/components/responses/InvalidIntegratorRequest'
      summary: Get transaction request for withdrawing collected integrator's fees by chain
      description: 'This endpoint can be used to get transaction request for withdrawing integrator''s collected fees the specified chain. If a list of token addresses is provided, the generated transaction will only withdraw the specified funds.

        If there is no collected fees for the provided token''s addresses, the `400` error will be thrown.

        The endpoint returns a `IntegratorWithdrawalTransactionResponse` object which contains the transaction request.'
      tags:
      - Integrators
components:
  schemas:
    IntegratorWithdrawalResponse:
      title: Root Type for IntegratorWithdrawalResponse
      description: Transaction request for withdrawing integrator's collected fees for the specified chain
      required:
      - transactionRequest
      type: object
      properties:
        transactionRequest:
          description: The transaction request
          type: object
          properties:
            data:
              description: The transaction's data
              type: string
            to:
              description: The FeeCollector's contract address for the specified chain
              type: string
    IntegratorResponse:
      title: Root Type for IntegratorResponse
      description: Integrator's fee balance by chain
      required:
      - integratorId
      type: object
      properties:
        integratorId:
          description: The integrator's name or wallet address
          type: string
        feeBalances:
          description: The fee balances of the integrator
          type: array
          items:
            $ref: '#/components/schemas/FeeBalances'
      example:
        integratorId: fee-demo
        feeBalances:
        - chainId: 137
          tokenBalances:
          - token:
              address: '0x0000000000000000000000000000000000000000'
              symbol: MATIC
              decimals: 18
              chainId: 137
              name: MATIC
              coinKey: MATIC
              priceUSD: '0.742896'
              logoURI: https://static.debank.com/image/matic_token/logo_url/matic/6f5a6b6f0732a7a235131bd7804d357c.png
            amount: 0
            amountUsd: 0
    FeeBalances:
      type: object
      properties:
        chainId:
          description: The id of the chain
          type: number
          example: 137
        tokenBalances:
          type: array
          items:
            $ref: '#/components/schemas/TokenBalances'
    Token:
      title: Root Type for Token
      description: Representation of a Token
      required:
      - address
      - chainId
      - decimals
      - name
      - symbol
      type: object
      properties:
        address:
          description: Address of the token
          type: string
        decimals:
          format: number
          description: Number of decimals the token uses
          type: number
        symbol:
          description: Symbol of the token
          type: string
        chainId:
          format: number
          description: Id of the token's chain
          type: number
        coinKey:
          description: Identifier for the token
          type: string
        name:
          description: Name of the token
          type: string
        logoURI:
          description: Logo of the token
          type: string
        priceUSD:
          description: Token price in USD
          type: string
      example:
        address: '0x8f3cf7ad23cd3cadbd9735aff958023239c6a063'
        symbol: DAI
        decimals: 18
        chainId: 137
        name: (PoS) Dai Stablecoin
        coinKey: DAI
        priceUSD: '1'
        logoURI: https://static.debank.com/image/matic_token/logo_url/0x8f3cf7ad23cd3cadbd9735aff958023239c6a063/549c4205dbb199f1b8b03af783f35e71.png
    TokenBalances:
      type: object
      properties:
        token:
          $ref: '#/components/schemas/Token'
          type: object
        amount:
          description: Fee amount in tokens
          type: string
          example: '0'
        amountUsd:
          description: Fee amount in USD
          type: string
          example: '0'
  responses:
    InvalidIntegratorWithdrawalRequest:
      description: None of the requested tokens has a balance
    InvalidIntegratorRequest:
      description: Integrator with the name ${integratorId} is not found
    IntegratorWithdrawalTransactionResponse:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/IntegratorWithdrawalResponse'
          examples:
            ExampleIntegratorResponse:
              value:
                transactionRequest:
                  data: 0x
                  to: '0xbD6C7B0d2f68c2b7805d88388319cfB6EcB50eA9'
      description: Response of the integrator's fee withdrawal transaction request
    IntegratorResponse:
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/IntegratorResponse'
          examples:
            ExampleIntegratorResponse:
              value:
                integratorId: fee-demo
                feeBalances:
                - chainId: 137
                  tokenBalances:
                  - token:
                      address: '0x0000000000000000000000000000000000000000'
                      symbol: MATIC
                      decimals: 18
                      chainId: 137
                      name: MATIC
                      coinKey: MATIC
                      priceUSD: '0.742896'
                      logoURI: https://static.debank.com/image/matic_token/logo_url/matic/6f5a6b6f0732a7a235131bd7804d357c.png
                    amount: 0
                    amountUsd: 0
      description: Response of the Integrator request