Skip to main content

Get Coins by Network

Retrieve virtual assets (cryptocurrencies) available on a specific blockchain network.

Endpoint​

GET /coins/network/{blockchain}

Headers​

HeaderValueRequired
x-api-key{your-api-key}Yes
x-secret-key{your-secret-key}Yes

Path Parameters​

ParameterTypeRequiredDescription
blockchainstringYesNetwork identifier (e.g., "ethereum", "solana", "bitcoin")

Example Request​

curl -X GET "{{baseUrl}}/coins/network/ethereum" \
  -H "x-api-key: {your-api-key}" \
  -H "x-secret-key: {your-secret-key}"

Response​

Success (200 OK)​

{
  "success": true,
  "data": [
    {
      "id": "0dog",
      "symbol": "0dog",
      "name": "Bitcoin Dogs",
      "platforms": {
        "ethereum": "0xaa6624d7363ef8284aa8ce4e18146ded5f421b2c"
      },
      "enabled": true,
      "createdAt": "2025-05-23T10:15:20.745Z",
      "updatedAt": "2025-05-23T19:59:57.964Z"
    },
    {
      "id": "0-knowledge-network",
      "symbol": "0kn",
      "name": "0 Knowledge Network",
      "platforms": {
        "ethereum": "0x4594cffbfc09bc5e7ecf1c2e1c1e24f0f7d29036"
      },
      "enabled": true,
      "createdAt": "2025-05-23T10:15:20.745Z",
      "updatedAt": "2025-05-23T19:59:57.964Z"
    },
    {
      "id": "1art",
      "symbol": "1art",
      "name": "OneArt",
      "platforms": {
        "fantom": "0xd3c325848d7c6e29b574cb0789998b2ff901f17e",
        "ethereum": "0xd3c325848d7c6e29b574cb0789998b2ff901f17e",
        "binance-smart-chain": "0xd3c325848d7c6e29b574cb0789998b2ff901f17e"
      },
      "enabled": true,
      "createdAt": "2025-05-23T10:15:20.745Z",
      "updatedAt": "2025-05-23T19:59:57.964Z"
    },
    {
      "id": "ethereum",
      "symbol": "eth",
      "name": "Ethereum",
      "platforms": {
        "ethereum": "0x0000000000000000000000000000000000000000"
      },
      "enabled": true,
      "createdAt": "2025-05-23T10:15:20.745Z",
      "updatedAt": "2025-05-23T19:59:57.964Z"
    }
  ]
}

Error (404 Not Found)​

{
  "success": false,
  "error": "Network not found",
  "code": "NETWORK_NOT_FOUND"
}

Example Requests​

Get Ethereum tokens​

curl -X GET "{{baseUrl}}/coins/network/ethereum" \
  -H "x-api-key: {your-api-key}" \
  -H "x-secret-key: {your-secret-key}"

Get Solana tokens​

curl -X GET "{{baseUrl}}/coins/network/solana" \
  -H "x-api-key: {your-api-key}" \
  -H "x-secret-key: {your-secret-key}"

Get Binance Smart Chain tokens​

curl -X GET "{{baseUrl}}/coins/network/binance-smart-chain" \
  -H "x-api-key: {your-api-key}" \
  -H "x-secret-key: {your-secret-key}"

Get Bitcoin assets​

curl -X GET "{{baseUrl}}/coins/network/bitcoin" \
  -H "x-api-key: {your-api-key}" \
  -H "x-secret-key: {your-secret-key}"

Supported Networks​

Common blockchain identifiers:

  • ethereum - Ethereum mainnet
  • solana - Solana blockchain
  • bitcoin - Bitcoin network
  • binance-smart-chain - Binance Smart Chain
  • polygon-pos - Polygon
  • base - Base network
  • arbitrum-one - Arbitrum One
  • avalanche - Avalanche C-Chain
  • fantom - Fantom Opera
  • the-open-network - TON blockchain
  • tron - TRON network
  • xdai - Gnosis Chain
  • klay-token - Klaytn

Use Cases​

  1. Network-Specific Trading: Display only assets available on the selected blockchain
  2. Wallet Integration: Show tokens for the user's connected network
  3. Cross-Chain Analysis: Compare token availability across different networks
  4. Transaction Planning: Find available tokens before initiating transfers on a specific network
  5. Platform-Specific Views: Create network-specific token lists for DeFi applications

Notes​

  • This endpoint returns only coins that exist on the specified network
  • Multi-chain tokens will show all their platform addresses in the platforms object
  • Native coins (like ETH on Ethereum) may use the zero address or have a special designation
  • The response includes only coins with contracts or native support on the specified blockchain