Price a transfer

Prices one transfer and returns everything needed to execute it: destination.amount (expected) alongside destination.minAmount (the guaranteed floor), an itemised fee breakdown, expiresAt, and every action to sign or send. A quote is an offer, not a commitment. Complete the returned nextActions in order. Only when they end with submit_execution, POST the results to POST /v1/quotes/{orderId}/executions. A quote funded by an approval and an on-chain prefunded-store transaction has no submit_execution: that transaction starts the transfer, so there is nothing to POST.

Authorization

bearerAuth

AuthorizationBearer <token>

API key for authentication.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Which side carries the amount is determined by amountType. The oneOf below encodes that: exact_input (the default, and the only mode that may leave amountType off) requires origin.amount (or origin.minInputAmount, which excludes originAction); exact_output and min_output require destination.amount and must name amountType explicitly.

The body is strict: an unrecognised or removed field (for example fundingMethods) is rejected with 400 request.unsupported_param naming the field.

Spend a known input amount. amountType may be omitted -- this is the default.

origin*|

destination*

amountType?string

capabilities?

Optional. The operations your client can perform. The server derives the funding methods it can execute from these operations (intersected with authorizationPolicy), so you declare what your wallet can do instead of naming funding methods. Omit it when your client can perform every operation on the origin chain's ecosystem.

A trailing submit_execution action is appended to nextActions whenever the order must be POSTed to /v1/quotes/{orderId}/executions. A quote whose only result to report is the prefunded-store transaction has none: that store() completes the order on chain.

authorizationPolicy?

Which authorizations the client permits. Narrows the funding methods derived from capabilities.operations to those whose authorization type is allowed. A method is kept only if every authorization type it may request is in this list: permit2 needs both approval and permit2 (the Permit2 allowance is set with a token approval), and any funding method on a HyperCore origin additionally needs hypercore_action (the sendAsset signature that precedes the onward leg). Listing only a subset of a method's types excludes that method.

Omitting allowedTypes allows every type. Send at least one of allowedTypes / approvalAmount.

slippageBps?integer

Deprecated

Legacy slippage behavior. Cannot be combined with maxFee. Omit to use the USD value-loss limits.

maxFee?

Maximum USD value loss between expected input and minimum guaranteed output: expectedInputUsd - minimumOutputUsd <= maxFee.fixedUsd + expectedInputUsd * maxFee.bps / 10000. Includes app fees, swap impact and slippage reflected in the minimum output; excludes wallet-paid gas outside the quoted amounts. Each omitted component inherits the integrator setting, then the deployment default. Cannot be combined with slippageBps. Over the limit, the quote returns 400 policy.amount_out_of_range.

appFeeBps?integer

App fee in basis points of the transfer's input value, taken in the destination token: 10 on a 1,000 USDC transfer takes 1 USDC. Accepted only within your API key's app-fee entitlement; otherwise 400 request.invalid_field with param: "appFeeBps". Not available on same-chain swaps or target-priced lanes. Deducted from the output and reported as fee.appFee; with destinationActions, the steps receive the output after the fee. 0 is the same as omitting it.

gasTopUp?

Also deliver the destination chain's native gas token (ETH on Base, POL on Polygon, ...) to destination.recipient, so the recipient can pay for their next transaction. Echoed as gasTopUp on the quote. Walkthrough: Gas top-up.

The top-up is bought with the transfer, at the current native price. On exact_input it comes out of the output, so destination.grossAmount is already net of it. On exact_output and min_output it raises origin.amount instead. It is not a fee: it is not part of fee and does not count against maxFee or subsidy. App fees are still charged on the full input.

Call GET /v1/capabilities with the pair first. capabilities.gasTopUp.supported says whether the route can carry a top-up, and capabilities.gasTopUp.limits.max.amount is the most you can request right now.

Not available on same-chain swaps, on native-token outputs, or on Solana (coming soon), HyperCore, Lighter and Tron destinations. With destinationActions, the top-up is sent before the steps run, and onFailure.recipient must be destination.recipient.

Errors, all with param: "gasTopUp.amount":

400 request.unsupported_param: the route cannot carry a top-up.
400 policy.amount_out_of_range: above the destination chain's USD limit.
400 request.invalid_field: the transfer is too small to pay for the top-up.

attestation?

Opt in to an Across-signed EIP-712 attestation over the quote's terms, returned as attestation. verifier is your verifying contract (EVM origin) or program id (Solana origin) and is bound into the EIP-712 domain. destinationActions steps are signed too, and their onFailure.recipient must be destination.recipient. Not available with an originAction, with origin.minInputAmount, or with destinationActions on a Solana destination (400 request.unsupported_param). gasTopUp is not attested. 503 system.unavailable when signing is not configured.

subsidy?|

Request-level fixed subsidy ceilings. Accepted only where your API key's sponsorship policy allows it; otherwise 400 request.invalid_field with param: "subsidy". Applied amount = min(inputUsd × maxBps / 10000, maxAmountUsd), never above the policy ceiling, and only lowers a configured default. exact_input and min_output only. The response carries no subsidy object; the subsidy shows as a higher output.

expiresAtHint?string

Advisory; clamps quote expiry downward only.

externalId?string

metadata?

≤16 keys, ≤4096 bytes serialized; keys are non-empty and ≤64 chars, values ≤512 chars. Surfaces on the future Transfer.

originAction?||

One call to run on the origin chain before the bridge, picked by kind.

destinationActions?

Run contract calls on the destination chain with the bridged funds. For example: wrap USDC.e into pUSD on Polygon, or supply USDC to Aave on Base.

Example: bridge USDC from Arbitrum, then wrap it into pUSD on Polygon.

"destinationActions": {
  "steps": [
    {
      "kind": "approve",
      "token": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174",
      "spender": "0x93070a847efEf7F70739046A929D47a521F5B8ee",
      "populateDynamically": true
    },
    {
      "kind": "function-call",
      "target": "0x93070a847efEf7F70739046A929D47a521F5B8ee",
      "functionSignature": "wrap(address,address,uint256)",
      "args": [
        { "value": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174" },
        { "value": "0xYourWalletAddress" },
        { "populateDynamically": true, "balanceSourceToken": "0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174" }
      ]
    }
  ],
  "onFailure": { "action": "revert" }
}

Steps run in order, in the same transaction as the fill.

kind

approve: let spender pull token. Above, the pUSD wrapper gets approval for the USDC.e.
function-call: call target using functionSignature and args. Above, wrap(token, recipient, amount).
raw-call: call target with calldata you encoded yourself.
native-transfer: send the chain's native token to target, with value in wei.

populateDynamically: true: uses the amount that actually arrived instead of a fixed number. Set it on the approve, and on the amount argument together with balanceSourceToken.

onFailure.action

revert (default): if any step fails, the fill doesn't happen and the transfer is refunded.
deliver-output-token: if any step fails, the bridged token goes to onFailure.recipient instead.

Funds go wherever your steps send them, not to destination.recipient. That's why the wallet is passed as the wrap recipient above, and as onBehalfOf in the Aave example.

Response Body

`application/json`

curl -X POST "https://example.com/v1/quotes" \  -H "Content-Type: application/json" \  -d '{    "origin": {      "token": {        "chainId": 42161,        "address": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831"      },      "amount": "1000000",      "depositor": "0x1111111111111111111111111111111111111111"    },    "destination": {      "token": {        "chainId": 8453,        "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"      },      "recipient": "0x1111111111111111111111111111111111111111"    },    "amountType": "exact_input",    "authorizationPolicy": {      "allowedTypes": [        "approval",        "permit2"      ]    }  }'

{
  "expiresAt": "2026-10-15T23:44:04.020Z",
  "originValidUntil": "2026-10-15T23:59:05.000Z",
  "expectedFillTimeMs": 1252,
  "refundTo": [
    {
      "token": {
        "kind": "token",
        "chainId": 42161,
        "address": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
        "symbol": "USDC",
        "name": "USD Coin",
        "decimals": 6,
        "explorerUrl": "https://arbiscan.io/token/0xaf88d065e77c8cc2239327c5edb3a432268e5831",
        "chain": {
          "chainId": 42161,
          "name": "arbitrum-one",
          "displayName": "Arbitrum One",
          "namespace": "evm",
          "explorerUrl": "https://arbiscan.io",
          "logoUrl": "https://alexandria.across.to/assets/chains/arbitrum.svg",
          "nativeToken": {
            "symbol": "ETH",
            "decimals": 18
          },
          "publicRpcUrl": "https://arb1.arbitrum.io/rpc"
        }
      },
      "refundAddress": {
        "address": "0x1111111111111111111111111111111111111111",
        "chain": {
          "chainId": 42161,
          "name": "arbitrum-one",
          "displayName": "Arbitrum One",
          "namespace": "evm",
          "explorerUrl": "https://arbiscan.io",
          "logoUrl": "https://alexandria.across.to/assets/chains/arbitrum.svg",
          "nativeToken": {
            "symbol": "ETH",
            "decimals": 18
          },
          "publicRpcUrl": "https://arb1.arbitrum.io/rpc"
        }
      }
    }
  ],
  "origin": {
    "token": {
      "kind": "token",
      "chainId": 42161,
      "address": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",
      "symbol": "USDC",
      "name": "USD Coin",
      "decimals": 6,
      "explorerUrl": "https://arbiscan.io/token/0xaf88d065e77c8cc2239327c5edb3a432268e5831",
      "priceUsd": 0.999608,
      "priceUsdAt": "2026-10-15T23:28:01.141Z",
      "chain": {
        "chainId": 42161,
        "name": "arbitrum-one",
        "displayName": "Arbitrum One",
        "namespace": "evm",
        "explorerUrl": "https://arbiscan.io",
        "logoUrl": "https://alexandria.across.to/assets/chains/arbitrum.svg",
        "nativeToken": {
          "symbol": "ETH",
          "decimals": 18
        },
        "publicRpcUrl": "https://arb1.arbitrum.io/rpc"
      }
    },
    "amount": "1000000",
    "amountUsd": "0.999608000000000052",
    "maxAmount": "1000000",
    "maxAmountUsd": "0.999608000000000052",
    "depositor": {
      "address": "0x1111111111111111111111111111111111111111",
      "chain": {
        "chainId": 42161,
        "name": "arbitrum-one",
        "displayName": "Arbitrum One",
        "namespace": "evm",
        "explorerUrl": "https://arbiscan.io",
        "logoUrl": "https://alexandria.across.to/assets/chains/arbitrum.svg",
        "nativeToken": {
          "symbol": "ETH",
          "decimals": 18
        },
        "publicRpcUrl": "https://arb1.arbitrum.io/rpc"
      }
    }
  },
  "destination": {
    "token": {
      "kind": "token",
      "chainId": 8453,
      "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "symbol": "USDC",
      "name": "USD Coin",
      "decimals": 6,
      "explorerUrl": "https://basescan.org/token/0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "priceUsd": 0.999608,
      "priceUsdAt": "2026-10-15T23:28:01.141Z",
      "chain": {
        "chainId": 8453,
        "name": "base",
        "displayName": "Base",
        "namespace": "evm",
        "explorerUrl": "https://basescan.org",
        "logoUrl": "https://alexandria.across.to/assets/chains/base.svg",
        "nativeToken": {
          "symbol": "ETH",
          "decimals": 18
        },
        "publicRpcUrl": "https://mainnet.base.org"
      }
    },
    "grossAmount": "1000000",
    "amount": "979842",
    "amountUsd": "0.979457901936000019",
    "recipient": {
      "address": "0x1111111111111111111111111111111111111111",
      "chain": {
        "chainId": 8453,
        "name": "base",
        "displayName": "Base",
        "namespace": "evm",
        "explorerUrl": "https://basescan.org",
        "logoUrl": "https://alexandria.across.to/assets/chains/base.svg",
        "nativeToken": {
          "symbol": "ETH",
          "decimals": 18
        },
        "publicRpcUrl": "https://mainnet.base.org"
      }
    },
    "minAmount": "921185",
    "minAmountUsd": "0.920823895480000099"
  },
  "fee": {
    "totalFee": {
      "amount": "20158",
      "token": {
        "kind": "token",
        "chainId": 8453,
        "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
        "symbol": "USDC",
        "name": "USD Coin",
        "decimals": 6,
        "explorerUrl": "https://basescan.org/token/0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
        "priceUsd": 0.999608,
        "priceUsdAt": "2026-10-15T23:28:01.141Z",
        "chain": {
          "chainId": 8453,
          "name": "base",
          "displayName": "Base",
          "namespace": "evm",
          "explorerUrl": "https://basescan.org",
          "logoUrl": "https://alexandria.across.to/assets/chains/base.svg",
          "nativeToken": {
            "symbol": "ETH",
            "decimals": 18
          },
          "publicRpcUrl": "https://mainnet.base.org"
        }
      },
      "amountUsd": "0.020150098064000001"
    },
    "transferFee": {
      "amount": "20158",
      "token": {
        "kind": "token",
        "chainId": 8453,
        "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
        "symbol": "USDC",
        "name": "USD Coin",
        "decimals": 6,
        "explorerUrl": "https://basescan.org/token/0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
        "priceUsd": 0.999608,
        "priceUsdAt": "2026-10-15T23:28:01.141Z",
        "chain": {
          "chainId": 8453,
          "name": "base",
          "displayName": "Base",
          "namespace": "evm",
          "explorerUrl": "https://basescan.org",
          "logoUrl": "https://alexandria.across.to/assets/chains/base.svg",
          "nativeToken": {
            "symbol": "ETH",
            "decimals": 18
          },
          "publicRpcUrl": "https://mainnet.base.org"
        }
      },
      "amountUsd": "0.020150098064000001"
    },
    "appFee": {
      "amount": "0",
      "token": {
        "kind": "token",
        "chainId": 8453,
        "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
        "symbol": "USDC",
        "name": "USD Coin",
        "decimals": 6,
        "explorerUrl": "https://basescan.org/token/0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
        "priceUsd": 0.999608,
        "priceUsdAt": "2026-10-15T23:28:01.141Z",
        "chain": {
          "chainId": 8453,
          "name": "base",
          "displayName": "Base",
          "namespace": "evm",
          "explorerUrl": "https://basescan.org",
          "logoUrl": "https://alexandria.across.to/assets/chains/base.svg",
          "nativeToken": {
            "symbol": "ETH",
            "decimals": 18
          },
          "publicRpcUrl": "https://mainnet.base.org"
        }
      },
      "amountUsd": "0.000000000000000000"
    },
    "maxTransferFee": {
      "amount": "78815",
      "token": {
        "kind": "token",
        "chainId": 8453,
        "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
        "symbol": "USDC",
        "name": "USD Coin",
        "decimals": 6,
        "explorerUrl": "https://basescan.org/token/0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
        "priceUsd": 0.999608,
        "priceUsdAt": "2026-10-15T23:28:01.141Z",
        "chain": {
          "chainId": 8453,
          "name": "base",
          "displayName": "Base",
          "namespace": "evm",
          "explorerUrl": "https://basescan.org",
          "logoUrl": "https://alexandria.across.to/assets/chains/base.svg",
          "nativeToken": {
            "symbol": "ETH",
            "decimals": 18
          },
          "publicRpcUrl": "https://mainnet.base.org"
        }
      },
      "amountUsd": "0.078784104519999995"
    },
    "maxTotalFee": {
      "amount": "78815",
      "token": {
        "kind": "token",
        "chainId": 8453,
        "address": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
        "symbol": "USDC",
        "name": "USD Coin",
        "decimals": 6,
        "explorerUrl": "https://basescan.org/token/0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
        "priceUsd": 0.999608,
        "priceUsdAt": "2026-10-15T23:28:01.141Z",
        "chain": {
          "chainId": 8453,
          "name": "base",
          "displayName": "Base",
          "namespace": "evm",
          "explorerUrl": "https://basescan.org",
          "logoUrl": "https://alexandria.across.to/assets/chains/base.svg",
          "nativeToken": {
            "symbol": "ETH",
            "decimals": 18
          },
          "publicRpcUrl": "https://mainnet.base.org"
        }
      },
      "amountUsd": "0.078784104519999995"
    }
  },
  "gasEstimates": [
    {
      "leg": "origin",
      "effect": "included_in_transfer_fee",
      "amount": "6827047500000",
      "token": {
        "kind": "native",
        "chainId": 42161,
        "address": "0x0000000000000000000000000000000000000000",
        "symbol": "ETH",
        "name": "ETH",
        "decimals": 18,
        "chain": {
          "chainId": 42161,
          "name": "arbitrum-one",
          "displayName": "Arbitrum One",
          "namespace": "evm",
          "explorerUrl": "https://arbiscan.io",
          "logoUrl": "https://alexandria.across.to/assets/chains/arbitrum.svg",
          "nativeToken": {
            "symbol": "ETH",
            "decimals": 18
          },
          "publicRpcUrl": "https://arb1.arbitrum.io/rpc"
        }
      },
      "amountUsd": "0.016644089460000001",
      "gasUnits": "325000"
    },
    {
      "leg": "destination",
      "effect": "included_in_transfer_fee",
      "amount": "1397522801495",
      "token": {
        "kind": "native",
        "chainId": 8453,
        "address": "0x0000000000000000000000000000000000000000",
        "symbol": "ETH",
        "name": "ETH",
        "decimals": 18,
        "chain": {
          "chainId": 8453,
          "name": "base",
          "displayName": "Base",
          "namespace": "evm",
          "explorerUrl": "https://basescan.org",
          "logoUrl": "https://alexandria.across.to/assets/chains/base.svg",
          "nativeToken": {
            "symbol": "ETH",
            "decimals": 18
          },
          "publicRpcUrl": "https://mainnet.base.org"
        }
      },
      "amountUsd": "0.003405858060000000",
      "gasUnits": "221560"
    }
  ],
  "nextActions": [
    {
      "kind": "sign_typed_data",
      "id": "funding",
      "chainId": 42161,
      "typedData": {
        "types": {
          "EIP712Domain": [
            {
              "name": "name",
              "type": "string"
            },
            {
              "name": "version",
              "type": "string"
            },
            {
              "name": "chainId",
              "type": "uint256"
            },
            {
              "name": "verifyingContract",
              "type": "address"
            }
          ],
          "ReceiveWithAuthorization": [
            {
              "name": "from",
              "type": "address"
            },
            {
              "name": "to",
              "type": "address"
            },
            {
              "name": "value",
              "type": "uint256"
            },
            {
              "name": "validAfter",
              "type": "uint256"
            },
            {
              "name": "validBefore",
              "type": "uint256"
            },
            {
              "name": "nonce",
              "type": "bytes32"
            }
          ]
        },
        "primaryType": "ReceiveWithAuthorization",
        "domain": {
          "name": "USD Coin",
          "version": "2",
          "chainId": 42161,
          "verifyingContract": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831"
        },
        "message": {
          "from": "0x1111111111111111111111111111111111111111",
          "to": "0x998d7c178A1F9607b47eA3A8e22426451b3ce707",
          "value": "1000000",
          "validAfter": "0",
          "validBefore": "1792108745",
          "nonce": "0x7a961202c77345e711eb85ec722687848327dc26bd81f6e8b09c3dd7489044f4"
        }
      },
      "ecosystem": "evm",
      "authorization": {
        "type": "erc3009",
        "scope": {
          "token": {
            "chainId": 42161,
            "address": "0xaf88d065e77c8cC2239327C5EDb3A432268e5831"
          },
          "amount": "1000000",
          "recipient": "0x998d7c178A1F9607b47eA3A8e22426451b3ce707",
          "expiresAt": "2026-10-15T23:59:05.000Z"
        }
      }
    },
    {
      "kind": "submit_execution",
      "id": "submit-execution",
      "inputs": [
        "funding"
      ]
    }
  ],
  "orderId": "0x7a961202c77345e711eb85ec722687848327dc26bd81f6e8b09c3dd7489044f4",
  "amountType": "exact_input",
  "refundPolicy": {
    "supported": false,
    "reason": "irreversible_rail",
    "message": "This route does not guarantee an automatic refund. Recovery may require destination completion or operator assistance. Unfilled Across deposits remain eligible for an origin-chain refund after their SpokePool expiry and refund-bundle settlement."
  }
}

{
  "error": {
    "type": "request",
    "code": "request.unsupported_param",
    "message": "unsupported field: deadlineSec",
    "param": "deadlineSec",
    "requestId": "ikis71cj2ajdo6s5fqto949nao"
  }
}

{
  "code": "unauthenticated",
  "message": "the request does not have valid authentication credentials for the operation",
  "details": null
}

{
  "code": "unauthenticated",
  "message": "the request does not have valid authentication credentials for the operation",
  "details": {}
}

{
  "error": {
    "type": "request",
    "code": "request.invalid_json",
    "message": "string",
    "param": "string",
    "requestId": "string",
    "details": {
      "balanceCheck": {
        "chainId": 0,
        "tokenAddress": "string",
        "requiredAmount": "string",
        "observedBalance": "string",
        "blockNumber": 0,
        "observedAt": "2019-08-24T14:15:22Z"
      },
      "amountLimits": {
        "side": "min",
        "amount": "string",
        "token": {
          "chainId": 0,
          "address": "string"
        },
        "rail": "string",
        "observedAt": "2019-08-24T14:15:22Z"
      },
      "retryWithAllowedAuthorizationTypes": [
        "approval"
      ]
    }
  }
}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

429application/json

defaultapplication/json

USDC funded by an ERC-3009 signature (no authorizationPolicy)

Approval, then a Permit2 signature (the `transfer` request example)

10 USDC with a 0.0005 ETH gas top-up (the `gasTopUp` request example)

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`