Tradable Pairs

List the corridors the router currently quotes, as a mapping of chain slugs to chain IDs. Production keys see the live roster; tfk_test_ keys additionally expose the sandbox networks.

GET /pairs

Tradable Pairs

cURL

curl --request GET \
  --url https://api.tetrafi.io/api/v1/pairs \
  --header 'X-API-Key: <api-key>'

200

{
  "pairs": [
    {
      "input": {
        "chainId": 10,
        "address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
        "symbol": "USDC",
        "decimals": 6
      },
      "output": {
        "chainId": 8453,
        "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "symbol": "USDC",
        "decimals": 6
      },
      "corridor": "optimism-base"
    },
    {
      "input": {
        "chainId": 8453,
        "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "symbol": "USDC",
        "decimals": 6
      },
      "output": {
        "chainId": 10,
        "address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
        "symbol": "USDC",
        "decimals": 6
      },
      "corridor": "base-optimism"
    }
  ]
}

OpenAPI

/specs/router-api.json get /pairs

openapi: 3.1.0
info:
  title: TetraFi Router API
  version: '1'
  description: >-
    Multi-source routing over every eligible execution source. One intent fans out across
    direct DEX liquidity, the RFQ venue, bridges, issuers, and fiat rails, and comes back
    as ranked executable candidates - each stating its own guarantees.
servers:
  - url: https://api.tetrafi.io/api/v1/router
    description: >-
      Router namespace base URL. The chain is no longer part of the URL - every asset in an
      intent names its network via chainId. The same host serves the sandbox: authenticate
      with a tfk_test_ key to route against test corridors, tfk_live_ for production.
security:
  - apiKeyAuth: []
paths:
  /pairs:
    get:
      summary: Tradable Pairs
      operationId: getPairs
      description: >-
        Lists the corridors the router currently quotes, expressed over the production chain
        roster: ethereum (1), optimism (10), base (8453), and arc (5042). Authenticating with
        a tfk_test_ key exposes the sandbox roster as well - arc-testnet (5042002), solana-devnet
        (1399811151), tron-shasta, and adi-testnet (99999). Pair availability within the roster
        follows each venue's listed assets.
      servers:
        - url: https://api.tetrafi.io/api/v1/router
      responses:
        '200':
          description: Mapping of chain slugs to chain IDs across which tradable pairs are
            quoted
          content:
            application/json:
              schema:
                type: object
                additionalProperties:
                  type: integer
                description: Chain slug mapped to chain ID for every network with at least
                  one tradable pair.
              example:
                ethereum: 1
                optimism: 10
                base: 8453
                arc: 5042
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: Service-account API key (tfk_test_/tfk_live_).

Authorizations

X-API-Key · string · header · required

Service-account API key (tfk_test_/tfk_live_).

Query Parameters

activeOnly · boolean · default: true

Keep only pairs with at least one counterparty pricing right now (status active).

chainId · integer | null

Restrict to pairs whose input or output sits on this chain, e.g. 10 or 8453.

corridor · string | null

Restrict to one directional corridor slug, e.g. optimism-base.

Response

200

application/json

Successful Response

pairs · Pair · object[] · required

Every directional pair at least one workspace-eligible solver/LP currently quotes.

Show child attributes

asOf · string<date-time> | null

When this roster snapshot was computed. Coverage moves with LP inventory and listings - refresh at least daily rather than pinning it.

totalPairs · integer | null

Number of pair entries returned.