GET /chains and /tokens

These optional discovery endpoints return metadata for the chains and tokens Trustware discovers from its upstream liquidity providers. Use them to populate chain and token selectors in your UI rather than hardcoding assets. They are not required for the core integration flow. Discovery coverage is broader than confirmed routing support. See the caveat under /chains below, and confirm a destination with a quote call before relying on it.

GET /chains

GET https://api.trustware.io/api/v1/routes/chains Returns metadata for every chain discovered from upstream providers, including chain ID, name, type, native currency, RPC URL, block explorer URLs, and the providers available for that chain.

This list reflects raw upstream liquidity coverage. It is not a guarantee that every entry is routable as a destination. The Cosmos family is the widest gap: many Cosmos chains appear in this response, and Nibiru (cataclysm-1) is the Cosmos destination with end-to-end support. Treat the remaining Cosmos entries, and the sui-mainnet entry, as informational, and confirm a destination with a quote call before building against it.Sei has two identifiers, and only one of them appears here. Sei EVM is returned as chain ID 1329. Sei-Cosmos (pacific-1) is still recognized by token discovery and by the SDK’s address validation, but is currently absent from this endpoint, so use 1329 unless you have confirmed a pacific-1 route with a quote call.

Response

[
  {
    "axelarChainName": "Avalanche",
    "blockExplorerUrls": ["https://avascan.info/blockchain/c/"],
    "chainIconURI": "https://raw.githubusercontent.com/0xsquid/assets/main/images/webp128/chains/avalanche.webp",
    "chainId": "43114",
    "chainName": "Chain 43114",
    "chainType": "evm",
    "id": "43114",
    "nativeCurrency": {
      "decimals": 18,
      "name": "Avalanche",
      "symbol": "AVAX"
    },
    "networkName": "Avalanche",
    "providersSupported": ["squid", "lifi"],
    "rpc": "https://api.avax.network/ext/bc/C/rpc",
    "type": "evm"
  }
]

Chain object fields

Field	Description
`chainId`	Chain ID as a string. Numeric on EVM chains (`"8453"`); a named identifier on Cosmos chains (`"cataclysm-1"`). Use this value in `fromChain` and `toChain` fields.
`chainName`	Internal chain name.
`networkName`	Human-readable network name for display.
`chainType`	Chain type. Current values are `evm`, `cosmos`, `solana`, `bitcoin`, and `sui`. Distinct from the `category` field on balance rows, which uses `btc` for Bitcoin.
`type`	Alias for `chainType`.
`nativeCurrency`	Native token metadata: `name`, `symbol`, `decimals`.
`rpc`	Public RPC endpoint for this chain.
`blockExplorerUrls`	Array of block explorer URLs.
`chainIconURI`	Chain logo image URL.
`providersSupported`	Routing providers available for this chain.

GET /tokens

GET https://api.trustware.io/api/v1/routes/tokens Returns tokens supported by Trustware. Called with no query parameters, it returns the full unpaginated list. Passing any of the optional query parameters below switches the endpoint into paginated mode and the response shape changes accordingly.

Query parameters

Parameter	Required	Description
`chainId`	No	Restrict results to a single chain (e.g. `"8453"` for Base). Passing this also activates pagination.
`limit`	No	Page size when paginating. No fixed default. Omit to use the server-side page size.
`cursor`	No	Pagination cursor returned by a previous paginated response.
`q`	No	Free-text search across token symbol and name.
`includeTotal`	No	Set to `true` to include the total result count in the paginated response.

Pagination activates as soon as any of these query parameters is present. Call with no query string to receive the full token list in a single response.

Response

[
  {
    "address": "0x4acc81dc9c03e5329a2c19763a1d10ba9308339f",
    "chainId": "8453",
    "decimals": 18,
    "logoURI": "https://token-media.defined.fi/8453_0x4acc81dc9c03e5329a2c19763a1d10ba9308339f_large.png",
    "name": "Base Baboon",
    "symbol": "$BOON",
    "type": "evm",
    "usdPrice": 9.35818822286e-8
  }
]

Token object fields

Field	Description
`address`	Token identifier on this chain: the contract address on EVM chains, the mint address on Solana, or the native denom string on Cosmos. Use this in `fromToken` and `toToken`.
`chainId`	Chain this token belongs to.
`symbol`	Token ticker symbol.
`name`	Full token name.
`decimals`	Token decimal places.
`type`	Token type (e.g. `evm`).
`usdPrice`	Current USD price per token.
`logoURI`	Token logo image URL.

Getting Started

Endpoints

GET /chains and /tokens

GET /chains

Response

Chain object fields

GET /tokens

Query parameters

Response

Token object fields

​GET /chains

​Response

​Chain object fields

​GET /tokens

​Query parameters

​Response

​Token object fields

GET /chains

Response

Chain object fields

GET /tokens

Query parameters

Response

Token object fields