Skip to main content
GET
/
coins
/
list
Coins List (ID Map)
curl --request GET \
  --url https://api.coingecko.com/api/v3/coins/list \
  --header 'x-cg-demo-api-key: <api-key>'
[
  {
    "id": "0chain",
    "symbol": "zcn",
    "name": "Zus",
    "platforms": {
      "ethereum": "0xb9ef770b6a5e12e45983c5d80545258aa38f3b78",
      "polygon-pos": "0x8bb30e0e67b11b978a5040144c410e1ccddcba30"
    }
  },
  {
    "id": "01coin",
    "symbol": "zoc",
    "name": "01coin",
    "platforms": {}
  }
]

Documentation Index

Fetch the complete documentation index at: https://docs.coingecko.com/llms.txt

Use this file to discover all available pages before exploring further.

​
Tips

  • You may use this endpoint to query the list of coins with coin ID for other endpoints that contain params like id or ids (coin ID).

​
Note

  • There is no pagination required for this endpoint.
  • Access to inactive coins via the Public API (Demo plan) is restricted. To access them, please subscribe to one of our paid plans to obtain a Pro-API key.
  • Cache / Update Frequency:
    • Every 30 minutes for Public API.
    • Every 5 minutes for Pro API (Basic, Analyst, Lite, Pro, Enterprise).

Authorizations

​
x-cg-demo-api-key
string
header
required

Query Parameters

​
include_platform
boolean

include platform and token's contract addresses, default: false

Response

200 - application/json

List all coins with ID, name, and symbol

​
id
string

coin ID

​
symbol
string

coin symbol

​
name
string

coin name

​
platforms
object

coin asset platform and contract address

Example:
[
  {
    "id": "0chain",
    "symbol": "zcn",
    "name": "Zus",
    "platforms": {
      "ethereum": "0xb9ef770b6a5e12e45983c5d80545258aa38f3b78",
      "polygon-pos": "0x8bb30e0e67b11b978a5040144c410e1ccddcba30"
    }
  },
  {
    "id": "01coin",
    "symbol": "zoc",
    "name": "01coin",
    "platforms": {}
  }
]