Hunt Townh402
Catalog
CryptoGETlive

Cryptocurrency market listings

List and rank cryptocurrencies with current quotes, supply, volume, and market-cap data.

$0.01
per call
Success
100%
p50 latency
1.75s
p95 latency
1.75s
Calls (30d)
1

Provider contract

Call path
/routes/coinmarketcap-x402/crypto/market-listings
Method
GET
Selected provider
coinmarketcap-x402default
Provider price
$0.01
Settlement
Base USDC · x402 · 5% h402 fee

Quickstart

Both commands call the selected provider directly.

cURL
curl '/routes/coinmarketcap-x402/crypto/market-listings?start=1&limit=100&sort=market_cap&sort_dir=desc&cryptocurrency_type=all&tag=all'
CLI
h402 call 'crypto/market-listings' --provider 'coinmarketcap-x402' --method GET --query '{"start":1,"limit":100,"sort":"market_cap","sort_dir":"desc","cryptocurrency_type":"all","tag":"all"}'

Parameters & live test

pays real USDC

Fill the request fields, quote the exact per-call total, then choose x402 or eligible bonus credit explicitly before sending. Only the selected provider's listed parameters are accepted.

startintegeroptional≥ 1default 1

One-based result offset.

limitintegeroptional1–5000default 100

Maximum number of assets to return.

price_minnumberoptional≥ 0

Minimum USD price.

price_maxnumberoptional≥ 0

Maximum USD price.

market_cap_minnumberoptional≥ 0

Minimum USD market capitalization.

market_cap_maxnumberoptional≥ 0

Maximum USD market capitalization.

volume_24h_minnumberoptional≥ 0

Minimum 24-hour USD volume.

volume_24h_maxnumberoptional≥ 0

Maximum 24-hour USD volume.

circulating_supply_minnumberoptional≥ 0

Minimum circulating supply.

circulating_supply_maxnumberoptional≥ 0

Maximum circulating supply.

percent_change_24h_minnumberoptional

Minimum 24-hour percentage change.

percent_change_24h_maxnumberoptional

Maximum 24-hour percentage change.

convertstringoptional≥ 1 chars

Comma-separated quote currency symbols, up to 120.

e.g.
convert_idstringoptional≥ 1 chars

Comma-separated CoinMarketCap IDs for up to 120 quote currencies. Do not combine with currencies.

e.g.
sortstringoptionaldefault market_cap

Field used to rank the listing.

One of
sort_dirstringoptionaldefault desc

Sort direction.

One of
cryptocurrency_typestringoptionaldefault all

Include all assets, native coins, or platform tokens.

One of
tagstringoptionaldefault all

CoinMarketCap tag filter.

One of
auxstringoptional≥ 1 chars

Comma-separated supplemental fields: num_market_pairs, cmc_rank, date_added, tags, platform, max_supply, circulating_supply, total_supply, market_cap_by_total_supply, volume_24h_reported, volume_7d, volume_7d_reported, volume_30d, volume_30d_reported, or is_market_cap_included_in_calc. Upstream defaults to num_market_pairs,cmc_rank,date_added,tags,platform,max_supply,circulating_supply,total_supply when omitted.

e.g.
GET/routes/coinmarketcap-x402/crypto/market-listings
Request query
{
  "start": 1,
  "limit": 100,
  "sort": "market_cap",
  "sort_dir": "desc",
  "cryptocurrency_type": "all",
  "tag": "all"
}

ResponseExample response
{
  "data": {
    "data": [
      {
        "tags": [
          "mineable",
          "pow",
          "sha-256"
        ],
        "id": 1,
        "name": "Bitcoin",
        "symbol": "BTC",
        "slug": "bitcoin",
        "infinite_supply": false,
        "is_market_cap_included_in_calc": 1,
        "circulating_supply": 20059781,
        "total_supply": 20059781,
        "max_supply": 21000000,
        "date_added": "2010-07-13T00:00:00.000Z",
        "num_market_pairs": 12670,
        "cmc_rank": 1,
        "last_updated": "2026-07-22T15:05:00.000Z",
        "tvl_ratio": null,
        "platform": null,
        "self_reported_circulating_supply": null,
        "self_reported_market_cap": null,
        "minted_market_cap": 1321619152285.54,
        "quote": [
          {
            "id": 2781,
            "symbol": "USD",
            "price": 65884.02696348201,
            "volume_24h": 30346010444.841263,
            "volume_24h_reported": 133670211626.9792,
            "volume_7d": 225378735485.1229,
            "volume_7d_reported": 1369463916692.4893,
            "volume_30d": 959868748422.6667,
            "volume_30d_reported": 6032882425082.083,
            "volume_change_24h": -3.2096,
            "cex_volume_24h": 30322270812.27118,
            "dex_volume_24h": 23739632.57008435,
            "percent_change_1h": -0.16042732,
            "percent_change_24h": -1.12062795,
            "percent_change_7d": 0.86308992,
            "percent_change_30d": 1.49038644,
            "percent_change_60d": -12.66997457,
            "percent_change_90d": -15.62786919,
            "market_cap": 1321619152285.5442,
            "market_cap_dominance": 58.9276,
            "fully_diluted_market_cap": 1383564566233.12,
            "minted_market_cap": 1321619152285.54,
            "tvl": null,
            "market_cap_by_total_supply": 1321619152285.5442,
            "last_updated": "2026-07-22T15:05:00.000Z"
          }
        ]
      },
      {
        "tags": [
          "pos",
          "smart-contracts",
          "ethereum-ecosystem"
        ],
        "id": 1027,
        "name": "Ethereum",
        "symbol": "ETH",
        "slug": "ethereum",
        "infinite_supply": true,
        "is_market_cap_included_in_calc": 1,
        "circulating_supply": 120682775.72411153,
        "total_supply": 120682775.72411153,
        "max_supply": null,
        "date_added": "2015-08-07T00:00:00.000Z",
        "num_market_pairs": 12213,
        "cmc_rank": 2,
        "last_updated": "2026-07-22T15:05:00.000Z",
        "tvl_ratio": null,
        "platform": null,
        "self_reported_circulating_supply": null,
        "self_reported_market_cap": null,
        "minted_market_cap": 233848616299.14,
        "quote": [
          {
            "id": 2781,
            "symbol": "USD",
            "price": 1937.7132726357625,
            "volume_24h": 10283351138.754608,
            "volume_24h_reported": 87004715894.1656,
            "volume_7d": 107903404121.28532,
            "volume_7d_reported": 815011276009.4681,
            "volume_30d": 215127467331.4009,
            "volume_30d_reported": 1622870097363.965,
            "volume_change_24h": -23.7278,
            "cex_volume_24h": 10209400628.860796,
            "dex_volume_24h": 73950509.89380848,
            "percent_change_1h": -0.15125301,
            "percent_change_24h": 0.6667211,
            "percent_change_7d": 0.35217047,
            "percent_change_30d": 10.61855296,
            "percent_change_60d": -6.00299566,
            "percent_change_90d": -16.77511887,
            "market_cap": 233848616299.13583,
            "market_cap_dominance": 10.4255,
            "fully_diluted_market_cap": 233848616299.14,
            "minted_market_cap": 233848616299.14,
            "tvl": null,
            "market_cap_by_total_supply": 233848616299.13583,
            "last_updated": "2026-07-22T15:05:00.000Z"
          }
        ]
      },
      {
        "tags": [
          "stablecoin",
          "asset-backed-stablecoin",
          "usd-stablecoin"
        ],
        "id": 825,
        "name": "Tether USDt",
        "symbol": "USDT",
        "slug": "tether",
        "infinite_supply": true,
        "is_market_cap_included_in_calc": 1,
        "circulating_supply": 184225794466.3005,
        "total_supply": 189112591384.4109,
        "max_supply": null,
        "date_added": "2015-02-25T00:00:00.000Z",
        "num_market_pairs": 190968,
        "cmc_rank": 3,
        "last_updated": "2026-07-22T15:03:00.000Z",
        "tvl_ratio": null,
        "platform": {
          "id": 1027,
          "slug": "ethereum",
          "name": "Ethereum",
          "symbol": "ETH",
          "token_address": "0xdac17f958d2ee523a2206206994597c13d831ec7"
        },
        "self_reported_circulating_supply": null,
        "self_reported_market_cap": null,
        "minted_market_cap": 189004822452.27,
        "quote": [
          {
            "id": 2781,
            "symbol": "USD",
            "price": 0.9994301334916508,
            "volume_24h": 57733350243.82141,
            "volume_24h_reported": 356115249621.3308,
            "volume_7d": 463384882175.6629,
            "volume_7d_reported": 2512461440306.2095,
            "volume_30d": 3731712193653.8223,
            "volume_30d_reported": 15790496342635.3,
            "volume_change_24h": -8.2342,
            "cex_volume_24h": 56378645402.506584,
            "dex_volume_24h": 1354704841.3148024,
            "percent_change_1h": 0.0144415,
            "percent_change_24h": -0.00432935,
            "percent_change_7d": 0.02631027,
            "percent_change_30d": 0.04908632,
            "percent_change_60d": 0.06407867,
            "percent_change_90d": -0.0794221,
            "market_cap": 184120810356.06015,
            "market_cap_dominance": 8.2179,
            "fully_diluted_market_cap": 189004822452.27,
            "minted_market_cap": 189004822452.27,
            "tvl": null,
            "market_cap_by_total_supply": 189004822452.2738,
            "last_updated": "2026-07-22T15:03:00.000Z"
          }
        ]
      }
    ],
    "status": {
      "timestamp": "2026-07-22T15:05:53.000Z",
      "error_code": "0",
      "error_message": "",
      "elapsed": 1010,
      "credit_count": 1
    }
  },
  "h402": {
    "routeId": "crypto/market-listings",
    "provider": "coinmarketcap-x402",
    "selectedCandidateId": "crypto/market-listings/coinmarketcap-x402",
    "routing": "manual",
    "paidBy": "x402-exact"
  }
}

Providers

Choose a provider for this task. The catalog recommends the current default from quality, reliability, and price; your selected provider stays pinned. Listed prices are provider prices; settlement adds a 5% h402 fee.

coinmarketcap-x402
x402
100
Success
100%
p50
1.75s
Calls
1
100%
$0.01$0.010/call
Last successful call: 14d ago· Aggregated by h402 — not the source provider