Tokens

Token catalog with search and filters (GET /v1/tokens)

List supported tokens

get

/v1/tokens

Token catalog from the coins cache, sorted by internal popularity (not exposed on the item).

Pagination: if neither limit nor offset is sent, the handler returns all matching tokens. The JSON still includes limit: 20 and offset: 0 in that case — those fields do not mean the list was sliced. If either limit or offset is sent, results are sliced (limit default 20, max 100).

• network — must equal GET /v1/chains → id (slug), case-insensitive. Aliases (ERC20, display names) are not accepted on this query. Unknown slug → empty list.

• engine — cex keeps tokens with engineSupport containing off-chain; dex keeps on-chain. There is no private filter.

• supportsFixedRate — boolean (true/1 / false/0).

• search — ranked match on ticker, name, contract address; extra terms can resolve a network alias inside the search string. Can be combined with network.

Query parameters

searchstringOptional

Search by ticker, name, contract address, or network alias inside the query string (e.g. usdt trc).

Example: USDC

networkstringOptional

Filter by canonical chain id (slug) — must match /v1/chains[].id exactly ignoring case (e.g. ETH, BTC). Aliases such as ERC20 or network names alone are not accepted here.

Example: ETH

supportsFixedRatebooleanOptional

Filter to tokens that support fixed-rate exchanges

Example: false

enginestring · enumOptional

Filter by supported swap engine:

• cex – off-chain CEX providers

• dex – on-chain DEX aggregators

Example: cexPossible values:

limitnumber · min: 1 · max: 100Optional

Page size (1–100). Applied only when limit or offset is present. If both are omitted, all matches are returned.

Example: 20

offsetnumberOptional

Pagination offset. Applied only when limit or offset is present.

Example: 0

Responses

200

Paginated token list

application/json

totalTokensnumberRequired

Number of token objects in this response page (matches tokens.length)

limitnumberRequired

Page size for this response

offsetnumberRequired

Pagination offset

totalnumberRequired

Total tokens matching filters before pagination

400

Invalid request parameters

application/json

500

Internal server error

application/json

get/v1/tokens

GET /v1/tokens HTTP/1.1
Host: api.yifi.io
Accept: */*

{
  "tokens": [
    {
      "uuid": "4f2e6d6b-6e15-4f47-8b6e-2a3d3c5b9d10",
      "network": "ETH",
      "ticker": "ETH",
      "name": "Ethereum",
      "supportsFixedRate": false,
      "contractAddress": null,
      "engineSupport": [
        "on-chain",
        "off-chain"
      ],
      "logoUrlCoin": "text",
      "regexAddress": "^0x[a-fA-F0-9]{40}$",
      "explorerAddressUrl": "text",
      "explorerTransactionUrl": "text",
      "decimals": {},
      "logoUrlsNetwork": {},
      "coingeckoCoinId": "ethereum",
      "currentPriceUsd": "2397.32"
    }
  ],
  "totalTokens": 1,
  "limit": 1,
  "offset": 1,
  "total": 1
}