Skip to main content
GET
/
coins
/
list
Coins List
curl --request GET \
  --url https://api.coingecko.com/api/v3/coins/list \
  --header 'x-cg-demo-api-key: <api-key>'
[
  {
    "id": "official-trump",
    "symbol": "trump",
    "name": "Official Trump",
    "platforms": {
      "solana": "6p6xgHyF7AeE6TZkSmFsko444wqoP15icUSqi2jfGiPN"
    }
  },
  {
    "id": "ondo-finance",
    "symbol": "ondo",
    "name": "Ondo",
    "platforms": {
      "ethereum": "0xfaba6f8e4a5e8ab82f62fe7c39859fa577269be3"
    }
  }
]

​
Notes

  • Use this endpoint to get coin IDs for other endpoints that require id or ids parameters.
  • No pagination required — the full list is returned in a single response.
Access to inactive coins via the Demo API is restricted. Subscribe to a paid plan to access them.

​
SDK Examples

const response = await client.coins.list.get();

console.log(JSON.stringify(response, null, 2));

Authorizations

​
x-cg-demo-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 of coins

​
id
string
required

Coin ID

​
symbol
string
required

Coin symbol

​
name
string
required

Coin name

​
platforms
object

Asset platform and contract address