POST
/
currencies
/
v2
curl --request POST \
  --url https://api.relay.link/currencies/v2 \
  --header 'Content-Type: application/json' \
  --data '{
  "defaultList": true,
  "chainIds": [
    123
  ],
  "term": "<string>",
  "address": "<string>",
  "currencyId": "<string>",
  "tokens": [
    "<string>"
  ],
  "verified": true,
  "limit": 20,
  "includeAllChains": true,
  "useExternalSearch": true,
  "depositAddressOnly": true
}'
[
  {
    "chainId": 123,
    "address": "<string>",
    "symbol": "<string>",
    "name": "<string>",
    "decimals": 123,
    "vmType": "bvm",
    "metadata": {
      "logoURI": "<string>",
      "verified": true,
      "isNative": true
    }
  }
]

Body

application/json
​
defaultList
boolean

Return default currencies

​
chainIds
number[]

Chain IDs to search for currencies

​
term
string

Search term for currencies

​
address
string

Address of the currency contract

​
currencyId
string

ID to search for a currency

​
tokens
string[]

List of token addresses, like: chainId:address

​
verified
boolean

Filter verified currencies

​
limit
number
default:20

Limit the number of results

Required range: x <= 100
​
includeAllChains
boolean

Include all chains for a currency when filtering by chainId and address

​
useExternalSearch
boolean

Uses 3rd party API's to search for a token, in case relay does not have it indexed

​
depositAddressOnly
boolean

Returns only currencies supported with deposit address bridging

Response

200 - application/json
​
chainId
number
​
address
string
​
symbol
string
​
name
string
​
decimals
number
​
vmType
enum<string>
Available options:
bvm,
evm,
svm,
tvm,
tonvm,
suivm
​
metadata
object