Reference example
# 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{
"id": "bitcoin",
"symbol": "btc",
"name": "Bitcoin",
"web_slug": "bitcoin",
"asset_platform_id": null,
"platforms": {
"": ""
},
"detail_platforms": {
"": {
"decimal_place": null,
"contract_address": ""
}
},
"block_time_in_minutes": 10,
"hashing_algorithm": "SHA-256",
"categories": [
"Cryptocurrency",
"Layer 1 (L1)"
],
"preview_listing": false,
"public_notice": null,
"additional_notices": [],
"has_supply_breakdown": false,
"description": {
"en": "Bitcoin is the first successful internet money based on peer-to-peer technology..."
},
"links": {
"homepage": [
"http://www.bitcoin.org",
"",
""
],
"whitepaper": "https://bitcoin.org/bitcoin.pdf",
"blockchain_site": [
"https://mempool.space/",
"https://blockchair.com/bitcoin/"
],
"official_forum_url": [
"https://bitcointalk.org/"
],
"chat_url": [
""
],
"announcement_url": [
"",
""
],
"snapshot_url": null,
"twitter_screen_name": "bitcoin",
"facebook_username": "bitcoins",
"bitcointalk_thread_identifier": null,
"telegram_channel_identifier": "",
"subreddit_url": "https://www.reddit.com/r/Bitcoin/",
"repos_url": {
"github": [
"https://github.com/bitcoin/bitcoin",
"https://github.com/bitcoin/bips"
],
"bitbucket": []
}
},
"image": {
"thumb": "https://assets.coingecko.com/coins/images/1/thumb/bitcoin.png?1696501400",
"small": "https://assets.coingecko.com/coins/images/1/small/bitcoin.png?1696501400",
"large": "https://assets.coingecko.com/coins/images/1/large/bitcoin.png?1696501400"
},
"country_origin": "",
"genesis_date": "2009-01-03",
"sentiment_votes_up_percentage": 84.07,
"sentiment_votes_down_percentage": 15.93,
"watchlist_portfolio_users": 1541900,
"market_cap_rank": 1,
"market_cap_rank_with_rehypothecated": 1,
"status_updates": [],
"last_updated": "2024-04-07T15:24:51.021Z",
"market_data": {
"current_price": {
"btc": 1,
"eur": 64375,
"usd": 69840
},
"total_value_locked": null,
"mcap_to_tvl_ratio": null,
"fdv_to_tvl_ratio": null,
"roi": null,
"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"
},
"market_cap": {
"btc": 19675377,
"eur": 1265825267281,
"usd": 1373296629498
},
"fully_diluted_valuation": {
"btc": 21000000,
"eur": 1351831155,
"usd": 1466577759
},
"market_cap_fdv_ratio": 1,
"market_cap_rank": 1,
"outstanding_token_value_usd": null,
"market_cap_rank_with_rehypothecated": 1,
"total_volume": {
"btc": 270165,
"eur": 17368113665,
"usd": 18867210007
},
"high_24h": {
"btc": 1,
"eur": 64343,
"usd": 69805
},
"low_24h": {
"btc": 1,
"eur": 62695,
"usd": 67985
},
"price_change_24h": 1619,
"price_change_percentage_24h": 2.37311,
"price_change_percentage_7d": -0.89706,
"price_change_percentage_14d": 6.36178,
"price_change_percentage_30d": 1.81171,
"price_change_percentage_60d": 62.54292,
"price_change_percentage_200d": 157.51875,
"price_change_percentage_1y": 149.76989,
"market_cap_change_24h": 31172487848,
"market_cap_change_percentage_24h": 2.32219,
"price_change_24h_in_currency": {
"btc": 0,
"eur": 1461.64,
"usd": 1618.95
},
"price_change_percentage_1h_in_currency": {
"btc": 0,
"eur": 0.79523,
"usd": 0.79523
},
"price_change_percentage_24h_in_currency": {
"btc": 0,
"eur": 2.32219,
"usd": 2.37311
},
"price_change_percentage_7d_in_currency": {
"btc": 0,
"eur": -1.01955,
"usd": -0.89706
},
"price_change_percentage_14d_in_currency": {
"btc": 0,
"eur": 5.84662,
"usd": 6.36178
},
"price_change_percentage_30d_in_currency": {
"btc": 0,
"eur": 2.28048,
"usd": 1.81171
},
"price_change_percentage_60d_in_currency": {
"btc": 0,
"eur": 60.98834,
"usd": 62.54292
},
"price_change_percentage_200d_in_currency": {
"btc": 0,
"eur": 148.68948,
"usd": 157.51875
},
"price_change_percentage_1y_in_currency": {
"btc": 0,
"eur": 138.20277,
"usd": 149.76989
},
"market_cap_change_24h_in_currency": {
"btc": -49432,
"eur": 28668703539,
"usd": 31172487848
},
"market_cap_change_percentage_24h_in_currency": {
"btc": -0.25084,
"eur": 2.31801,
"usd": 2.32219
},
"total_supply": 21000000,
"max_supply": 21000000,
"max_supply_infinite": false,
"circulating_supply": 19675377,
"outstanding_supply": null,
"last_updated": "2024-04-07T15:24:51.021Z"
},
"tickers": [
{
"base": "BTC",
"target": "USDT",
"market": {
"name": "Binance",
"identifier": "binance",
"has_trading_incentive": false
},
"last": 69816,
"volume": 19988.82111,
"converted_last": {
"btc": 0.99999255,
"eth": 20.441016,
"usd": 69835
},
"converted_volume": {
"btc": 19783,
"eth": 404380,
"usd": 1381537193
},
"trust_score": null,
"bid_ask_spread_percentage": 0.010014,
"timestamp": "2024-04-07T15:23:02+00:00",
"last_traded_at": "2024-04-07T15:23:02+00:00",
"last_fetch_at": "2024-04-07T15:24:00+00:00",
"is_anomaly": false,
"is_stale": false,
"trade_url": "https://www.binance.com/en/trade/BTC_USDT?ref=37754157",
"token_info_url": null,
"coin_id": "bitcoin",
"target_coin_id": "tether",
"coin_mcap_usd": 230926944910.5146
}
]
}币种
按 ID 获取币种数据
CoinGecko 收录的某个币种的全部信息：档案、链接、板块、合约地址和完整行情数据。
GET
https://api.aisa.one
/
apis
/
v1
/
coingecko
/
coins
/
{id}
Reference example
# 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{
"id": "bitcoin",
"symbol": "btc",
"name": "Bitcoin",
"web_slug": "bitcoin",
"asset_platform_id": null,
"platforms": {
"": ""
},
"detail_platforms": {
"": {
"decimal_place": null,
"contract_address": ""
}
},
"block_time_in_minutes": 10,
"hashing_algorithm": "SHA-256",
"categories": [
"Cryptocurrency",
"Layer 1 (L1)"
],
"preview_listing": false,
"public_notice": null,
"additional_notices": [],
"has_supply_breakdown": false,
"description": {
"en": "Bitcoin is the first successful internet money based on peer-to-peer technology..."
},
"links": {
"homepage": [
"http://www.bitcoin.org",
"",
""
],
"whitepaper": "https://bitcoin.org/bitcoin.pdf",
"blockchain_site": [
"https://mempool.space/",
"https://blockchair.com/bitcoin/"
],
"official_forum_url": [
"https://bitcointalk.org/"
],
"chat_url": [
""
],
"announcement_url": [
"",
""
],
"snapshot_url": null,
"twitter_screen_name": "bitcoin",
"facebook_username": "bitcoins",
"bitcointalk_thread_identifier": null,
"telegram_channel_identifier": "",
"subreddit_url": "https://www.reddit.com/r/Bitcoin/",
"repos_url": {
"github": [
"https://github.com/bitcoin/bitcoin",
"https://github.com/bitcoin/bips"
],
"bitbucket": []
}
},
"image": {
"thumb": "https://assets.coingecko.com/coins/images/1/thumb/bitcoin.png?1696501400",
"small": "https://assets.coingecko.com/coins/images/1/small/bitcoin.png?1696501400",
"large": "https://assets.coingecko.com/coins/images/1/large/bitcoin.png?1696501400"
},
"country_origin": "",
"genesis_date": "2009-01-03",
"sentiment_votes_up_percentage": 84.07,
"sentiment_votes_down_percentage": 15.93,
"watchlist_portfolio_users": 1541900,
"market_cap_rank": 1,
"market_cap_rank_with_rehypothecated": 1,
"status_updates": [],
"last_updated": "2024-04-07T15:24:51.021Z",
"market_data": {
"current_price": {
"btc": 1,
"eur": 64375,
"usd": 69840
},
"total_value_locked": null,
"mcap_to_tvl_ratio": null,
"fdv_to_tvl_ratio": null,
"roi": null,
"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"
},
"market_cap": {
"btc": 19675377,
"eur": 1265825267281,
"usd": 1373296629498
},
"fully_diluted_valuation": {
"btc": 21000000,
"eur": 1351831155,
"usd": 1466577759
},
"market_cap_fdv_ratio": 1,
"market_cap_rank": 1,
"outstanding_token_value_usd": null,
"market_cap_rank_with_rehypothecated": 1,
"total_volume": {
"btc": 270165,
"eur": 17368113665,
"usd": 18867210007
},
"high_24h": {
"btc": 1,
"eur": 64343,
"usd": 69805
},
"low_24h": {
"btc": 1,
"eur": 62695,
"usd": 67985
},
"price_change_24h": 1619,
"price_change_percentage_24h": 2.37311,
"price_change_percentage_7d": -0.89706,
"price_change_percentage_14d": 6.36178,
"price_change_percentage_30d": 1.81171,
"price_change_percentage_60d": 62.54292,
"price_change_percentage_200d": 157.51875,
"price_change_percentage_1y": 149.76989,
"market_cap_change_24h": 31172487848,
"market_cap_change_percentage_24h": 2.32219,
"price_change_24h_in_currency": {
"btc": 0,
"eur": 1461.64,
"usd": 1618.95
},
"price_change_percentage_1h_in_currency": {
"btc": 0,
"eur": 0.79523,
"usd": 0.79523
},
"price_change_percentage_24h_in_currency": {
"btc": 0,
"eur": 2.32219,
"usd": 2.37311
},
"price_change_percentage_7d_in_currency": {
"btc": 0,
"eur": -1.01955,
"usd": -0.89706
},
"price_change_percentage_14d_in_currency": {
"btc": 0,
"eur": 5.84662,
"usd": 6.36178
},
"price_change_percentage_30d_in_currency": {
"btc": 0,
"eur": 2.28048,
"usd": 1.81171
},
"price_change_percentage_60d_in_currency": {
"btc": 0,
"eur": 60.98834,
"usd": 62.54292
},
"price_change_percentage_200d_in_currency": {
"btc": 0,
"eur": 148.68948,
"usd": 157.51875
},
"price_change_percentage_1y_in_currency": {
"btc": 0,
"eur": 138.20277,
"usd": 149.76989
},
"market_cap_change_24h_in_currency": {
"btc": -49432,
"eur": 28668703539,
"usd": 31172487848
},
"market_cap_change_percentage_24h_in_currency": {
"btc": -0.25084,
"eur": 2.31801,
"usd": 2.32219
},
"total_supply": 21000000,
"max_supply": 21000000,
"max_supply_infinite": false,
"circulating_supply": 19675377,
"outstanding_supply": null,
"last_updated": "2024-04-07T15:24:51.021Z"
},
"tickers": [
{
"base": "BTC",
"target": "USDT",
"market": {
"name": "Binance",
"identifier": "binance",
"has_trading_incentive": false
},
"last": 69816,
"volume": 19988.82111,
"converted_last": {
"btc": 0.99999255,
"eth": 20.441016,
"usd": 69835
},
"converted_volume": {
"btc": 19783,
"eth": 404380,
"usd": 1381537193
},
"trust_score": null,
"bid_ask_spread_percentage": 0.010014,
"timestamp": "2024-04-07T15:23:02+00:00",
"last_traded_at": "2024-04-07T15:23:02+00:00",
"last_fetch_at": "2024-04-07T15:24:00+00:00",
"is_anomaly": false,
"is_stale": false,
"trade_url": "https://www.binance.com/en/trade/BTC_USDT?ref=37754157",
"token_info_url": null,
"coin_id": "bitcoin",
"target_coin_id": "tether",
"coin_mcap_usd": 230926944910.5146
}
]
}按
在你的 agent 里把这个端点跑起来 →
id 返回 CoinGecko 收录的某个币种的全部信息：description、links、image、categories、platforms 和 detail_platforms（各链上的合约地址）、market_cap_rank，以及包含 current_price、market_cap、total_volume、fully_diluted_valuation、ath 和 atl（含日期和涨跌幅）的 market_data 区块。体量较大的部分通过 market_data、community_data、developer_data、tickers、sparkline 和 localization 按需开启——除非确实需要，否则请保持关闭，完整响应体很大。适合用于获取币种档案。如需跨多个币种的价格表，请使用 get_coingecko_coins_markets；如需按合约地址查询同一币种，请使用 get_coingecko_token_data。
第一次用？ 把任意 MCP 客户端指向
https://mcp.aisa.one/mcp —— Claude Code、
Codex、Cursor、VS Code 都可以。鉴权走 OAuth：客户端打开浏览器，你点一次
Allow，不需要粘贴任何 key。各客户端的具体命令和每次调用的价格见
aisa.one/zh-cn/mcp。费用与请求规则
公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口，执行前请针对完整请求获取免费报价；执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。- 默认请求参考估价（USD）: 0.008
- 声明的单位费率（USD）: 0.0
- 计费单位: provider_credit
- 计费依据: plan_units
- 结算证据来源: request_snapshot
声明的请求计费单位
- 单位数: 1
授权
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
路径参数
Coin ID.
*refers to /coins/list
示例:
"bitcoin"
查询参数
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
响应
Coin data
Coin ID
Coin symbol
Coin name
Coin web slug
Coin asset platform ID
Coin asset platform and contract address
Show child attributes
Show child attributes
Detailed coin asset platform and contract address
Show child attributes
Show child attributes
Blockchain block time in minutes
Blockchain hashing algorithm
Coin categories
Preview listing coin
Public notice
Additional notices
Whether detailed supply breakdown data is available via /coins/supply_breakdown
Coin description
Show child attributes
Show child attributes
链接
Show child attributes
Show child attributes
Coin image URL
Show child attributes
Show child attributes
Country of origin
Genesis date
Sentiment votes up percentage
Sentiment votes down percentage
Number of users watching this coin in portfolio
Market cap rank
Market cap rank including rehypothecated tokens
Status updates
Show child attributes
Show child attributes
Last updated timestamp
Detailed coin categories
Show child attributes
Show child attributes
Coin name localization
Show child attributes
Show child attributes
ICO data
Show child attributes
Show child attributes
Market data
Show child attributes
Show child attributes
Tickers
Show child attributes
Show child attributes