Coin Historical Data by ID

A one-day snapshot of a coin’s price, market cap and volume for a specific calendar date.

GET https://api.aisa.one/apis/v1/coingecko/coins/{id}/history

Coin Historical Data by ID

cURL

curl --request GET \
  --url https://api.aisa.one/apis/v1/coingecko/coins/{id}/history \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "bitcoin",
  "symbol": "btc",
  "name": "Bitcoin",
  "localization": {
    "en": "Bitcoin",
    "zh": "比特币",
    "zh-tw": "比特幣",
    "de": "Bitcoin",
    "fr": "Bitcoin",
    "es": "Bitcoin",
    "ja": "ビットコイン",
    "id": "Bitcoin",
    "ru": "Биткоин",
    "ko": "비트코인",
    "ar": "بيتكوين",
    "th": "บิตคอยน์",
    "vi": "Bitcoin",
    "it": "Bitcoin",
    "pl": "Bitcoin",
    "tr": "Bitcoin",
    "hu": "Bitcoin",
    "nl": "Bitcoin",
    "ro": "Bitcoin",
    "sv": "Bitcoin",
    "cs": "Bitcoin",
    "da": "Bitcoin",
    "el": "Bitcoin",
    "hi": "Bitcoin",
    "no": "Bitcoin",
    "sk": "Bitcoin",
    "uk": "Bitcoin",
    "he": "Bitcoin",
    "fi": "Bitcoin",
    "bg": "Bitcoin",
    "hr": "Bitcoin",
    "lt": "Bitcoin",
    "sl": "Bitcoin",
    "pt": "Bitcoin"
  },
  "image": {
    "thumb": "https://coin-images.coingecko.com/coins/images/1/thumb/bitcoin.png?1696501400",
    "small": "https://coin-images.coingecko.com/coins/images/1/small/bitcoin.png?1696501400"
  },
  "market_data": {
    "current_price": {
      "aed": 155021.01870663263,
      "ars": 34223222.03038811,
      "aud": 61961.64079464181,
      "bch": 162.9444394169128,
      "bdt": 4640974.295329716,
      "bhd": 15935.706731619232,
      "bmd": 42208.202176186474,
      "bnb": 135.24654224991627,
      "brl": 204813.86598107114,
      "btc": 1,
      "cad": 55925.65684243621,
      "chf": 35496.88698916195,
      "clp": 37196103.56833302,
      "cny": 298785.10989287664,
      "czk": 944615.3438828368,
      "dkk": 285068.92147269147,
      "dot": 5160.299955562896,
      "eos": 50098.037591566885,
      "eth": 18.514283305187227,
      "eur": 38240.20908960317,
      "gbp": 33156.484386694596,
      "gel": 113329.02284306048,
      "hkd": 329606.38328597124,
      "huf": 14657368.01641012,
      "idr": 649885162.0865278,
      "ils": 152105.57155771676,
      "inr": 3513053.119048727,
      "jpy": 5952559.440604322,
      "krw": 54661344.54593342,
      "kwd": 12984.298194449415,
      "lkr": 13696906.151726862,
      "ltc": 579.0962960970021,
      "mmk": 88806742.41781776,
      "mxn": 716452.3647481233,
      "myr": 194052.20950501712,
      "ngn": 37886364.22413555,
      "nok": 429442.7101393702,
      "nzd": 66802.583918633,
      "php": 2338503.1911612307,
      "pkr": 11792242.372501094,
      "pln": 165880.09171330827,
      "rub": 3767047.138041446,
      "sar": 158357.45046405343,
      "sek": 425811.11642413173,
      "sgd": 55694.77797653248,
      "sol": 416.5289478886034,
      "thb": 1453127.860988517,
      "try": 1243001.417432343,
      "twd": 1295461.9075007213,
      "uah": 1607901.3285893872,
      "usd": 42208.202176186474,
      "vef": 4226.30728390156,
      "vnd": 1024346748.4635574,
      "xag": 1773.9385614394023,
      "xau": 20.435523165622502,
      "xdr": 31508.676173736272,
      "xlm": 327801.5907899002,
      "xrp": 68792.39040895543,
      "yfi": 5.23330767599715,
      "zar": 772207.5004537676,
      "bits": 999797.6500840397,
      "link": 2828.6459350540995,
      "sats": 99979765.00840396
    },
    "market_cap": {
      "aed": 3039570628249.035,
      "ars": 671030943774608.1,
      "aud": 1214911274669.9553,
      "bch": 3192400331.4673758,
      "bdt": 90997783863352.8,
      "bhd": 312458958958.8847,
      "bmd": 827596236151.1959,
      "bnb": 2647323702.8955383,
      "brl": 4015882597651.6562,
      "btc": 19586150,
      "cad": 1096560874919.1543,
      "chf": 696004296621.9747,
      "clp": 729321641896660.1,
      "cny": 5858421340316.535,
      "czk": 18521521005440.16,
      "dkk": 5589481529435.656,
      "dot": 101067225072.82333,
      "eos": 981764701266.0074,
      "eth": 362734483.2978319,
      "eur": 749793913990.623,
      "gbp": 650114912923.6271,
      "gel": 2222095894065.9663,
      "hkd": 6462748663878.865,
      "huf": 287393965552690.7,
      "idr": 12742606563251504,
      "ils": 2982406073429.352,
      "inr": 68882098474316.74,
      "jpy": 116714655790049.02,
      "krw": 1071770904156178.4,
      "kwd": 254589292146.01266,
      "lkr": 268561734299139.16,
      "ltc": 11369266145.87004,
      "mmk": 1741275912749029.8,
      "mxn": 14047821273508.254,
      "myr": 3804873695705.123,
      "ngn": 742855909912170.9,
      "nok": 8420286869134.373,
      "nzd": 1309829942186.6091,
      "php": 45852141040124.65,
      "pkr": 231216088345279.94,
      "pln": 3252489622308.595,
      "rub": 73862279654407,
      "sar": 3104989627928.0786,
      "sek": 8349080488975.917,
      "sgd": 1092033923507.4076,
      "sol": 8167080608.685882,
      "thb": 28493545024184.4,
      "try": 24372118250940.145,
      "twd": 25400735957660.043,
      "uah": 31526883852775.1,
      "usd": 827596236151.1959,
      "vef": 82867211125.81927,
      "vnd": 20084852465487144,
      "xag": 34782454615.8709,
      "xau": 400688993.6949639,
      "xdr": 617805555864.2843,
      "xlm": 6420377180809.443,
      "xrp": 1347730925908.2449,
      "yfi": 102656498.40039586,
      "zar": 15141038659633.365,
      "bits": 19587615789973.43,
      "link": 55342736984.57576,
      "sats": 1958761578997342.8
    },
    "total_volume": {
      "aed": 52093574029.40443,
      "ars": 11500440167656.37,
      "aud": 20821714040.129295,
      "bch": 54756176.21574547,
      "bdt": 1559562309933.2505,
      "bhd": 5355066850.034618,
      "bmd": 14183728910.169804,
      "bnb": 45448519.30208316,
      "brl": 68826062289.8161,
      "btc": 335974.0074837291,
      "cad": 18793369887.330444,
      "chf": 11928445094.808254,
      "clp": 12499453241945.738,
      "cny": 100404347558.46667,
      "czk": 317430434636.70953,
      "dkk": 95795132093.1731,
      "dot": 1734077546.3343449,
      "eos": 16835045026.655567,
      "eth": 6221576.893294353,
      "eur": 12850316555.324738,
      "gbp": 11141971510.468252,
      "gel": 38083312123.805855,
      "hkd": 110761590083.25078,
      "huf": 4925491344396.748,
      "idr": 218388713248196.1,
      "ils": 51113861322.39222,
      "inr": 1180533415747.48,
      "jpy": 2000310012607.8845,
      "krw": 18368507847565.402,
      "kwd": 4363269605.991003,
      "lkr": 4602735813129.19,
      "ltc": 194600680.75008962,
      "mmk": 29842795828917.508,
      "mxn": 240758089534.80554,
      "myr": 65209693664.5056,
      "ngn": 12731409817077.545,
      "nok": 144310789586.34262,
      "nzd": 22448474276.294495,
      "php": 785835302355.318,
      "pkr": 3962688776849.6025,
      "pln": 55742678701.03927,
      "rub": 1265886075288.8472,
      "sar": 53214755248.56654,
      "sek": 143090421550.91183,
      "sgd": 18715784890.19182,
      "sol": 139971223.0203305,
      "thb": 488312000734.88245,
      "try": 417700689222.06055,
      "twd": 435329617517.0529,
      "uah": 540322387194.22906,
      "usd": 14183728910.169804,
      "vef": 1420216775.7753053,
      "vnd": 344223535737756.94,
      "xag": 596117871.9180025,
      "xau": 6867194.189147832,
      "xdr": 10588238733.815224,
      "xlm": 110155103993.25989,
      "xrp": 23117132839.969418,
      "yfi": 1758611.2071300931,
      "zar": 259494157157.33887,
      "bits": 335974007483.7291,
      "link": 950543853.0214615,
      "sats": 33597400748372.91
    }
  },
  "public_interest_stats": {
    "alexa_rank": null,
    "bing_matches": null
  }
}

A snapshot of one coin on a single calendar day. date is required and must be formatted dd-mm-yyyy (day, month, four-digit year). Returns market_data holding current_price, market_cap and total_volume as of that day, alongside community_data, developer_data and public_interest_stats. Use it for one fixed point in time. For a continuous series use get_coingecko_coins_id_market_chart for a trailing window, or get_coingecko_coins_id_market_chart_range for an explicit one.

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 →

Request contract

• Method and path: GET /apis/v1/coingecko/coins/{id}/history
• Request URL template: https://api.aisa.one/apis/v1/coingecko/coins/{id}/history
• id: path; required
• date: query; required
• localization: query; optional
• Runtime facts: 2cebdc98d47ae0d3c355af637caf87081b8a62f7794a0c3667fcd49e4539823e

Complete OpenAPI definition

Effective request and pricing declaration (including authentication and referenced schemas):

{
  "operationId": "get_coingecko_coins_id_history",
  "method": "GET",
  "path": "/apis/v1/coingecko/coins/{id}/history",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [
    {
      "name": "id",
      "in": "path",
      "required": true,
      "description": "Coin ID. \n*refers to [`/coins/list`](/reference/coins-list).",
      "schema": {
        "type": "string",
        "default": "bitcoin"
      }
    },
    {
      "name": "date",
      "in": "query",
      "required": true,
      "description": "The date of data snapshot. \nFormat: `YYYY-MM-DD`",
      "schema": {
        "type": "string",
        "default": "2025-12-30"
      }
    },
    {
      "name": "localization",
      "in": "query",
      "required": false,
      "description": "Include all the localized languages in response. \nDefault: true",
      "schema": {
        "type": "boolean"
      }
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "x-aisa-pricing": {
    "cost_contract": "plan_units",
    "customer_pricing": "fixed_success",
    "default_request_estimate_usd": 0.008,
    "estimate_source": "profile_seed",
    "evidence_source": "request_snapshot",
    "request_cost_drivers": {
      "kind": "plan_units",
      "formula": {
        "fixed_units": 1
      },
      "inputs": []
    },
    "unit": "provider_credit",
    "unit_rate_usd": 0.0
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

Cost and request rules

Published reference price: $0.008 USD per successful request. Declared unit rate:$0 USD per provider_credit. Account-specific pricing and final settlement may differ.

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.

Path Parameters

id · string · default: bitcoin · required

Coin ID. *refers to /coins/list.

Query Parameters

date · string · default: 2025-12-30 · required

The date of data snapshot. Format: YYYY-MM-DD

localization · boolean

Include all the localized languages in response. Default: true

Response

200

application/json

Coin historical data

id · string · required

Coin ID

symbol · string · required

Coin symbol

name · string · required

Coin name

image · object · required

Coin image URLs

Show child attributes

market_data · object · required

Market data at the given date

Show child attributes

public_interest_stats · object · required

Public interest statistics

Show child attributes

localization · object

Localized coin names keyed by locale code

Show child attributes