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:
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, andinputToken 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.
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 a400 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.