Skip to content

Bridgeable tokens on a chain

GET
/crosschain/currencies
curl --request GET \
--url 'https://api.getchord.xyz/v1/crosschain/currencies?chainId=1&provider=lifi'

Tokens the provider can move on a chain, filtered by a search term.

chainId
required
integer
q
string
<= 40 characters

Symbol or name (≥ 2 characters).

provider
string
Allowed values: lifi relay

Bridge provider. Chord uses lifi.

Media typeapplication/json
object
chainId
integer
provider
string
currencies
Array<object>

Token rows (address, symbol, name, decimals, logo).

object
key
additional properties
any
Examplegenerated
{
"chainId": 1,
"provider": "example",
"currencies": [
{}
]
}

Invalid parameters — error names the check that failed (INVALID_PARAMS, BAD_ADDRESS, BAD_LIMIT, BAD_HOURS, …).

Media typeapplication/json

Every non-2xx body.

object
error
required

Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.

string
message

For humans.

string
statusCode

HTTP status, when included.

integer
Example
{
"error": "INVALID_PARAMS",
"message": "amount must be an integer string in the token's smallest unit"
}

The lane behind this endpoint is not ready or not enabled here (NOT_READY, CHAIN_NOT_ENABLED, NOT_ENABLED, *_UNAVAILABLE). Retry later; do not treat it as an empty answer.

Media typeapplication/json

Every non-2xx body.

object
error
required

Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.

string
message

For humans.

string
statusCode

HTTP status, when included.

integer
Example
{
"error": "INVALID_PARAMS",
"message": "amount must be an integer string in the token's smallest unit"
}