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

​
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).
  • By default, this endpoint returns full list of active coins that are currently listed on CoinGecko.com, you can also flag status=inactive to retrieve coins that are no longer available on CoinGecko.com. The inactive coin IDs can also be used with selected historical data endpoints.

​
Note

  • There is no pagination required for this endpoint.
  • Cache / Update Frequency: every 5 minutes for Pro API (Basic, Analyst, Lite, Pro, Enterprise).

Authorizations

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

Query Parameters

​
include_platform
boolean

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

​
status
enum<string>

filter by status of coins, default: active

Available options:
active,
inactive

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": {}
  }
]