CoinMarketCap API

CoinMarketCap Listings API

Get the current top cryptocurrencies from CoinMarketCap (rank, price, market cap, volume, and 24h change) as normalized JSON.

Start freeDownload sampleor JSON

$1.98/1k results, pay per request, no subscription.

What the API returneditems[0]
{
"id": "1",
"name": "Bitcoin",
"symbol": "BTC",
"slug": "bitcoin",
"price": 83050.5,
"marketCap": 1660000000000,
"volume24h": 39680000000,
"circulatingSupply": 20090000,
... 23 more fields
}
Uptime
100.00%
30d · 16 calls
Requests
16
30d · weekly, last 12 wks
Response
12.8s
median · 30d

Pricing

CoinMarketCap Listings API pricing

You pay
$19.80
$1.98/1k results, only for what you use. No monthly plan.
One request costs at most $0.0495 (25 results).
The $0.10 starting balance covers at least 2 requests.

Try it

Get CoinMarketCap listings in one request

Open in
Get a free key
Sample response
Free runs return only the first 3 results. Fund a key to get the full response.

This sample shows 32 of 35 fields. See every field

{
  "found": true,
  "data": {
    "items": [
      {
        "id": "1",
        "name": "Bitcoin",
        "symbol": "BTC",
        "slug": "bitcoin",
        "price": 83050.5,
        "marketCap": 1660000000000,
        "volume24h": 39680000000,
        "circulatingSupply": 20090000,
        "totalSupply": 21000000,
        "ath": 108786.5,
        "atl": 0.04865,
        "high24h": 84120.75,
        "low24h": 81900.2,
        "lastUpdated": "2026-09-28T14:02:00Z",
        "createdUtc": 1231006505,
        "marketPairCount": 11842,
        "active": true,
        "volume7d": 268000000000,
        "volume30d": 1120000000000,
        "fullyDilutedMarketCap": 1744000000000,
        "dominance": 58.7,
        "turnover": 0.0239,
        "percentChange1h": 0.15,
        "percentChange24h": -0.42,
        "percentChange7d": -2.92,
        "percentChange30d": 6.1,
        "percentChange90d": 14.3,
        "percentChange1y": 41.8,
        "percentChangeYtd": 22.4
      },
      {
        "id": "1027",
        "name": "Ethereum",
        "symbol": "ETH",
        "slug": "ethereum",
        "price": 2664.64,
        "marketCap": 325340000000,
        "volume24h": 15210000000,
        "circulatingSupply": 122090000,
        "totalSupply": 122090000,
        "ath": 4891.7,
        "atl": 0.432979,
        "high24h": 2701.3,
        "low24h": 2618.9,
        "lastUpdated": "2026-09-28T14:02:00Z",
        "createdUtc": 1438269973,
        "marketPairCount": 9214,
        "active": true,
        "volume7d": 98400000000,
        "volume30d": 412000000000,
        "fullyDilutedMarketCap": 325340000000,
        "dominance": 11.44,
        "turnover": 0.0468,
        "percentChange1h": 0.38,
        "percentChange24h": 0.42,
        "percentChange7d": -2.59,
        "percentChange30d": 3.4,
        "percentChange90d": 9.7,
        "percentChange1y": 28.1,
        "percentChangeYtd": 12.6
      },
      {
        "id": "825",
        "name": "Tether",
        "symbol": "USDT",
        "slug": "tether",
        "price": 0.9994,
        "marketCap": 183770000000,
        "volume24h": 88040000000,
        "circulatingSupply": 183870000000,
        "totalSupply": 184200000000,
        "ath": 1.32,
        "atl": 0.572521,
        "high24h": 1.0006,
        "low24h": 0.9989,
        "lastUpdated": "2026-09-28T14:02:00Z",
        "createdUtc": 1411862400,
        "marketPairCount": 84213,
        "active": true,
        "volume7d": 612000000000,
        "volume30d": 2610000000000,
        "fullyDilutedMarketCap": 184090000000,
        "dominance": 6.49,
        "turnover": 0.4791,
        "percentChange1h": -0.01,
        "percentChange24h": -0.02,
        "percentChange7d": -0.02,
        "percentChange30d": 0.01,
        "percentChange90d": 0.03,
        "percentChange1y": -0.08,
        "percentChangeYtd": -0.05
      }
    ]
  }
}

Full parameter and response reference - every field, type, and example for this endpoint.

Reference

One request, one response shape.

Every field you send and every field you get back, each with a real example.

Last verified 2026-10-31 · uptime and latency measured over 30d

Request body

JSON, posted to this endpoint.

  • limitinteger

    3

    Maximum number of results to return (1-25, default 25). You are billed per result returned, so a lower limit costs less.

You send. A small JSON body. The values shown are examples to replace with your own.

Response

JSON, one example value per field.

each itemdata.items[]

Cryptocurrency listing records: rank, name, symbol, price, market cap, trading volume, and 24h price change. Populated whenever the provider has data for the entity.

  • activeboolean

    true

    Whether CoinMarketCap still tracks the coin as active.

  • athnumber

    108786.5

    All-time high price in USD.

  • atlnumber

    0.04865

    All-time low price in USD.

  • circulatingSupplynumber

    20090000

    Circulating supply (coin count).

  • createdUtcnumber

    1231006505

    When CoinMarketCap first listed the coin. UTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.

  • dominancenumber

    58.7

    Share of total crypto market capitalization, in percent.

  • fullyDilutedMarketCapnumber

    1744000000000

    Fully diluted market capitalization in USD (total supply at the current price).

  • high24hnumber

    84120.75

    24h high price in USD.

  • idstring

    1

    CoinMarketCap identifier. Populated whenever the provider has data for the entity.

  • lastUpdatedstring

    2026-09-28T14:02:00Z

    Populated whenever the provider has data for the entity.

  • low24hnumber

    81900.2

    24h low price in USD.

  • marketCapnumber

    1660000000000

    Market capitalization in USD.

  • marketPairCountinteger

    11842

    Number of exchange market pairs trading this coin.

  • namestring

    Bitcoin

    Populated whenever the provider has data for the entity.

  • percentChange1hnumber

    0.15

    Price change over the last hour, in percent.

  • percentChange1ynumber

    41.8

    Price change over the last year, in percent.

  • percentChange24hnumber

    -0.42

    Price change over the last 24 hours, in percent.

  • percentChange30dnumber

    6.1

    Price change over the last 30 days, in percent.

  • percentChange60dnumber

    Price change over the last 60 days, in percent.

  • percentChange7dnumber

    -2.92

    Price change over the last 7 days, in percent.

  • percentChange90dnumber

    14.3

    Price change over the last 90 days, in percent.

  • percentChangeYtdnumber

    22.4

    Price change year to date, in percent.

  • pricenumber

    83050.5

    Latest price in USD.

  • selfReportedCirculatingSupplynumber

    Circulating supply as reported by the project itself (coin count).

  • slugstring

    bitcoin

    Populated whenever the provider has data for the entity.

  • symbolstring

    BTC

    Populated whenever the provider has data for the entity.

  • totalSupplynumber

    21000000

    Total supply (coin count).

  • turnovernumber

    0.0239

    24h trading volume divided by market capitalization.

  • volume24hnumber

    39680000000

    24h trading volume in USD.

  • volume30dnumber

    1120000000000

    30-day trading volume in USD.

  • volume7dnumber

    268000000000

    7-day trading volume in USD.

top level
  • foundboolean

    true

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

You get back. Named, typed fields in the same shape whichever source answers.

FAQ

About the CoinMarketCap Listings API

The AnyAPI CoinMarketCap Listings API returns CoinMarketCap listings data as normalized JSON from one POST call to /v1/run/coinmarketcap.listings. Get the current top cryptocurrencies from CoinMarketCap (rank, price, market cap, volume, and 24h change) as normalized JSON. AnyAPI returns one normalized schema whichever source serves it. It costs $1.98 per 1,000 results, and never more than $0.0495 for a single request, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 100.0% of CoinMarketCap listings calls through AnyAPI succeeded, with a median response time of 12.8 seconds across 16 measured calls.

It costs $1.98 per 1,000 results, and never more than $0.0495 for a single request, in US dollars with no subscription and no monthly minimum. You fund one USD wallet and each call draws it down. Some failed wallet-funded requests incur processing charges that we pass through at cost, with no markup; the error response shows the amount charged.

Get the current top cryptocurrencies from CoinMarketCap (rank, price, market cap, volume, and 24h change) as normalized JSON. The response is normalized JSON with the same envelope every AnyAPI endpoint returns, so parsing a second endpoint is a change of URL and nothing else.

Over the last 30 days, 100.0% of CoinMarketCap listings calls through AnyAPI succeeded, with a median response time of 12.8 seconds across 16 measured calls. These are AnyAPI's own measurements of traffic through the gateway, recomputed continuously, not a published service-level target.

Yes. A new AnyAPI account starts with $0.10 of free balance and no card required, which covers at least 2 CoinMarketCap Listings calls at up to $0.0495 each.

Send a POST request to https://api.getanyapi.com/v1/run/coinmarketcap.listings with your AnyAPI key in an "Authorization: Bearer" header and the input as a JSON body. The same key and the same wallet work on every AnyAPI endpoint.

No. You add US dollars to one prepaid AnyAPI balance and each request draws it down. There is no monthly plan and no minimum, and the same balance pays for every AnyAPI endpoint.

Yes. Install @getanyapi/sdk from npm for TypeScript or getanyapi from pip for Python. Both call every AnyAPI endpoint with the same key, and any HTTP client works too.

Yes. An agent can connect to the AnyAPI MCP server at https://api.getanyapi.com/mcp, or create its own free-trial key with one unauthenticated POST to https://api.getanyapi.com/agent/signup and call this endpoint over HTTP.