Chains & Tokens

The platform supports multiple blockchain networks (chains) and cryptocurrency tokens. Use these endpoints to discover available chains and tokens, and understand their configuration.

The chain model

Chains represent blockchain networks using the CAIP-2 standard format.

Properties

Name
id
Type
string
Description
Unique chain identifier in CAIP-2 format (e.g., eip155:1 for Ethereum mainnet).
Name
name
Type
string
Description
Human-readable chain name (e.g., "Ethereum", "Bitcoin").
Name
namespace
Type
string
Description
Blockchain namespace (e.g., eip155 for EVM chains, bip122 for Bitcoin).
Name
reference
Type
string
Description
Chain reference (e.g., 1 for Ethereum mainnet, 137 for Polygon).
Name
enabled
Type
boolean
Description
Whether the chain is currently enabled for your organization.
Name
isTestnet
Type
boolean
Description
Whether this is a testnet or mainnet chain.
Name
properties
Type
object
Description
Additional chain-specific properties (native currency, decimals, etc.).

GET/chains

List all chains

Retrieve a list of all supported blockchain networks. By default, only enabled chains are returned.

Optional parameters

Name
enabledOnly
Type
boolean
Description
Filter to show only enabled chains (default: true).

Request

GET

/chains

curl -G https://api.coinspayd.io/chains \
  -H "x-api-key: {your-api-key}" \
  -d enabledOnly=true

Response

{
  "chains": [
    {
      "id": "eip155:1",
      "name": "Ethereum",
      "namespace": "eip155",
      "reference": "1",
      "enabled": true,
      "isTestnet": false,
      "properties": {
        "nativeCurrency": "ETH",
        "decimals": 18
      }
    },
    {
      "id": "eip155:137",
      "name": "Polygon",
      "namespace": "eip155",
      "reference": "137",
      "enabled": true,
      "isTestnet": false,
      "properties": {
        "nativeCurrency": "MATIC",
        "decimals": 18
      }
    },
    {
      "id": "bip122:000000000019d6689c085ae165831e93",
      "name": "Bitcoin",
      "namespace": "bip122",
      "reference": "000000000019d6689c085ae165831e93",
      "enabled": true,
      "isTestnet": false,
      "properties": {}
    }
  ]
}

GET/chains/:id

Get a specific chain

Retrieve details for a specific blockchain network by its CAIP-2 identifier.

Request

GET

/chains/eip155:1

curl https://api.coinspayd.io/chains/eip155:1 \
  -H "x-api-key: {your-api-key}"

Response

{
  "chain": {
    "id": "eip155:1",
    "name": "Ethereum",
    "namespace": "eip155",
    "reference": "1",
    "enabled": true,
    "isTestnet": false,
    "properties": {}
  }
}

The token model

Tokens represent cryptocurrencies using the CAIP-19 standard format.

Properties

Name
id
Type
string
Description
Unique token identifier in CAIP-19 format (e.g., eip155:1/erc20:0xa0b86991...).
Name
chainId
Type
string
Description
The chain this token belongs to (CAIP-2 format).
Name
name
Type
string
Description
Token name (e.g., "USD Coin").
Name
symbol
Type
string
Description
Token symbol (e.g., "USDC").
Name
decimals
Type
number
Description
Number of decimal places (e.g., 6 for USDC, 18 for ETH).
Name
address
Type
string
Description
Token contract address (for ERC-20/TRC-20 tokens).
Name
enabled
Type
boolean
Description
Whether the token is currently enabled.
Name
minimumAmount
Type
string
Description
Minimum deposit amount in base units.
Name
properties
Type
object
Description
Additional token-specific properties.

GET/tokens

List all tokens

Retrieve a list of all supported tokens, optionally filtered by chain.

Optional parameters

Name
chainId
Type
string
Description
Filter tokens by chain ID (CAIP-2 format).
Name
enabledOnly
Type
boolean
Description
Filter to show only enabled tokens (default: true).

Request

GET

/tokens

curl -G https://api.coinspayd.io/tokens \
  -H "x-api-key: {your-api-key}" \
  -d enabledOnly=true

Response

{
  "tokens": [
    {
      "id": "eip155:1/erc20:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "chainId": "eip155:1",
      "name": "USD Coin",
      "symbol": "USDC",
      "decimals": 6,
      "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "enabled": true,
      "minimumAmount": "1000000",
      "properties": {}
    },
    {
      "id": "eip155:1/erc20:0xdac17f958d2ee523a2206206994597c13d831ec7",
      "chainId": "eip155:1",
      "name": "Tether USD",
      "symbol": "USDT",
      "decimals": 6,
      "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "enabled": true,
      "minimumAmount": "1000000",
      "properties": {}
    }
  ]
}

Supported chains

The platform supports these blockchain networks:

Mainnet Chains

Chain	Chain ID (CAIP-2)	Namespace
Ethereum	`eip155:1`	eip155
Polygon	`eip155:137`	eip155
BSC	`eip155:56`	eip155
Bitcoin	`bip122:000000000019d6689c085ae165831e93`	bip122
Tron	`tron:0x00000000000000000000000000000000`	tron
XRP	`xrpl:mainnet`	xrpl

Testnet Chains

Chain	Chain ID (CAIP-2)	Namespace
Ethereum Sepolia	`eip155:11155111`	eip155
BSC Testnet	`eip155:97`	eip155
Bitcoin Testnet	`bip122:000000000933ea01ad0ee984209779ba`	bip122
Tron Shasta	`tron:shasta`	tron
XRP Testnet	`xrpl:testnet`	xrpl

Common token examples

Here are some commonly used tokens across different chains:

Ethereum (eip155:1)

USDC: eip155:1/erc20:0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48
USDT: eip155:1/erc20:0xdac17f958d2ee523a2206206994597c13d831ec7
DAI: eip155:1/erc20:0x6b175474e89094c44da98b954eedeac495271d0f
Native ETH: eip155:1/slip44:60

Polygon (eip155:137)

USDC: eip155:137/erc20:0x2791bca1f2de4661ed88a30c99a7a9449aa84174
USDT: eip155:137/erc20:0xc2132d05d31c914a87c6611c10748aeb04b58e8f
Native MATIC: eip155:137/slip44:60

Bitcoin

Native BTC: bip122:000000000019d6689c085ae165831e93/slip44:0

Tron

USDT (TRC-20): tron:0x00000000000000000000000000000000/trc20:TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t
Native TRX: tron:0x00000000000000000000000000000000/slip44:195

XRP

Native XRP: xrpl:mainnet/slip44:144