# Fixed reference example. Playground inputs do not update this sample.
curl --request GET \
--url https://api.aisa.one/apis/v1/coingecko/coins/bitcoin \
--header 'Authorization: Bearer <token>'curl --request GET \
--url https://api.aisa.one/apis/v1/coingecko/coins/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aisa.one/apis/v1/coingecko/coins/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aisa.one/apis/v1/coingecko/coins/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/coingecko/coins/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/coingecko/coins/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aisa.one/apis/v1/coingecko/coins/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/coingecko/coins/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"additional_notices": [],
"asset_platform_id": null,
"block_time_in_minutes": 10,
"categories": [
"Cryptocurrency",
"Layer 1 (L1)"
],
"country_origin": "",
"description": {
"en": "Bitcoin is the first successful internet money based on peer-to-peer technology..."
},
"detail_platforms": {
"": {
"contract_address": "",
"decimal_place": null
}
},
"genesis_date": "2009-01-03",
"has_supply_breakdown": false,
"hashing_algorithm": "SHA-256",
"id": "bitcoin",
"image": {
"large": "https://assets.coingecko.com/coins/images/1/large/bitcoin.png?1696501400",
"small": "https://assets.coingecko.com/coins/images/1/small/bitcoin.png?1696501400",
"thumb": "https://assets.coingecko.com/coins/images/1/thumb/bitcoin.png?1696501400"
},
"last_updated": "2024-04-07T15:24:51.021Z",
"links": {
"announcement_url": [
"",
""
],
"bitcointalk_thread_identifier": null,
"blockchain_site": [
"https://mempool.space/",
"https://blockchair.com/bitcoin/"
],
"chat_url": [
""
],
"facebook_username": "bitcoins",
"homepage": [
"http://www.bitcoin.org",
"",
""
],
"official_forum_url": [
"https://bitcointalk.org/"
],
"repos_url": {
"bitbucket": [],
"github": [
"https://github.com/bitcoin/bitcoin",
"https://github.com/bitcoin/bips"
]
},
"snapshot_url": null,
"subreddit_url": "https://www.reddit.com/r/Bitcoin/",
"telegram_channel_identifier": "",
"twitter_screen_name": "bitcoin",
"whitepaper": "https://bitcoin.org/bitcoin.pdf"
},
"market_cap_rank": 1,
"market_cap_rank_with_rehypothecated": 1,
"market_data": {
"ath": {
"btc": 1.003301,
"eur": 67405,
"usd": 73738
},
"ath_change_percentage": {
"btc": -0.32896,
"eur": -4.54383,
"usd": -5.33399
},
"ath_date": {
"btc": "2024-03-02T16:05:19.446Z",
"eur": "2024-03-14T07:10:36.635Z",
"usd": "2024-03-14T07:10:36.635Z"
},
"atl": {
"btc": 0.99895134,
"eur": 51.3,
"usd": 67.81
},
"atl_change_percentage": {
"btc": 0.10408,
"eur": 125385.41242,
"usd": 102882.36498
},
"atl_date": {
"btc": "2019-10-21T00:00:00.000Z",
"eur": "2013-07-05T00:00:00.000Z",
"usd": "2013-07-06T00:00:00.000Z"
},
"circulating_supply": 19675377,
"current_price": {
"btc": 1,
"eur": 64375,
"usd": 69840
},
"fdv_to_tvl_ratio": null,
"fully_diluted_valuation": {
"btc": 21000000,
"eur": 1351831155,
"usd": 1466577759
},
"high_24h": {
"btc": 1,
"eur": 64343,
"usd": 69805
},
"last_updated": "2024-04-07T15:24:51.021Z",
"low_24h": {
"btc": 1,
"eur": 62695,
"usd": 67985
},
"market_cap": {
"btc": 19675377,
"eur": 1265825267281,
"usd": 1373296629498
},
"market_cap_change_24h": 31172487848,
"market_cap_change_24h_in_currency": {
"btc": -49432,
"eur": 28668703539,
"usd": 31172487848
},
"market_cap_change_percentage_24h": 2.32219,
"market_cap_change_percentage_24h_in_currency": {
"btc": -0.25084,
"eur": 2.31801,
"usd": 2.32219
},
"market_cap_fdv_ratio": 1,
"market_cap_rank": 1,
"market_cap_rank_with_rehypothecated": 1,
"max_supply": 21000000,
"max_supply_infinite": false,
"mcap_to_tvl_ratio": null,
"outstanding_supply": null,
"outstanding_token_value_usd": null,
"price_change_24h": 1619,
"price_change_24h_in_currency": {
"btc": 0,
"eur": 1461.64,
"usd": 1618.95
},
"price_change_percentage_14d": 6.36178,
"price_change_percentage_14d_in_currency": {
"btc": 0,
"eur": 5.84662,
"usd": 6.36178
},
"price_change_percentage_1h_in_currency": {
"btc": 0,
"eur": 0.79523,
"usd": 0.79523
},
"price_change_percentage_1y": 149.76989,
"price_change_percentage_1y_in_currency": {
"btc": 0,
"eur": 138.20277,
"usd": 149.76989
},
"price_change_percentage_200d": 157.51875,
"price_change_percentage_200d_in_currency": {
"btc": 0,
"eur": 148.68948,
"usd": 157.51875
},
"price_change_percentage_24h": 2.37311,
"price_change_percentage_24h_in_currency": {
"btc": 0,
"eur": 2.32219,
"usd": 2.37311
},
"price_change_percentage_30d": 1.81171,
"price_change_percentage_30d_in_currency": {
"btc": 0,
"eur": 2.28048,
"usd": 1.81171
},
"price_change_percentage_60d": 62.54292,
"price_change_percentage_60d_in_currency": {
"btc": 0,
"eur": 60.98834,
"usd": 62.54292
},
"price_change_percentage_7d": -0.89706,
"price_change_percentage_7d_in_currency": {
"btc": 0,
"eur": -1.01955,
"usd": -0.89706
},
"roi": null,
"total_supply": 21000000,
"total_value_locked": null,
"total_volume": {
"btc": 270165,
"eur": 17368113665,
"usd": 18867210007
}
},
"name": "Bitcoin",
"platforms": {
"": ""
},
"preview_listing": false,
"public_notice": null,
"sentiment_votes_down_percentage": 15.93,
"sentiment_votes_up_percentage": 84.07,
"status_updates": [],
"symbol": "btc",
"tickers": [
{
"base": "BTC",
"bid_ask_spread_percentage": 0.010014,
"coin_id": "bitcoin",
"coin_mcap_usd": 230926944910.5146,
"converted_last": {
"btc": 0.99999255,
"eth": 20.441016,
"usd": 69835
},
"converted_volume": {
"btc": 19783,
"eth": 404380,
"usd": 1381537193
},
"is_anomaly": false,
"is_stale": false,
"last": 69816,
"last_fetch_at": "2024-04-07T15:24:00+00:00",
"last_traded_at": "2024-04-07T15:23:02+00:00",
"market": {
"has_trading_incentive": false,
"identifier": "binance",
"name": "Binance"
},
"target": "USDT",
"target_coin_id": "tether",
"timestamp": "2024-04-07T15:23:02+00:00",
"token_info_url": null,
"trade_url": "https://www.binance.com/en/trade/BTC_USDT?ref=37754157",
"trust_score": null,
"volume": 19988.82111
}
],
"watchlist_portfolio_users": 1541900,
"web_slug": "bitcoin"
}Coin Data by ID
Everything CoinGecko holds on one coin: profile, links, categories, contract addresses and full market data.
# Fixed reference example. Playground inputs do not update this sample.
curl --request GET \
--url https://api.aisa.one/apis/v1/coingecko/coins/bitcoin \
--header 'Authorization: Bearer <token>'curl --request GET \
--url https://api.aisa.one/apis/v1/coingecko/coins/{id} \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.aisa.one/apis/v1/coingecko/coins/{id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.aisa.one/apis/v1/coingecko/coins/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.aisa.one/apis/v1/coingecko/coins/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.aisa.one/apis/v1/coingecko/coins/{id}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.aisa.one/apis/v1/coingecko/coins/{id}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.aisa.one/apis/v1/coingecko/coins/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"additional_notices": [],
"asset_platform_id": null,
"block_time_in_minutes": 10,
"categories": [
"Cryptocurrency",
"Layer 1 (L1)"
],
"country_origin": "",
"description": {
"en": "Bitcoin is the first successful internet money based on peer-to-peer technology..."
},
"detail_platforms": {
"": {
"contract_address": "",
"decimal_place": null
}
},
"genesis_date": "2009-01-03",
"has_supply_breakdown": false,
"hashing_algorithm": "SHA-256",
"id": "bitcoin",
"image": {
"large": "https://assets.coingecko.com/coins/images/1/large/bitcoin.png?1696501400",
"small": "https://assets.coingecko.com/coins/images/1/small/bitcoin.png?1696501400",
"thumb": "https://assets.coingecko.com/coins/images/1/thumb/bitcoin.png?1696501400"
},
"last_updated": "2024-04-07T15:24:51.021Z",
"links": {
"announcement_url": [
"",
""
],
"bitcointalk_thread_identifier": null,
"blockchain_site": [
"https://mempool.space/",
"https://blockchair.com/bitcoin/"
],
"chat_url": [
""
],
"facebook_username": "bitcoins",
"homepage": [
"http://www.bitcoin.org",
"",
""
],
"official_forum_url": [
"https://bitcointalk.org/"
],
"repos_url": {
"bitbucket": [],
"github": [
"https://github.com/bitcoin/bitcoin",
"https://github.com/bitcoin/bips"
]
},
"snapshot_url": null,
"subreddit_url": "https://www.reddit.com/r/Bitcoin/",
"telegram_channel_identifier": "",
"twitter_screen_name": "bitcoin",
"whitepaper": "https://bitcoin.org/bitcoin.pdf"
},
"market_cap_rank": 1,
"market_cap_rank_with_rehypothecated": 1,
"market_data": {
"ath": {
"btc": 1.003301,
"eur": 67405,
"usd": 73738
},
"ath_change_percentage": {
"btc": -0.32896,
"eur": -4.54383,
"usd": -5.33399
},
"ath_date": {
"btc": "2024-03-02T16:05:19.446Z",
"eur": "2024-03-14T07:10:36.635Z",
"usd": "2024-03-14T07:10:36.635Z"
},
"atl": {
"btc": 0.99895134,
"eur": 51.3,
"usd": 67.81
},
"atl_change_percentage": {
"btc": 0.10408,
"eur": 125385.41242,
"usd": 102882.36498
},
"atl_date": {
"btc": "2019-10-21T00:00:00.000Z",
"eur": "2013-07-05T00:00:00.000Z",
"usd": "2013-07-06T00:00:00.000Z"
},
"circulating_supply": 19675377,
"current_price": {
"btc": 1,
"eur": 64375,
"usd": 69840
},
"fdv_to_tvl_ratio": null,
"fully_diluted_valuation": {
"btc": 21000000,
"eur": 1351831155,
"usd": 1466577759
},
"high_24h": {
"btc": 1,
"eur": 64343,
"usd": 69805
},
"last_updated": "2024-04-07T15:24:51.021Z",
"low_24h": {
"btc": 1,
"eur": 62695,
"usd": 67985
},
"market_cap": {
"btc": 19675377,
"eur": 1265825267281,
"usd": 1373296629498
},
"market_cap_change_24h": 31172487848,
"market_cap_change_24h_in_currency": {
"btc": -49432,
"eur": 28668703539,
"usd": 31172487848
},
"market_cap_change_percentage_24h": 2.32219,
"market_cap_change_percentage_24h_in_currency": {
"btc": -0.25084,
"eur": 2.31801,
"usd": 2.32219
},
"market_cap_fdv_ratio": 1,
"market_cap_rank": 1,
"market_cap_rank_with_rehypothecated": 1,
"max_supply": 21000000,
"max_supply_infinite": false,
"mcap_to_tvl_ratio": null,
"outstanding_supply": null,
"outstanding_token_value_usd": null,
"price_change_24h": 1619,
"price_change_24h_in_currency": {
"btc": 0,
"eur": 1461.64,
"usd": 1618.95
},
"price_change_percentage_14d": 6.36178,
"price_change_percentage_14d_in_currency": {
"btc": 0,
"eur": 5.84662,
"usd": 6.36178
},
"price_change_percentage_1h_in_currency": {
"btc": 0,
"eur": 0.79523,
"usd": 0.79523
},
"price_change_percentage_1y": 149.76989,
"price_change_percentage_1y_in_currency": {
"btc": 0,
"eur": 138.20277,
"usd": 149.76989
},
"price_change_percentage_200d": 157.51875,
"price_change_percentage_200d_in_currency": {
"btc": 0,
"eur": 148.68948,
"usd": 157.51875
},
"price_change_percentage_24h": 2.37311,
"price_change_percentage_24h_in_currency": {
"btc": 0,
"eur": 2.32219,
"usd": 2.37311
},
"price_change_percentage_30d": 1.81171,
"price_change_percentage_30d_in_currency": {
"btc": 0,
"eur": 2.28048,
"usd": 1.81171
},
"price_change_percentage_60d": 62.54292,
"price_change_percentage_60d_in_currency": {
"btc": 0,
"eur": 60.98834,
"usd": 62.54292
},
"price_change_percentage_7d": -0.89706,
"price_change_percentage_7d_in_currency": {
"btc": 0,
"eur": -1.01955,
"usd": -0.89706
},
"roi": null,
"total_supply": 21000000,
"total_value_locked": null,
"total_volume": {
"btc": 270165,
"eur": 17368113665,
"usd": 18867210007
}
},
"name": "Bitcoin",
"platforms": {
"": ""
},
"preview_listing": false,
"public_notice": null,
"sentiment_votes_down_percentage": 15.93,
"sentiment_votes_up_percentage": 84.07,
"status_updates": [],
"symbol": "btc",
"tickers": [
{
"base": "BTC",
"bid_ask_spread_percentage": 0.010014,
"coin_id": "bitcoin",
"coin_mcap_usd": 230926944910.5146,
"converted_last": {
"btc": 0.99999255,
"eth": 20.441016,
"usd": 69835
},
"converted_volume": {
"btc": 19783,
"eth": 404380,
"usd": 1381537193
},
"is_anomaly": false,
"is_stale": false,
"last": 69816,
"last_fetch_at": "2024-04-07T15:24:00+00:00",
"last_traded_at": "2024-04-07T15:23:02+00:00",
"market": {
"has_trading_incentive": false,
"identifier": "binance",
"name": "Binance"
},
"target": "USDT",
"target_coin_id": "tether",
"timestamp": "2024-04-07T15:23:02+00:00",
"token_info_url": null,
"trade_url": "https://www.binance.com/en/trade/BTC_USDT?ref=37754157",
"trust_score": null,
"volume": 19988.82111
}
],
"watchlist_portfolio_users": 1541900,
"web_slug": "bitcoin"
}id: description, links, image, categories, platforms and detail_platforms (contract addresses per chain), market_cap_rank, and a market_data block carrying current_price, market_cap, total_volume, fully_diluted_valuation, ath and atl with dates and change percentages. The heavy sections are opt-in via market_data, community_data, developer_data, tickers, sparkline and localization — leave them off unless needed, the full payload is large. Use it for a coin profile. For a price table across many coins use get_coingecko_coins_markets; to look the same coin up by contract address use get_coingecko_token_data.
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 a few meta tools: search,
list_categories, get_details and batch_quote are free, batch_use is
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.Request contract
- Method and path: GET /apis/v1/coingecko/coins/{id}
- Availability: enabled
- Request URL template: https://api.aisa.one/apis/v1/coingecko/coins/{id}
- id: path; required
- community_data: query; optional
- developer_data: query; optional
- dex_pair_format: query; optional
- include_categories_details: query; optional
- localization: query; optional
- market_data: query; optional
- sparkline: query; optional
- tickers: query; optional
- Runtime facts: 2cebdc98d47ae0d3c355af637caf87081b8a62f7794a0c3667fcd49e4539823e
{
"operationId": "get_coingecko_coins_id",
"method": "GET",
"path": "/apis/v1/coingecko/coins/{id}",
"servers": [
{
"url": "https://api.aisa.one"
}
],
"parameters": [
{
"description": "Coin ID. \n*refers to [`/coins/list`](/reference/coins-list)",
"in": "path",
"name": "id",
"required": true,
"schema": {
"default": "bitcoin",
"example": "bitcoin",
"type": "string"
}
},
{
"deprecated": true,
"description": "Include community data. \nDeprecated: has no effect as of 28 August 2026; the `community_data` object is no longer returned.",
"in": "query",
"name": "community_data",
"required": false,
"schema": {
"type": "boolean"
}
},
{
"deprecated": true,
"description": "Include developer data. \nDeprecated: has no effect as of 28 August 2026; the `developer_data` object is no longer returned.",
"in": "query",
"name": "developer_data",
"required": false,
"schema": {
"type": "boolean"
}
},
{
"description": "Set to `symbol` to display DEX pair base and target as symbols. \nDefault: `contract_address`",
"in": "query",
"name": "dex_pair_format",
"required": false,
"schema": {
"enum": [
"contract_address",
"symbol"
],
"type": "string"
}
},
{
"description": "Include categories details. \nDefault: false",
"in": "query",
"name": "include_categories_details",
"required": false,
"schema": {
"type": "boolean"
}
},
{
"description": "Include all localized languages in the response. \nDefault: true",
"in": "query",
"name": "localization",
"required": false,
"schema": {
"type": "boolean"
}
},
{
"description": "Include market data. \nDefault: true",
"in": "query",
"name": "market_data",
"required": false,
"schema": {
"type": "boolean"
}
},
{
"description": "Include sparkline 7-day data. \nDefault: false",
"in": "query",
"name": "sparkline",
"required": false,
"schema": {
"type": "boolean"
}
},
{
"description": "Include tickers data. \nDefault: true",
"in": "query",
"name": "tickers",
"required": false,
"schema": {
"type": "boolean"
}
}
],
"security": [
{
"bearerAuth": []
}
],
"x-aisa-status": "enabled",
"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": {
"formula": {
"fixed_units": 1
},
"inputs": [],
"kind": "plan_units"
},
"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
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Coin ID.
*refers to /coins/list
"bitcoin"
Query Parameters
Include community data.
Deprecated: has no effect as of 28 August 2026; the community_data object is no longer returned.
Include developer data.
Deprecated: has no effect as of 28 August 2026; the developer_data object is no longer returned.
Set to symbol to display DEX pair base and target as symbols.
Default: contract_address
contract_address, symbol Include categories details. Default: false
Include all localized languages in the response. Default: true
Include market data. Default: true
Include sparkline 7-day data. Default: false
Include tickers data. Default: true
Response
Coin data
Additional notices
Coin asset platform ID
Blockchain block time in minutes
Coin categories
Country of origin
Coin description
Show child attributes
Show child attributes
Detailed coin asset platform and contract address
Show child attributes
Show child attributes
Genesis date
Whether detailed supply breakdown data is available via /coins/supply_breakdown
Blockchain hashing algorithm
Coin ID
Coin image URL
Show child attributes
Show child attributes
Last updated timestamp
Links
Show child attributes
Show child attributes
Market cap rank
Market cap rank including rehypothecated tokens
Coin name
Coin asset platform and contract address
Show child attributes
Show child attributes
Preview listing coin
Public notice
Sentiment votes down percentage
Sentiment votes up percentage
Status updates
Show child attributes
Show child attributes
Coin symbol
Number of users watching this coin in portfolio
Coin web slug
Detailed coin categories
Show child attributes
Show child attributes
ICO data
Show child attributes
Show child attributes
Coin name localization
Show child attributes
Show child attributes
Market data
Show child attributes
Show child attributes
Tickers
Show child attributes
Show child attributes