Skip to main content
GET
Coins List with Market Data
A ranked market table covering many coins in one call: one row per coin with current_price, market_cap, market_cap_rank, total_volume, high_24h, low_24h, price_change_percentage_24h, circulating_supply, total_supply, max_supply, ath and atl with their dates, and image. Page with per_page and page, sort with order (market cap, volume or id, ascending or descending), and narrow with ids or category. Passing price_change_percentage adds a matching price_change_percentage_24h_in_currency field. Use it for leaderboards and segment scans. For the price of a few known coins get_coingecko_simple_price is far lighter; for one coin in full use get_coingecko_coins_id.
First time? Point any MCP client at https://mcp.aisa.one/mcp — Claude Code, Codex, Cursor, VS Code and the rest. Authorization is OAuth: the client opens a browser, you click Allow once, and there is no key to paste. Your agent then reaches every endpoint through five tools: search, list_categories and get_details are free, use and batch_use are billed per call. Setup per client is in Connect via MCP; the live tool list and what each call costs are on aisa.one/mcp.
Set this endpoint up in your agent →

Cost and request rules

Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.
  • Default request reference estimate (USD): 0.008
  • Declared unit rate (USD): 0.0
  • Billing unit: provider_credit
  • Cost contract: plan_units
  • Settlement evidence source: request_snapshot

Declared request billing units

  • Units: 1

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

category
string

Filter based on coins' category. *refers to /coins/categories/list

ids
string
default:bitcoin

Coins' IDs, comma-separated if querying more than 1 coin. *refers to /coins/list

include_rehypothecated
boolean

Include rehypothecated tokens in results. When true, returns market_cap_rank_with_rehypothecated field. Default: false

include_tokens
enum<string>

For symbols lookups, specify all to include all matching tokens. Default top returns top-ranked tokens by market cap or volume.

Available options:
top,
all
locale
enum<string>

Language background. Default: en

Available options:
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
names
string
default:Bitcoin

Coins' names, comma-separated if querying more than 1 coin.

order
enum<string>

Sort result by field. Default: market_cap_desc

Available options:
market_cap_asc,
market_cap_desc,
volume_asc,
volume_desc,
id_asc,
id_desc
page
integer

Page through results. Default: 1

per_page
integer

Total results per page. Default: 100 Valid values: 1...250

precision
enum<string>

Decimal places for currency price value

Available options:
full,
0,
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18
price_change_percentage
string

Include price change percentage timeframe, comma-separated if querying more than 1 timeframe. Valid values: 1h, 24h, 7d, 14d, 30d, 200d, 1y

sparkline
boolean

Include sparkline 7-day data. Default: false

symbols
string
default:btc

Coins' symbols, comma-separated if querying more than 1 coin.

vs_currency
string
default:usd
required

Target currency of coins and market data. *refers to /simple/supported_vs_currencies

Response

List of coins with market data

id
string
required

Coin ID

symbol
string
required

Coin symbol

name
string
required

Coin name

image
string
required

Coin image URL

current_price
number | null
required

Current price in target currency

market_cap
number | null
required

Market cap in target currency

market_cap_rank
integer | null
required

Market cap rank

fully_diluted_valuation
number | null
required

Fully diluted valuation in target currency

total_volume
number | null
required

Total trading volume in target currency

high_24h
number | null
required

24-hour price high in target currency

low_24h
number | null
required

24-hour price low in target currency

price_change_24h
number | null
required

24-hour price change in target currency

price_change_percentage_24h
number | null
required

24-hour price change percentage

market_cap_change_24h
number | null
required

24-hour market cap change in target currency

market_cap_change_percentage_24h
number | null
required

24-hour market cap change percentage

circulating_supply
number | null
required

Circulating supply

total_supply
number | null
required

Total supply

max_supply
number | null
required

Max supply

ath
number | null
required

All-time high price in target currency

ath_change_percentage
number | null
required

All-time high change percentage

ath_date
string<date-time> | null
required

All-time high date

atl
number | null
required

All-time low price in target currency

atl_change_percentage
number | null
required

All-time low change percentage

atl_date
string<date-time> | null
required

All-time low date

roi
object | null
required

Return on investment data

last_updated
string<date-time>
required

Last updated timestamp

market_cap_rank_with_rehypothecated
integer | null

Market cap rank including rehypothecated tokens

sparkline_in_7d
object

Sparkline price data for the last 7 days

price_change_percentage_1h_in_currency
number | null

1-hour price change percentage in target currency

price_change_percentage_24h_in_currency
number | null

24-hour price change percentage in target currency

price_change_percentage_7d_in_currency
number | null

7-day price change percentage in target currency

price_change_percentage_14d_in_currency
number | null

14-day price change percentage in target currency

price_change_percentage_30d_in_currency
number | null

30-day price change percentage in target currency

price_change_percentage_200d_in_currency
number | null

200-day price change percentage in target currency

price_change_percentage_1y_in_currency
number | null

1-year price change percentage in target currency