Currencies

Talk to an expert

Discover how Request Network API can enhance your app's features - book a call with us.

Overview

The currencies API endpoints provide access to the complete Request Network token list, enabling you to discover and filter available tokens across multiple blockchain networks.

Key Features

• Payment Request Integration: Get the exact currency IDs needed for creating payment requests

• Payment Integration: Get accurate token information for payment processing

• Currency Validation: Verify supported tokens before creating payment requests

• Multi-Chain Support: Access tokens across Ethereum, Polygon, Arbitrum, and more

• Developer-Friendly: Simple filtering options for easy integration

Currency Information Structure

Each token in the response includes:

• id: Unique Request Network token identifier (e.g., USDC-mainnet)

• name: Human-readable token name (e.g., USD Coin)

• symbol: Token symbol (e.g., USDC)

• decimals: Number of decimal places for the token

• address: Contract address on the specified network

• network: Blockchain network name

• type: Token type (ERC20, ETH, etc.)

• hash: Contract address hash

• chainId: Blockchain chain ID

Endpoints

Get currencies

get

Get a list of all available tokens, or filter by network, symbol, or id.

Query parameters

networkstringOptional

The network of the token(s)

Example: mainnet

symbolstringOptional

The symbol of the token

Example: USDC

firstOnlystringOptional

Whether to return only the first token. can only be used when both network and symbol are provided.

Example: true

idstringOptional

The Request Network id of the token

Example: USDC-mainnet

Header parameters

x-api-keystringRequired

API key for authentication

Responses

200

List of tokens retrieved successfully

application/json

400

Validation failed

application/json

401

Unauthorized

404

Token not found

application/json

429

Too Many Requests

get

HTTPcURLJavaScriptPython

GET /v2/currencies HTTP/1.1
Host: api.request.network
x-api-key: text
Accept: */*

[
  {
    "id": "USDC-mainnet",
    "name": "USD Coin",
    "symbol": "USDC",
    "decimals": 6,
    "address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "network": "mainnet",
    "type": "ERC20",
    "hash": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "chainId": 1
  },
  {
    "id": "USDT-mainnet",
    "name": "Tether USD",
    "symbol": "USDT",
    "decimals": 6,
    "address": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "network": "mainnet",
    "type": "ERC20",
    "hash": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "chainId": 1
  }
]