RHrhinestonewtf
Utilities

Route liquidity limit

Changed on

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

Request

Query parameters

sourceChainIdinteger required

Source chain ID

Example:1
sourceTokenstring required

Source token address

Example:0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48
destinationChainIdinteger required

Destination chain ID

Example:8453
destinationTokenstring required

Destination token address (EVM 0x or non-EVM base58)

Example:0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Headers

x-api-version'2026-01.alps' required

API version. Required; pinned to this document.

x-api-keystring required

API key.

Response

OK

symbolstring required

Destination token symbol

decimalsnumber required

Destination token decimals

unlimitedboolean required

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

maxAmountstring nullable 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 response

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

Changes

  • 3656a04f8c42Revision changes
    • breaking

      the x-api-version request header's property undefined was restricted to a list of enum values

    • breaking

      the header request parameter x-api-version was restricted to a list of enum values

    • breaking

      the header request parameter x-api-version became required

    • breaking

      for the query request parameter destinationToken, the minLength was increased from 0 to 1

    • breaking

      for the query request parameter destinationChainId, the type changed from string to integer

    • breaking

      for the query request parameter sourceChainId, the type changed from string to integer

    • breaking

      the response's body type changed from no type to object for status

    • breaking

      the response's body type changed from no type to object for status

    • breaking

      the response's body type changed from no type to object for status

    • warning

      for the query request parameter destinationChainId, the min was set to 1.00

    • warning

      for the query request parameter sourceChainId, the min was set to 1.00

    • info

      api operation id listLiquidity was added

    • info

      added the new enum value 2026-01.alps to the header request parameter x-api-version

    • info

      removed the pattern ^\d{4}-\d{2}\.[a-z0-9]+$ from the header request parameter x-api-version

    • info

      removed the pattern ^eip155:\d+$ from the query request parameter destinationChainId

    • info

      removed the pattern ^eip155:\d+$ from the query request parameter sourceChainId

    • info

      removed response discriminator for the response status

    • info

      removed response discriminator for the response status

    • info

      removed response discriminator for the response status

    • info

      removed subschema #1 subschema #2 subschema #3 subschema #4 subschema #5 from the response body oneOf list for the response status

    • info

      removed subschema #1 subschema #2 subschema #3 subschema #4 subschema #5 from the response body oneOf list for the response status

    • info

      removed subschema #1 subschema #2 subschema #3 subschema #4 subschema #5 from the response body oneOf list for the response status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property to the response with the status

  • 36737b6b49a4Revision changes
    • breaking

      added subschema #2 to the response body oneOf list for the response status

    • breaking

      added subschema #2 to the response body oneOf list for the response status

    • breaking

      added subschema #2 to the response body oneOf list for the response status