Quote API

We highly recommend using Mayan SDK for integration as it simplifies the integration process. Before performing a swap, request a quote for the token pair. The response returns the available routes and the rate for each.

API Reference

Swagger UI

Example:

The request to get the quote for swapping 100 USDC on Avalanche to receive SOL on Solana would be like this:

Request:

curl -X 'GET' 'https://price-api.mayan.finance/v3/quote?amountIn=100&fromToken=0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e&fromChain=avalanche&toToken=0x0000000000000000000000000000000000000000&toChain=solana&slippageBps=300&gasDrop=0&swift=true&mctp=true&fastMctp=true&wormhole=true&solanaProgram=FC4eXxkyrMPTjiYUpp4EAnkmwMbQyZ6NDCh1kfLn6vsf&forwarderAddress=0x337685fdaB40D39bd02028545a4FfA7D287cC3E2&sdkVersion=13_1_0'

List of request parameters:

Parameter	Type	Required	Description
amountIn	Number	Yes*	Input amount in human-readable format (e.g. `100` for 100 USDC). Either `amountIn` or `amountIn64` must be provided.
amountIn64	String	Yes*	Input amount in base units (smallest denomination, e.g. `100000000` for 100 USDC). Either `amountIn` or `amountIn64` must be provided.
fromToken	String	Yes	Token address on the source chain (use `0x0000000000000000000000000000000000000000` for native tokens)
fromChain	String	Yes	Source chain name (e.g. `solana`, `ethereum`, `bsc`, `avalanche`, `arbitrum`, `base`, `optimism`, `polygon`, `sui`)
toToken	String	Yes	Token address on the destination chain
toChain	String	Yes	Destination chain name
slippageBps	Number	Yes*	Maximum slippage in basis points (e.g. `300` = 3%, max `500`). Either `slippageBps` or `slippage` must be provided.
slippage	Number	Yes*	Maximum slippage as a decimal (e.g. `0.03` = 3%). Either `slippageBps` or `slippage` must be provided.
swift	Boolean	No	Enable Swift routes
mctp	Boolean	No	Enable MCTP routes
fastMctp	Boolean	No	Enable Fast MCTP routes
wormhole	Boolean	No	Enable Wormhole Swap routes
gasless	Boolean	No	Enable gasless swap mode
solanaProgram	String	No	Mayan Solana program address
forwarderAddress	String	No	Mayan Forwarder contract address
sdkVersion	String	No	SDK version in `major_minor_patch` format (e.g. `13_1_0`)
referrer	String	No	Referrer Solana address that receives the referrer fee
referrerBps	Number	No	Default is 0. The basis points the integrator earns through the referral program
gasDrop	Number	No	Default is 0. Amount of native gas to deliver to the user on the destination chain
fullList	Boolean	No	Default is `false`. Enables returning all available quote options instead of the default limited (fastest and best-return) results
destinationAddress	String	No	Helps provide a more accurate quote, for example by checking whether the Solana ATA exists.
apiKey	String	No	Defines an API key that prevents the rate-limit-exceeded error on a per-IP basis.
mpsDeposit	Boolean	No	Default is `false`. When `true`, attaches a deposit address (`mpsDepositAddress`) to each eligible quote so a payer can fund the swap with a plain transfer instead of signing a transaction. Requires `destinationAddress`. See deposit address.
mpsUserId	String	No	Integrator-scoped identity that keys the deposit address: a `0x`-prefixed hex string whose value fits in 20 bytes. Only used when `mpsDeposit` is `true`; when omitted it is derived from your `apiKey`.

Response:

The quote service returns an array of quotes. By default, it includes at most two items: the first is the fastest option, and the second is the best-return quote. If the fastest option also provides the best return, only one quote is returned. It is possible to set the fullList request parameter to true to retrieve all available quote options. In this case, more than two items may be returned, and no sorting is applied. Interfaces can apply their own sorting logic by considering the etaSeconds and expectedAmountOut fields in each item.

{
  "quotes": [
    {
      "meta": {
        "advertisedDescription": "Cheapest and Fastest",
        "advertisedTitle": "Best",
        "icon": "https://cdn.mayan.finance/fast_icon.png",
        "switchText": "Switch to the best route",
        "title": "Best"
      },
      "sendTransactionCost": 0,
      "gasless": false,
      "slippageBps": 300,
      "effectiveAmountIn": 100,
      "effectiveAmountIn64": "100000000",
      "expectedAmountOut": 1.201839546,
      "price": 0.01201963167985677,
      "minAmountOut": 1.16578436,
      "minReceived": 1.16578436,
      "solanaRelayerFee": null,
      "solanaRelayerFee64": null,
      "redeemRelayerFee": null,
      "redeemRelayerFee64": null,
      "refundRelayerFee": null,
      "refundRelayerFee64": "711",
      "cancelRelayerFee64": "9147",
      "submitRelayerFee64": "0",
      "clientRelayerFeeSuccess": null,
      "clientRelayerFeeRefund": 0.00902389942474755,
      "deadline64": "1774621897",
      "fromToken": {
        "name": "USD Coin",
        "symbol": "USDC",
        "mint": "FHfba3ov5P3RjaiLVgh8FTv4oirxQDoVXuoUUDvHuXax",
        "contract": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e",
        "chainId": 43114,
        "wChainId": 6,
        "decimals": 6,
        "logoURI": "https://assets.coingecko.com/coins/images/6319/small/USD_Coin_icon.png?1547042389",
        "coingeckoId": "usd-coin",
        "realOriginContractAddress": "0xb97ef9ef8734c71904d8002f8b6bc66dd9c48a6e",
        "realOriginChainId": 6,
        "supportsPermit": true
      },
      "fromChain": "avalanche",
      "toToken": {
        "name": "SOL",
        "symbol": "SOL",
        "mint": "So11111111111111111111111111111111111111112",
        "contract": "0x0000000000000000000000000000000000000000",
        "chainId": 0,
        "wChainId": 1,
        "decimals": 9,
        "logoURI": "https://statics.mayan.finance/SOL.png",
        "wrappedAddress": "So11111111111111111111111111111111111111112",
        "coingeckoId": "solana",
        "realOriginContractAddress": "So11111111111111111111111111111111111111112",
        "realOriginChainId": 1,
        "supportsPermit": false
      },
      "toChain": "solana",
      "gasDrop": 0,
      "eta": 1,
      "etaSeconds": 3,
      "clientEta": "3s",
      "bridgeFee": 0,
      "suggestedPriorityFee": 0,
      "type": "SWIFT",
      "priceStat": {
        "ratio": 0.9996,
        "status": "GOOD"
      },
      "referrerBps": 0,
      "protocolBps": 3,
      "onlyBridging": false,
      "minMiddleAmount": 100,
      "sourceSwapExpense": 0,
      "swiftVersion": "V2",
      "swiftMayanContract": "0x40fFE85A28DC9993541449464d7529a922142960",
      "swiftAuctionMode": 2
    }
  ],
  "minimumSdkVersion": [
    7,
    0,
    0
  ]
}

Response fields:

The following table shows the common fields of response:

Field	Type	Description
type	String	Determines the bridge method which can be “WH”, “SWIFT”, “MCTP” or “FAST_MCTP”
effectiveAmountIn	Number	The actual input amount that will be deducted from user’s wallet
expectedAmountOut	Number	Expected output amount that user receives
minAmountOut	Number	Minimum output amount
minReceived	Number	The minimum amount that user receives after deducting relayer fees
price	Number	The amount of output token that user receives per 1 unit of input token
solanaRelayerFee	Number	For “WH” type this fee is denominated in input token. For “MCTP” type the fee is denominated in USDC. For “SWIFT” type the fee is zero.
redeemRelayerFee	Number	For “WH” type this fee is denominated in output token. For “MCTP” type the fee is denominated in USDC. For “SWIFT” type the fee is zero.
swapRelayerFee	Number	For “WH” type this fee is denominated in input token. On deposit-address quotes (`mpsDepositAddress` set) it is Mayan’s settlement cost already deducted from the deposit, in input token; `swapRelayerFee64` gives it in base units.
RefundRelayerFee	Number	For “WH” and “SWIFT” types this fee is denominated in input token. For “MCTP” type the fee is denominated in USDC.
clientRelayerFeeSuccess	Number	Total dollar value of relayer fees in the success scenario. On deposit-address quotes it includes Mayan’s settlement cost.
clientRelayerFeeRefund	Number	Total dollar value of relayer fee in the refund scenario
eta	Number	estimated time of arrival in minutes
client eta	String	human readable string of eta
fromToken	Object	Input token details
fromChain	String	Source network name
toToken	Object	Output token details
toChain	String	Destination network name
mpsDepositAddress	String	Returned when `mpsDeposit` was requested and the quote is eligible: a deterministic deposit address on the source chain (absent otherwise). Sending the input token to it settles the swap via deposit addresses, no signature required. See deposit address. When set, the quote’s amounts are net of Mayan’s settlement cost.
mpsIntegratorId	String	The integrator the deposit address was minted under, keyed to your API key. Only present with `mpsDepositAddress`.
mpsUserId	String	Echoes the integrator-scoped `mpsUserId` used to derive the address (the value you sent, or the one derived from your API key). Only present with `mpsDepositAddress`.
swiftAuctionMode	Number	Swift quotes only. Settlement mode of the order (see note below).

Settlement modes (Swift quotes only, type = "SWIFT")

2: The user receives at least minAmountOut, typically around expectedAmountOut and possibly higher or lower.
3: Exact-out. The user is guaranteed to receive exactly expectedAmountOut.

Deposit address (`mpsDeposit`)

Pass mpsDeposit: true to make a quote fundable by a plain transfer. On eligible quotes the response carries an mpsDepositAddress, a deterministic address on the source chain, plus mpsIntegratorId and mpsUserId. When the payer simply sends the input token to that address, Mayan detects the deposit and settles the swap to destinationAddress on the destination chain, with no transaction to sign and no SDK swap call. This is the recommended way to obtain a deposit address. The quote endpoint derives it for you inline, so there is no separate address-generation call to make. Set destinationAddress on the request, because the address is derived from the final recipient. Without it, the response has no mpsDepositAddress. Pass your apiKey as well. The address is created under the integrator linked to your key, and only that key can track it through the deposit address API. A quote sent without a key creates the address under Mayan’s shared default integrator instead. The address is deterministic. It is derived from your API key, mpsUserId, the destination chain, destinationAddress and the destination token, so the same values always return the same address and changing any of them returns a different one. mpsUserId is optional. It is an integrator-scoped identity, given as a 0x-prefixed hex string whose value fits in 20 bytes (for example 0x1). When you omit it, Mayan derives one from your API key, and the value used is echoed back in mpsUserId. A deposit address is offered only on Swift (V2) and mono-chain quotes, and only when the source chain and token are indexed for deposit addresses (see supported tokens) and the amount clears the token’s minimum. When an address is offered, the response contains only those quotes, and they all carry the same address. If neither route serves the pair, the request returns ROUTE_NOT_FOUND. If an address can’t be offered for another reason, for example because the amount is below the minimum or the cost can’t be priced, the quotes come back as usual, without an mpsDepositAddress and with nothing deducted. A missing address is not an error. Deposit-address quotes are priced on the deposit minus Mayan’s settlement cost. This cost covers gas for the swap and, on the first deposit on each chain, the deployment of the wallet. effectiveAmountIn64 remains the full amount the payer sends. swapRelayerFee64 (in source-token base units) and swapRelayerFee show the deducted cost, and clientRelayerFeeSuccess includes it in USD. expectedAmountOut and minReceived describe what the recipient gets. The cost is estimated at quote time, and the amount charged at settlement follows the gas price at that moment. On a first native SOL deposit, the cost also includes the rent-exempt reserve that stays in the deposit address. A quote that carries mpsDepositAddress is meant to be paid by a transfer to that address. To swap directly, request the quote without mpsDeposit. The referrer and referrerBps (or referrers) sent with the quote are saved on the deposit address and apply to every deposit settled from it, up to 200 bps. Each new quote replaces them, so send the same referrer every time, because a quote without one removes it. Use a referrer address of the same type as the deposit address, which means a 0x… address for EVM sources and a Solana address for Solana.

The Mayan SDK (v15.2.2+) exposes this as fetchQuote options mpsDeposit and mpsUserId, and reads it back as quote.mpsDepositAddress. If you call the API directly, send sdkVersion 15_2_2 or later, or no address is returned.

Track a deposit made to an mpsDepositAddress through detection, settlement, and delivery with the events stream or by polling GET /swaps.

Supported Tokens

Mayan is an intent-based protocol and supports any token as input or output, provided there is sufficient liquidity on the source or destination chains. We also maintain an approved, whitelisted token list for convenience:

Swagger UI

Example:

curl -X 'GET' \
  'https://price-api.mayan.finance/v3/tokens?chain=solana' \
  -H 'accept: application/json'

To get the aggregated list of tokens from all chains remove chain from the query.

Supported Chains

`GET` `sia.mayan.finance/v10/init`

Returns configuration for every supported chain, including whether it can be used as an origin or destination chain.

Example:

curl -X 'GET' \
  'https://sia.mayan.finance/v10/init' \
  -H 'accept: application/json'

This endpoint provides a JSON response containing a comprehensive list of all chains supported by the platform. Each chain entry includes detailed metadata such as the chain’s name, chain ID, and other relevant attributes. Two key fields indicate the chain’s functionality within the platform:

originActive: Specifies whether the chain is supported as a source chain.
destinationActive: Specifies whether the chain is supported as a destination chain.

Use this endpoint to determine compatibility and availability of specific chains for your operations.

API Key:

The apiKey parameter is optional. If you are using the Mayan SDK on a frontend and your request volume is low or comes from multiple origins, you can omit the apiKey to use the public endpoint. We recommend starting without an API key and only requesting one if you hit rate limits. To obtain an API key, email support@mayan.finance.

GET STARTED

USE CASES

SOLUTIONS

HOW MAYAN WORKS

FEATURES

INTEGRATION

RESOURCES

AI AGENTS

Quote API

API Reference

Swagger UI

Example:

Request:

List of request parameters:

Response:

Response fields:

Deposit address (`mpsDeposit`)

Supported Tokens

Swagger UI

Example:

Supported Chains

`GET` `sia.mayan.finance/v10/init`

Example:

API Key:

​API Reference

Swagger UI

​Example:

​Request:

​List of request parameters:

​Response:

​Response fields:

​Deposit address (mpsDeposit)

​Supported Tokens

Swagger UI

​Example:

​Supported Chains

​GET sia.mayan.finance/v10/init

​Example:

​API Key:

API Reference

Example:

Request:

List of request parameters:

Response:

Response fields:

Deposit address (`mpsDeposit`)

Supported Tokens

Example:

Supported Chains

`GET` `sia.mayan.finance/v10/init`

Example:

API Key: