cryptodataapi-com Coins API
Coin profiles, search, top lists, and curated category groups.
Coin profiles, search, top lists, and curated category groups.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/cryptodataapi-com:cryptodataapi-com-coins-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Crypto Data Coins API
description: 'Real-time crypto market intelligence API. Built for AI agents: gasless USDC payments via x402 protocol, one-call onboarding, and 180+ endpoints for prices, derivatives, funding, and sentiment.'
version: '2026-10-28'
servers:
- url: https://cryptodataapi.com
tags:
- name: Coins
description: Coin profiles, search, top lists, and curated category groups.
paths:
/api/v1/coins:
get:
tags:
- Coins
summary: List Coins
description: List all coins, paginated by market cap rank.
operationId: list_coins_api_v1_coins_get
security:
- APIKeyHeader: []
parameters:
- name: page
in: query
required: false
schema:
type: integer
minimum: 1
default: 1
title: Page
- name: per_page
in: query
required: false
schema:
type: integer
maximum: 250
minimum: 1
default: 50
title: Per Page
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/CoinListResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/coins/search:
get:
tags:
- Coins
summary: Search Coins
description: Search coins by name or symbol.
operationId: search_coins_api_v1_coins_search_get
security:
- APIKeyHeader: []
parameters:
- name: q
in: query
required: true
schema:
type: string
minLength: 1
title: Q
example: bitcoin
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/CoinSearchResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/coins/top:
get:
tags:
- Coins
summary: Top Coins
description: Get top N coins by market cap.
operationId: top_coins_api_v1_coins_top_get
security:
- APIKeyHeader: []
parameters:
- name: limit
in: query
required: false
schema:
type: integer
maximum: 100
minimum: 1
default: 20
title: Limit
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/CoinTopResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/coins/categories:
get:
tags:
- Coins
summary: Coin Categories
description: Get all unique coin categories.
operationId: coin_categories_api_v1_coins_categories_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/CoinCategoriesResponse'
security:
- APIKeyHeader: []
/api/v1/coins/category-groups:
get:
tags:
- Coins
summary: Coin Category Groups
description: 'Curated coin-category themes (20+ major categories).
Covers AI, Layer-1 / platform, Layer-2 & scaling, DeFi, DEX, lending, liquid
staking, stablecoins, exchange tokens, meme, privacy, RWA, NFT, gaming,
metaverse, DePIN, oracles, interoperability, storage, Bitcoin / Solana /
Cosmos ecosystems, PoW and derivatives. Each group carries a plain-English
description and a resolved list of the tracked coins that belong to it (live
price, market cap, rank, 24h/7d change), sorted by market-cap rank. Unlike
`/coins/categories` (raw CoinGecko tag names), this is an editorial set built
for the Coin Categories page.'
operationId: coin_category_groups_api_v1_coins_category_groups_get
security:
- APIKeyHeader: []
parameters:
- name: limit
in: query
required: false
schema:
type: integer
maximum: 100
minimum: 1
description: Max coins per category group
default: 25
title: Limit
description: Max coins per category group
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/CoinCategoryGroupsResponse'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/coins/{symbol}:
get:
tags:
- Coins
summary: Get Coin
description: Get a single coin profile by symbol (e.g., BTC, ETH).
operationId: get_coin_api_v1_coins__symbol__get
security:
- APIKeyHeader: []
parameters:
- name: symbol
in: path
required: true
schema:
type: string
title: Symbol
example: BTC
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/CoinProfile'
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
CoinCategoryGroupsResponse:
properties:
categories:
items:
$ref: '#/components/schemas/CoinCategoryGroup'
type: array
title: Categories
count:
type: integer
title: Count
type: object
required:
- categories
- count
title: CoinCategoryGroupsResponse
description: Curated category groups (AI, Platform, Privacy, RWA, NFT, ...).
CoinSearchResponse:
properties:
results:
items:
$ref: '#/components/schemas/CoinProfile'
type: array
title: Results
query:
type: string
title: Query
count:
type: integer
title: Count
type: object
required:
- results
- query
- count
title: CoinSearchResponse
description: Search results.
CoinCategoryGroup:
properties:
id:
type: string
title: Id
name:
type: string
title: Name
description:
type: string
title: Description
coin_count:
type: integer
title: Coin Count
coins:
items:
$ref: '#/components/schemas/CategoryCoin'
type: array
title: Coins
type: object
required:
- id
- name
- description
- coin_count
- coins
title: CoinCategoryGroup
description: A single curated category theme with its resolved coins.
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
CoinTopResponse:
properties:
coins:
items:
$ref: '#/components/schemas/CoinProfile'
type: array
title: Coins
count:
type: integer
title: Count
type: object
required:
- coins
- count
title: CoinTopResponse
description: Top coins by market cap.
CategoryCoin:
properties:
symbol:
type: string
title: Symbol
name:
type: string
title: Name
default: ''
current_price:
title: Current Price
type:
- number
- 'null'
market_cap:
type: number
title: Market Cap
default: 0
market_cap_rank:
type: integer
title: Market Cap Rank
default: 0
total_volume:
type: number
title: Total Volume
default: 0
price_change_24h_pct:
type: number
title: Price Change 24H Pct
default: 0
price_change_7d_pct:
type: number
title: Price Change 7D Pct
default: 0
image_url:
type: string
title: Image Url
default: ''
type: object
required:
- symbol
title: CategoryCoin
description: Compact coin record inside a curated category group.
CoinProfile:
properties:
coingecko_id:
type: string
title: Coingecko Id
default: ''
symbol:
type: string
title: Symbol
name:
type: string
title: Name
current_price:
title: Current Price
type:
- number
- 'null'
market_cap:
type: number
title: Market Cap
default: 0
market_cap_rank:
type: integer
title: Market Cap Rank
default: 0
circulating_supply:
type: number
title: Circulating Supply
default: 0
max_supply:
title: Max Supply
type:
- number
- 'null'
total_supply:
type: number
title: Total Supply
default: 0
total_volume:
type: number
title: Total Volume
default: 0
price_change_24h_pct:
type: number
title: Price Change 24H Pct
default: 0
price_change_7d_pct:
type: number
title: Price Change 7D Pct
default: 0
price_change_30d_pct:
type: number
title: Price Change 30D Pct
default: 0
ath:
type: number
title: Ath
default: 0
ath_change_pct:
type: number
title: Ath Change Pct
default: 0
ath_date:
type: string
title: Ath Date
default: ''
atl:
type: number
title: Atl
default: 0
atl_change_pct:
type: number
title: Atl Change Pct
default: 0
atl_date:
type: string
title: Atl Date
default: ''
categories:
items:
type: string
type: array
title: Categories
default: []
description:
type: string
title: Description
default: ''
image_url:
type: string
title: Image Url
default: ''
last_updated:
type: string
title: Last Updated
default: ''
cap_tier:
type: string
title: Cap Tier
default: ''
type: object
required:
- symbol
- name
title: CoinProfile
description: Full coin profile.
CoinCategoriesResponse:
properties:
categories:
items:
type: string
type: array
title: Categories
count:
type: integer
title: Count
type: object
required:
- categories
- count
title: CoinCategoriesResponse
description: All unique coin categories.
CoinListResponse:
properties:
coins:
items:
$ref: '#/components/schemas/CoinProfile'
type: array
title: Coins
total:
type: integer
title: Total
page:
type: integer
title: Page
per_page:
type: integer
title: Per Page
type: object
required:
- coins
- total
- page
- per_page
title: CoinListResponse
description: Paginated coin list response.
securitySchemes:
APIKeyHeader:
type: apiKey
in: header
name: X-API-Key