Route liquidity limit

Returns the largest known fillable amount for a single deposit on the given source→destination route. Relayer-market layers return exact capacity; bridge-backed layers return a conservative probed lower bound.

GET /liquidity

Route liquidity limit

cURL

curl --request GET \
  --url https://v1.orchestrator.rhinestone.dev/liquidity \
  --header 'x-api-key: <x-api-key>'

200

{
  "symbol": "USDC",
  "decimals": 6,
  "unlimited": false,
  "maxAmount": "200000000000"
}

Headers

x-api-key · string · required

Rhinestone API key

x-api-version · string

API version (YYYY-MM.name). Will become required in a future release.

Pattern: ^\d{4}-\d{2}\.[a-z0-9]+$

Example:

"2026-01.alps"

Query Parameters

sourceChainId · string · required

Source chain ID

Pattern: ^eip155:\d+$

Example:

"eip155:42161"

sourceToken · string · required

Source token address

Example:

"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"

destinationChainId · string · required

Destination chain ID

Pattern: ^eip155:\d+$

Example:

"eip155:42161"

destinationToken · string · required

Destination token address

Example:

"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

Response

200

application/json

200

Liquidity information for the requested route

symbol · string · required

Destination token symbol

Example:

"USDC"

decimals · number · required

Destination token decimals

Example:

6

unlimited · boolean · required

True when an uncapped settlement layer (e.g. OFT) supports this route

Example:

false

maxAmount · string | null · required

Largest known fillable amount for this token by a single relayer instance. Exact for relayer-market settlement layers (ACROSS, ECO); bridge-backed layers (Relay, NEAR, Rhino) return a conservative probed lower bound. Null when unlimited.

Example:

"200000000000"