CoinGecko Coins List with Market Data

https://api.sandbase.ai/v1/api/coingecko/coins-markets

Get all the supported coins with price, market cap, volume and market related data

Price
$0.01USD / callFirst 100 calls per day free (shared per organization)
Method
POST
Response
JSON
Parameters
1 required · 13 optional
Production route

Try the model

Playground

Open playground
Input
Filter based on coins' category. *refers to [`/coins/categories/list`](/reference/coins-categories-list)
Coins' IDs, comma-separated if querying more than 1 coin. *refers to [`/coins/list`](/reference/coins-list)
Include rehypothecated tokens in results. When true, returns `market_cap_rank_with_rehypothecated` field. Default: false
For `symbols` lookups, specify `all` to include all matching tokens. Default `top` returns top-ranked tokens by market cap or volume. Allowed values: top, all.
Language background. Default: en Allowed values: ar, bg, cs, da, de, el, en, es, fi, fr, he, hi, hr, hu, id, it, ja, ko, lt, nl, no, pl, pt, ro, ru, sk, sl, sv, th, tr, uk, vi, zh, zh-tw.
Coins' names, comma-separated if querying more than 1 coin.
Sort result by field. Default: market_cap_desc Allowed values: market_cap_asc, market_cap_desc, volume_asc, volume_desc, id_asc, id_desc.
Page through results. Default: 1
Total results per page. Default: 100 Valid values: 1...250
Decimal places for currency price value Allowed values: full, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18.
Include price change percentage timeframe, comma-separated if querying more than 1 timeframe. Valid values: `1h`, `24h`, `7d`, `14d`, `30d`, `200d`, `1y`
Include sparkline 7-day data. Default: false
Coins' symbols, comma-separated if querying more than 1 coin.
Target currency of coins and market data. *refers to [`/simple/supported_vs_currencies`](/reference/simple-supported-currencies)
OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price
$0.01 / run
Daily free calls
First 100 calls per day free (shared per organization)

Request & response

Method
POST
Request body
application/json
Response
application/json
Execution
sync

Parameters

vs_currency
string · required
category
string · optional
ids
string · optional
include_rehypothecated
boolean · optional
include_tokens
string (top, all) · optional
locale
string (ar, bg, cs, da, de, el, en, es, fi, fr, he, hi, hr, hu, id, it, ja, ko, lt, nl, no, pl, pt, ro, ru, sk, sl, sv, th, tr, uk, vi, zh, zh-tw) · optional
names
string · optional
order
string (market_cap_asc, market_cap_desc, volume_asc, volume_desc, id_asc, id_desc) · optional
page
integer · optional
per_page
integer · optional
precision
string (full, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18) · optional
price_change_percentage
string · optional
More
+2 optional parameters

Access

Provider
CoinGecko
API
Platform API
Base URL
https://api.sandbase.ai
Endpoint
/v1/api/coingecko/coins-markets
Authentication
Bearer API key

API README

CoinGecko Coins List with Market Data API

Get all the supported coins with price, market cap, volume and market related data

The response is the official CoinGecko API response, unchanged.

Request

curl -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "coingecko/coins-markets", "vs_currency": "usd"}'

Parameters

NameTypeRequiredDescription
categorystringNoFilter based on coins' category. *refers to /coins/categories/list
idsstringNoCoins' IDs, comma-separated if querying more than 1 coin. *refers to /coins/list
include_rehypothecatedbooleanNoInclude rehypothecated tokens in results. When true, returns market_cap_rank_with_rehypothecated field. Default: false
include_tokensstringNoFor symbols lookups, specify all to include all matching tokens. Default top returns top-ranked tokens by market cap or volume.
localestringNoLanguage background. Default: en
namesstringNoCoins' names, comma-separated if querying more than 1 coin.
orderstringNoSort result by field. Default: market_cap_desc
pageintegerNoPage through results. Default: 1
per_pageintegerNoTotal results per page. Default: 100 Valid values: 1...250
precisionstringNoDecimal places for currency price value
price_change_percentagestringNoInclude price change percentage timeframe, comma-separated if querying more than 1 timeframe. Valid values: 1h, 24h, 7d, 14d, 30d, 200d, 1y
sparklinebooleanNoInclude sparkline 7-day data. Default: false
symbolsstringNoCoins' symbols, comma-separated if querying more than 1 coin.
vs_currencystringYesTarget currency of coins and market data. *refers to /simple/supported_vs_currencies

Pricing

Flat price per call. Failed calls are not charged.

Start building

Send your first request

Platform API endpoint with unified authentication and usage tracking.

Production API
Platform API endpoint
https://api.sandbase.ai/v1/api/coingecko/coins-markets
Authorization header
Authorization: Bearer $SANDBASE_API_KEY
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/api/coingecko/coins-markets" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "ids": "bitcoin",
  "names": "Bitcoin",
  "symbols": "btc",
  "vs_currency": "usd"
}
SANDBASE_JSON
)
printf '%s\n' "$result"

Explore more

Related APIs

All APIs
APIPriceResponseReleased
CoinGecko$0.01 per callJSONOct 30, 2026
CoinGecko$0.01 per callJSONOct 30, 2026
CoinGecko$0.01 per callJSONOct 30, 2026
CoinGecko$0.01 per callJSONOct 30, 2026
CoinGecko$0.01 per callJSONOct 30, 2026
CoinGecko$0.01 per callJSONOct 30, 2026

Questions

FAQ

How do I use the CoinGecko Coins List with Market Data API?

Send a POST request to https://api.sandbase.ai/v1/api/coingecko/coins-markets with your SandBase API key in the Authorization header (Bearer) and the parameters as a JSON body. You can also try it in the Playground on this page without writing code.

How much does the CoinGecko Coins List with Market Data API cost?

$0.01 per call. Every organization gets 100 free calls per UTC day, shared across eligible SandBase APIs including this one; after that each call is billed at this price from your SandBase balance. There is no subscription.

What parameters does the CoinGecko Coins List with Market Data API accept?

Required: vs_currency (string). Optional: category (string), ids (string), include_rehypothecated (boolean), include_tokens (one of top, all), locale (one of ar, bg, cs, da, de, el, en, es, fi, fr, he, hi, hr, hu, id, it, ja, ko, lt, nl, no, pl, pt, ro, ru, sk, sl, sv, th, tr, uk, vi, zh, zh-tw) and names (string) and 7 more. The Parameters table and the Playground on this page list every field.

What does the CoinGecko Coins List with Market Data API return?

A JSON response returned in the same HTTP request (synchronous).

Do I need a CoinGecko developer account or API key?

No. CoinGecko Coins List with Market Data runs through SandBase, so one SandBase API key covers this endpoint and every other API and model in the catalog. You do not need to apply for CoinGecko API access separately.