Skip to main content
POST
Discover market routes

Authorizations

Authorization
string
header
required

Pass a Kaleido API key such as kld_live_c_....

Body

application/json

Request for route discovery.

from_asset
string
required

Source asset ticker or ID

from_layer
enum<string> | null

Filter by source layer (optional)

Available options:
BTC_L1,
BTC_LN,
BTC_SPARK,
BTC_ARKADE,
BTC_LIQUID,
BTC_CASHU,
RGB_L1,
RGB_LN,
TAPASS_L1,
TAPASS_LN,
LIQUID_LIQUID,
ARKADE_ARKADE,
SPARK_SPARK
to_asset
string | null

Destination asset (if None, returns all reachable assets)

to_layer
enum<string> | null

Filter by destination layer (optional)

Available options:
BTC_L1,
BTC_LN,
BTC_SPARK,
BTC_ARKADE,
BTC_LIQUID,
BTC_CASHU,
RGB_L1,
RGB_LN,
TAPASS_L1,
TAPASS_LN,
LIQUID_LIQUID,
ARKADE_ARKADE,
SPARK_SPARK
max_hops
integer
default:2

Maximum number of hops (1-5)

Required range: 1 <= x <= 5

Response

Successful Response

Response with discovered routes.

routes
MultiHopRoute · object[]
required

List of discovered routes

timestamp
integer
required

Response timestamp