AcrossAcross Docs
IntroductionGuidesAI AgentsToolsAPI ReferenceChains & Contracts

Retrieve available routes for transfers

Returns available routes based on specified parameters.

Legacy: The /available-routes API is no longer actively maintained. New integrations should use the Swap API instead.

GET
/available-routes

Authorization

bearerAuth
AuthorizationBearer <token>

API key for authentication. Request your key at https://t.me/acrosstg.

In: header

Query Parameters

originChainId?integer

Chain ID of the originating chain.

Range1 <= value
Value in1 | 10 | 137 | 324 | 8453 | 42161 | 59144 | 84532 | 421614 | 11155420 | 11155111
destinationChainId?integer

Chain ID of the destination chain.

Range1 <= value
Value in1 | 10 | 137 | 324 | 8453 | 42161 | 59144 | 84532 | 421614 | 11155420 | 11155111
originToken?string

Origin chain address of token contract to transfer.

Example: 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2

destinationToken?string

Destination chain address of token contract to receive.

Example: 0x4200000000000000000000000000000000000006

Response Body

application/json

application/json

application/json

curl -X GET "https://app.across.to/api/available-routes?originChainId=1&destinationChainId=10&originToken=0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2&destinationToken=0x4200000000000000000000000000000000000006"
[
  {
    "originChainId": 1,
    "originToken": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
    "destinationChainId": 10,
    "destinationToken": "0x4200000000000000000000000000000000000006",
    "originTokenSymbol": "WETH",
    "destinationTokenSymbol": "WETH",
    "isNative": false
  },
  {
    "originChainId": 1,
    "originToken": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
    "destinationChainId": 10,
    "destinationToken": "0x4200000000000000000000000000000000000006",
    "originTokenSymbol": "ETH",
    "destinationTokenSymbol": "ETH",
    "isNative": true
  }
]
{
  "type": "AcrossApiError",
  "code": "INVALID_PARAM",
  "status": 400,
  "message": "Invalid parameter at path 'originToken'. Expected type 'union'",
  "param": "originToken"
}
{
  "type": "AcrossApiError",
  "code": "INTERNAL_SERVER_ERROR",
  "status": 500,
  "message": "Internal server error"
}

Retrieve suggested fee quote for a deposit. GET

Returns suggested fees based on `inputToken`, `outputToken`, `originChainId`, `destinationChainId`, and `amount`. Also includes transfer limits of the system and data used to compute the fees.

Retrieve current transfer limits of the system GET

Returns transfer limits for `inputToken`, `outputToken`, `originChainId`, and `destinationChainId`.