> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trustware.io/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /chains and /tokens

> Discovery endpoints that list the chains and tokens Trustware discovers from upstream liquidity providers. Use these to populate selectors dynamically.

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](/api-reference/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.

<Note>
  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](/api-reference/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.
</Note>

### Response

```json theme={null}
[
  {
    "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. |

<Note>
  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.
</Note>

### Response

```json theme={null}
[
  {
    "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. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.