Skip to main content
GET
/
entities
/
list
Entities List (ID Map)
curl --request GET \
  --url https://api.coingecko.com/api/v3/entities/list \
  --header 'x-cg-demo-api-key: <api-key>'
[
  {
    "id": "usbc",
    "symbol": "USBC.US",
    "name": "USBC",
    "country": "US"
  },
  {
    "id": "mara-holdings",
    "symbol": "MARA.US",
    "name": "MARA Holdings",
    "country": "US"
  }
]

​
Note

  • Cache / Update Frequency: every 5 minutes for all the API plans.

Authorizations

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

Query Parameters

​
entity_type
enum<string>

filter by entity type, default: false

Available options:
company,
government
​
per_page
integer

total results per page, default: 100 Valid values: 1...250

​
page
integer

page through results, default: 1

Response

200 - application/json

List all entities with ID, name, symbol and country

​
id
string

entity ID

​
symbol
string

ticker symbol of public company

​
name
string

entity name

​
country
string

country code

Example:
[
  {
    "id": "usbc",
    "symbol": "USBC.US",
    "name": "USBC",
    "country": "US"
  },
  {
    "id": "mara-holdings",
    "symbol": "MARA.US",
    "name": "MARA Holdings",
    "country": "US"
  }
]