Skip to main content
GET
/
liquidity
Check route liquidity for an amount
curl --request GET \
  --url https://v1.orchestrator.rhinestone.dev/deposit-processor/liquidity \
  --header 'x-api-key: <x-api-key>'
{
  "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

Liquidity information for the requested route

​
hasLiquidity
boolean
required
​
symbol
string
required
​
decimals
number
required
​
unlimited
boolean
required
​
maxAmount
string | null
required