---
title: "POST /currencies/v1"
method: POST
path: "/currencies/v1"
---

# POST /currencies/v1

`POST /currencies/v1`

## Headers

- `x-api-key` string

## Request body

- object
  - `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 group
  - `tokens` string[] — List of token addresses, like: chainId:address
  - `verified` boolean — Filter verified currencies
  - `limit` number — Limit the number of results
  - `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`

List of currencies

- array[] — List of currencies
  - object[]
    - `groupID` string
    - `chainId` number
    - `address` string
    - `symbol` string
    - `name` string
    - `decimals` number
    - `vmType` 'bvm' | 'evm' | 'svm' | 'tvm' | 'tonvm' | 'hypevm' | 'lvm' | 'xrpvm'
    - `metadata` object
      - `logoURI` string
      - `verified` boolean
      - `isNative` boolean

---

[API](https://skmtc.net/relay/apis/cross-chain-solver.md) · [All operations](https://skmtc.net/relay/apis/cross-chain-solver/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/relay/cross-chain-solver/revisions/b7a5c4fa51bf/schema)