relay_get_currencies
Retrieve verified token metadata from a curated list across multiple blockchains. Filter by chain ID, search term, contract address, or verification status to identify legitimate tokens for cross-chain operations.
Instructions
Get currencies metadata from a curated list. Supports filtering by chain IDs, search terms, addresses, and other criteria.
Common Examples: • Find USDC on specific chains: {"chainIds": [1, 10, 8453], "term": "usdc", "verified": true, "limit": 10} • All major tokens on Ethereum: {"chainIds": [1], "defaultList": true, "limit": 20} • Search by contract address: {"address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48", "includeAllChains": true} • Verified tokens only: {"verified": true, "limit": 50} • Deposit-address supported tokens: {"depositAddressOnly": true}
Tip: Use verified=true to avoid scam/fake tokens. Use term to search by symbol/name.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| defaultList | No | Return default currencies from curated list | |
| chainIds | No | Chain IDs to search for currencies (e.g., [1, 10, 137] for Ethereum, Optimism, Polygon) | |
| term | No | Search term for currencies (symbol, name, or partial match) | |
| address | No | Token contract address to search for | |
| currencyId | No | Specific currency ID to retrieve | |
| tokens | No | List of token identifiers in format chainId:address (e.g., ["1:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48"]) | |
| verified | No | Filter for verified currencies only (recommended to avoid scam tokens) | |
| limit | No | Limit the number of results (default: 20, max: 100) | |
| includeAllChains | No | Include all chains for a currency when filtering by chainId and address | |
| useExternalSearch | No | Use 3rd party APIs to search for tokens not indexed by Relay | |
| depositAddressOnly | No | Return only currencies supported with deposit address bridging |