Check route liquidity for an amount

Returns whether the given source→destination route can fulfil the requested amount, along with the underlying liquidity metadata from the orchestrator.

GET /liquidity

Check route liquidity for an amount

cURL

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

200

{
  "hasLiquidity": true,
  "symbol": "<string>",
  "decimals": 123,
  "unlimited": true,
  "maxAmount": "<string>"
}

Headers

x-api-key · string · required

API key for authentication

Example:

"your-api-key"

x-api-version · string

API version identifier (e.g. "2026-04.amazon"). Optional today, will become required in a future release.

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

Example:

"2026-04.amazon"

Query Parameters

sourceChainId · integer · required

Source chain ID (EVM chain ID)

Required range: x > 0

Example:

1

sourceToken · string · required

Source token address

Pattern: ^0x[a-fA-F0-9]{40}$

Example:

"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"

destinationChainId · integer · required

Destination chain ID (EVM chain ID)

Required range: x > 0

Example:

8453

destinationToken · string · required

Destination token address

Pattern: ^0x[a-fA-F0-9]{40}$

Example:

"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"

amount · string · required

Deposit amount in raw source-token units (integer string)

Pattern: ^\d+$

Example:

"1000000"

Response

200

application/json

Liquidity information for the requested route

hasLiquidity · boolean · required

symbol · string · required

decimals · number · required

unlimited · boolean · required

maxAmount · string | null · required