Get catalog

GET /v1/catalog The deployment’s declared corridor registry — build pickers from it rather than from a hand-kept table. Open to your project id, so a page’s pickers render before your user signs in to anything. Built once at boot from configuration; it changes only on restart. The external aggregator lanes are not listed (quoting is their discovery).

Item	Value
Route key	`infinityCatalog`
Credential	API key or project id

Request

No path, query or body parameters.

Response

data (Catalog): {chains[], assets[]} — both always arrays. chains[], sorted by domain:

Field	Type	Meaning
`chainDomain`	string	e.g. `eip155-8888`
`family`	string	`evm`, `solana`, `sui` or `aptos` — the signing family, which decides the whole rail
`userProxy`	string	the chain’s UserProxy (the wrap-native / swap-token contract); absent when none
`swapRouter`	string	present means the chain accepts an undeclared token as a source through the token-in lane
`nativeKey`	string	present means the chain’s native coin can be a source under this asset key (wrapped by the deployment). Absent means the native coin is a destination only
`wrappedKey`	string	the wrapped token the escrow actually holds on the native-coin lane — and what a refund returns. Absent when the chain declares no native-coin lane
`inputSettlers[]`	string[]	the chain’s input settlers (escrows), canonical form — the `settler` of `GET /onchain/{id}/order` is one of them. Absent when the chain declares none

assets[], sorted by chain then key:

Field	Type	Meaning
`chainDomain`	string	the asset’s chain
`assetKey`	string	the wire key `sourceAsset`/`destAsset` accept — the lowercase symbol
`assetRef`	string	the same asset as `<chainDomain>:<canonical address>` — accepted wherever `assetKey` is
`symbol`	string	display symbol
`address`	string	canonical form: lowercase `0x` hex, 40 characters on EVM, 64 on Solana/Sui/Aptos
`decimals`	integer
`native`	boolean	the chain’s native coin (the all-zero address): it receives fills and cannot fund an escrow directly — offer it as a destination, or as a source only where the chain has a `nativeKey`

Behavior

Open to a project id — a page’s pickers render before your user signs in to anything. Built once at boot from configuration; it changes only on restart. The external aggregator lanes are not listed (quoting is their discovery mechanism).

Errors

The handler itself never fails, so this route answers no EIN code, not even EIN0049. The gateway’s own refusals — a refused credential or origin, a rate limit, the hub unreachable or too slow — can come back, with an EPX code and a real HTTP status (Errors — gateway codes).

Example

curl -sS https://proxy-api.infinimesh.net/v1/catalog \
  -H "x-api-key: $HUB_API_KEY"

Response

Illustrative values; formats follow the Response table.

{
  "success": true,
  "request_id": "6f7a8b9c-0d1e-4f6a-bb4c-5d6e7f8a9b0c",
  "data": {
    "chains": [
      {
        "chainDomain": "eip155-1",
        "family": "evm",
        "userProxy": "0xb8e661486bd859fb5656c07c459c3617f6853b85",
        "swapRouter": "0x7a250d5630b4cf539739df2c5dacb4c659f2488d",
        "nativeKey": "eth",
        "wrappedKey": "weth",
        "inputSettlers": ["0xf439808b5a80e3c355645b62310502817000cd1d"]
      },
      {
        "chainDomain": "eip155-56",
        "family": "evm",
        "inputSettlers": ["0xf439808b5a80e3c355645b62310502817000cd1d"]
      }
    ],
    "assets": [
      {
        "chainDomain": "eip155-1",
        "assetKey": "eth",
        "assetRef": "eip155-1:0x0000000000000000000000000000000000000000",
        "symbol": "ETH",
        "address": "0x0000000000000000000000000000000000000000",
        "decimals": 18,
        "native": true
      },
      {
        "chainDomain": "eip155-1",
        "assetKey": "weth",
        "assetRef": "eip155-1:0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "symbol": "WETH",
        "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
        "decimals": 18,
        "native": false
      },
      {
        "chainDomain": "eip155-56",
        "assetKey": "wbnb",
        "assetRef": "eip155-56:0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c",
        "symbol": "WBNB",
        "address": "0xbb4cdb9cbd36b01bd1cbaebf2de08d9173bc095c",
        "decimals": 18,
        "native": false
      }
    ]
  }
}

eip155-56 omits userProxy/swapRouter/nativeKey/wrappedKey (none declared, omitempty); the eth row is the chain-native zero-address declaration, flagged illustrative.

The values above are illustrative fixtures. Read the live set from your deployment; how to read the rows is on Supported chains and assets.

// client: your InteropClient (see /infinity-interop/sdk/installation)
const catalog = await client.getCatalog(); // cached for 5 minutes
const { chains, assets } = catalog;

Get started

Core concepts

Resources

API reference

SDK

SDK reference

Request

Response

Behavior

Errors

Example

Response

See also

​Request

​Response

​Behavior

​Errors

​Example

​Response

​See also

Request

Response

Behavior

Errors

Example

Response

See also