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

# Discovery

> The networks and pairs you can offer, so you hardcode none of them.

Two routes tell you what you can offer: which networks are served, and which ordered pairs a capital provider can fill, with every token they swap. Each response carries a `Cache-Control` header, so you can cache it for that long.

| Method | Path | Lists | `Cache-Control` |
| - | - | - | - |
| `GET` | `/v1/networks` | Every network the API knows | `public, max-age=300` |
| `GET` | `/v1/swap/pairs?network=&inputToken=` | The ordered pairs the network can swap | `public, max-age=60` |

Both are public reads in the anonymous read allowance of [Rate limits](https://docs.multiliquid.xyz/api-reference/guides/rate-limits.md).

## Networks

`GET /v1/networks` takes no parameters and returns `networks`, sorted by key. Each entry has `runtime`, which names its form:

| Field | Runtime | Description |
| - | - | - |
| `network` | Both | The [network key](https://docs.multiliquid.xyz/api-reference/guides/network-keys.md) every route takes |
| `chainId` | `evm` | The EVM chain ID |
| `cluster` | `svm` | The Solana cluster: `mainnet` (the cluster older tools call `mainnet-beta`) or `devnet` |
| `explorer` | Both | `url`, and the templates `transactionUrl` and `addressUrl`, in which `{transactionId}` stands for a transaction hash or signature and `{address}` for an address |
| `active` | Both | Whether the API currently serves the network |

```json theme={null}
{
  "networks": [
    {
      "runtime": "evm",
      "network": "evm-mainnet",
      "chainId": 1,
      "explorer": {
        "url": "https://etherscan.io",
        "transactionUrl": "https://etherscan.io/tx/{transactionId}",
        "addressUrl": "https://etherscan.io/address/{address}"
      },
      "active": true
    },
    {
      "runtime": "evm",
      "network": "evm-sepolia",
      "chainId": 11155111,
      "explorer": {
        "url": "https://sepolia.etherscan.io",
        "transactionUrl": "https://sepolia.etherscan.io/tx/{transactionId}",
        "addressUrl": "https://sepolia.etherscan.io/address/{address}"
      },
      "active": true
    },
    {
      "runtime": "svm",
      "network": "svm-devnet",
      "cluster": "devnet",
      "explorer": {
        "url": "https://solscan.io/?cluster=devnet",
        "transactionUrl": "https://solscan.io/tx/{transactionId}?cluster=devnet",
        "addressUrl": "https://solscan.io/account/{address}?cluster=devnet"
      },
      "active": true
    },
    {
      "runtime": "svm",
      "network": "svm-mainnet",
      "cluster": "mainnet",
      "explorer": {
        "url": "https://solscan.io",
        "transactionUrl": "https://solscan.io/tx/{transactionId}",
        "addressUrl": "https://solscan.io/account/{address}"
      },
      "active": true
    }
  ]
}
```

On a network with `active: false`, the quote, build, and pair routes and `POST /v1/submissions` answer `503` with code `NETWORK_NOT_ACTIVE`, and sending the request again cannot succeed. Its stored submissions can still be read and listed.

## Tokens

Tokens appear only inside pairs; there is no separate token list. A token appears only in the pairs a capital provider can fill, so a listed token that no capital provider swaps appears in none, and `inputToken` set to it returns an empty `pairs`. Each token object has:

| Field | Description |
| - | - |
| `address` | A `0x` address on EVM, a base58 mint on Solana. Every swap request names tokens by this address. |
| `symbol` | The token's symbol, such as `USTB` |
| `name` | The token's full name, or its symbol where Multiliquid records no name |
| `decimals` | The token's decimals: the most decimal places an amount of it has. Amounts are in whole tokens, which the API converts with these decimals. |
| `kind` | `stablecoin` or `rwa` |
| `issuer` | The token's issuer; `null` where Multiliquid records none |

Every token object has all six fields. Quotes, fees, and NAV entries carry the same token object, so you can display any of them without another lookup. A settlement's tokens have the same fields, but a token the network does not list has a `null` `symbol`, `name`, and `issuer` there; see [Settlement](https://docs.multiliquid.xyz/api-reference/swap/submissions.md#settlement).

Multiliquid records these issuers:

| Token | `issuer` |
| - | - |
| USDC | `Circle` |
| TSY | `Multiliquid` |
| USTB, USCC | `Superstate` |
| JTRSY, JAAA | `Janus Henderson` |
| ULTRA | `Delta Wellington / Libeara` |
| ACRED | `Apollo` |
| BENJI | `Franklin Templeton` |
| WTGXX | `WisdomTree` |
| VBILL | `VanEck` |
| AA\_FalconXUSDC | `FalconX` |
| ONYC | `OnRe` |
| EPIC | `R3` |

Each network lists its own subset, and the response for that network is authoritative. TSY, the Multiliquid Treasury token, has the symbol `TSY` and the kind `stablecoin`. Every token of the test networks records no issuer, so its `issuer` is `null`, except Sepolia's TSY, which records `Multiliquid`.

## Pairs

`GET /v1/swap/pairs?network=svm-mainnet` returns the `network` and its `pairs`. `inputToken` limits the list to the pairs that pay one token. Each pair has:

| Field | Description |
| - | - |
| `inputToken` | The token the user pays, as a token object |
| `outputToken` | The token the user receives |
| `swapTypes` | The amounts a request may fix: `exactIn` (`amountIn`) and `exactOut` (`amountOut`) |
| `capitalProviders` | The capital providers that can fill the pair, in the order a quote considers them, each with its `id`, its `name` (`null` when it has none), and its `address` |
| `batchCapitalProviders` | The capital providers that take [batch orders](https://docs.multiliquid.xyz/api-reference/swap/place-batch-order.md) for the pair, in the same form and order; empty when none do |

A pair that is absent is one you should not offer. A listed pair is one a capital provider is set up to fill:

* On EVM, the capital provider's stablecoin delegate can swap, the pair is one of its routes, and the delegate whitelists each side of the pair that is not its own stablecoin.
* On Solana, the capital provider has a pair of the two tokens, which it fills in both directions.

A quote or build considers exactly the capital providers the pair lists, in the same order, so a \$TSY-to-USDC swap goes only to the Treasury capital provider. A `capitalProvider` that the network does not list answers `UNKNOWN_CAPITAL_PROVIDER`; one the network lists but the pair does not answers `UNSUPPORTED_PAIR`, with `details.capitalProvider`. A listed pair can still fail to quote when its capital provider's state changes, and the quote's `NO_QUOTE` error names the reason for each capital provider. A capital provider's `id` is the value a quote's `capitalProvider` parameter and a batch order's `capitalProvider` field take: the stablecoin delegate ID on EVM, or the capital provider's wallet on Solana.

```bash theme={null}
curl "https://api.multiliquid.xyz/v1/swap/pairs?network=evm-mainnet&inputToken=0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
```

## Errors

A missing or unknown network, an invalid address, or an unknown query parameter is a `400` with code `INVALID_REQUEST`. An `inputToken` the network does not list is a `400` with code `UNSUPPORTED_TOKEN`, whose `details` give the `field`, `token`, and `network`. [Errors](https://docs.multiliquid.xyz/api-reference/guides/errors.md) lists every code.


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