Skip to main content
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. Both are public reads in the anonymous read allowance of Rate limits.

Networks

GET /v1/networks takes no parameters and returns networks, sorted by key. Each entry has runtime, which names its form:
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: 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. Multiliquid records these issuers: 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: 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.

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 lists every code.