市场数据
工具
search_coins
按自由文本的名称或代码将币种或代币解析为其规范 slug,并为每个匹配项返回带排名的市场摘要。这是入口工具:其他所有币种工具都通过 slug 定位。
| 参数 |
类型 |
说明 |
query
必填
|
string |
与币种名称和代码匹配的自由文本搜索。 |
type
|
enum |
限定匹配类型:coin 或 token。 |
limit
|
integer |
返回的最大匹配数(1-50,默认 10)。 |
工具
get_coin
单个币种的完整档案:供应量、排名与排名变动、历史最高/最低价及与其的差距、完全稀释估值、链接、合约与简介。
| 参数 |
类型 |
说明 |
slug
必填
|
string |
规范币种 slug,例如 bitcoin。 |
工具
get_prices
一次调用获取最多 100 个币种的当前现货价格,可选择换算为某种法币。回答价格问题最省配额的方式--必须且只能提供一个选择器。
| 参数 |
类型 |
说明 |
slugs
|
string |
逗号分隔的币种 slug--首选的选择器。 |
symbols
|
string |
逗号分隔的代码符号;有歧义的符号会解析为排名最高的匹配项。 |
ids
|
string |
逗号分隔的 Bitculator 数字币种 id。 |
convert
|
string |
价格换算的目标法币符号,例如 EUR。默认为 USD。 |
工具
get_top_movers
按过去 24 小时或 7 天的百分比变化排出的最大涨幅或跌幅币种。
| 参数 |
类型 |
说明 |
direction
必填
|
enum |
gainers 或 losers。 |
interval
|
enum |
用于排名的变化窗口:24h 或 7d(默认 24h)。 |
limit
|
integer |
返回的最大币种数(1-50,默认 10)。 |
工具
get_trending_coins
当前在 Bitculator 上最受关注的币种,以紧凑的市场行返回。
| 参数 |
类型 |
说明 |
limit
|
integer |
返回的最大币种数(1-20,默认 10)。 |
历史数据
工具
get_price_history
某币种在指定日期区间内的 OHLCV 蜡烛图。保留期:分钟级约 8 天,半小时级约 3 个月,小时级约 6 个月,日级 = 全部历史。返回窗口内最新的蜡烛,按从旧到新排序。
| 参数 |
类型 |
说明 |
slug
必填
|
string |
规范币种 slug。 |
interval
|
enum |
蜡烛间隔:minutely、half-hourly、hourly 或 daily(默认 daily)。 |
start
|
date |
窗口起点,格式 YYYY-MM-DD;默认为与间隔匹配的近期窗口。 |
end
|
date |
窗口终点,格式 YYYY-MM-DD;默认为当前时间。 |
limit
|
integer |
返回的最大蜡烛数(1-500,默认 90)。 |
工具
get_historical_price
单个币种在某个特定历史日期的价格;当当天没有数据时,最多回退 3 天。
| 参数 |
类型 |
说明 |
slug
必填
|
string |
规范币种 slug。 |
date
必填
|
date |
日期,格式 YYYY-MM-DD(2009-01-01 或之后,不能是未来日期)。 |
工具
get_global_history
加密市场总市值或总成交量的时间序列。粒度随周期而定:24h 为半小时级,7d 为小时级,30d 与 all 为日级。
| 参数 |
类型 |
说明 |
metric
必填
|
enum |
返回哪个序列:marketcap 或 volume。 |
period
|
enum |
窗口:24h、7d、30d 或 all(默认 24h)。 |
市场情绪与全局
工具
get_global_market
全市场快照:总市值、24 小时总成交量、BTC/ETH 市场份额,以及币种/代币/交易所/交易对数量。
此工具不需要任何参数。
工具
get_fear_greed
恐惧与贪婪情绪指数,覆盖全市场;传入 slug 时则针对单个币种,并包含 7d/30d 区间子分数。
| 参数 |
类型 |
说明 |
coin
|
string |
可选的币种 slug,用于获取单币种读数;省略则返回全市场指数。 |
工具
get_altseason_index
山寨季指数--山寨币是否正在跑赢比特币--可选附带每日历史数据。
| 参数 |
类型 |
说明 |
days
|
integer |
包含的每日历史天数(0-365;0 只返回当前读数)。 |
工具
get_liquidations_summary
今日期货清算总额,含多空拆分与占比。每日滚动结算刚过后数据可能为 null。
此工具不需要任何参数。
交易所
工具
list_exchanges
带 24 小时成交量、成交量份额及交易对/资产数量的交易所排名。也可将交易所名称解析为 slug。
| 参数 |
类型 |
说明 |
type
|
enum |
限定为中心化(cex)或去中心化(dex)交易所。 |
search
|
string |
与交易所名称匹配的自由文本搜索。 |
sort
|
string |
逗号分隔的排序字段,"-" 前缀表示降序:volume、rank、volume_dominance、change_24h、change_7d、pairs、assets。 |
limit
|
integer |
返回的最大交易所数(1-50,默认 10)。 |
工具
get_exchange
单个交易所的完整档案:排名、成交量及变化、市场份额、上架交易对与资产,以及链接。
| 参数 |
类型 |
说明 |
slug
必填
|
string |
规范交易所 slug,例如 binance-exchange。 |
工具
get_exchange_trust_score
交易所的信任评分(0-10)及其完整的 13 项因子拆解。
| 参数 |
类型 |
说明 |
slug
必填
|
string |
规范交易所 slug。 |
工具
get_coin_markets
币种的交易场所:其在各交易所的市场,含交易对、价格与 24 小时成交量,按成交量排序。
| 参数 |
类型 |
说明 |
slug
必填
|
string |
规范币种 slug。 |
exchange
|
string |
可选的交易所 slug,用于将结果限定到一个交易场所。 |
instrument
|
enum |
限定为一种交易类型:spot、future、option、swap 或 margin。 |
limit
|
integer |
返回的最大市场数(1-50,默认 10)。 |
分析与实用工具
工具
get_coin_technicals
一次调用获取币种的多指标技术快照:RSI、MACD、SMA、ADX、MFI、CCI、OBV、VWAP、波动率等,每项都附最新状态与得分。
| 参数 |
类型 |
说明 |
slug
必填
|
string |
规范币种 slug。 |
工具
convert_currency
使用实时汇率在任意加密货币和/或法币之间换算金额(每次调用最多 10 个目标),保留完整小数精度。
| 参数 |
类型 |
说明 |
from
必填
|
string |
源货币 slug,例如 bitcoin 或 united-states-dollar。 |
to
必填
|
string |
逗号分隔的目标货币 slug,最多 10 个。 |
amount
|
number |
要换算的源货币数量(默认 1)。 |
工具
calculate_dca
用真实价格历史回测定投(DCA)策略:总投入、累计币量、当前价值与盈亏。
| 参数 |
类型 |
说明 |
slug
必填
|
string |
规范币种 slug。 |
amount
必填
|
number |
每期买入的 USD 金额。 |
interval
必填
|
enum |
买入频率:daily、weekly、monthly、quarterly 或 yearly。 |
start
必填
|
date |
首次买入日期,格式 YYYY-MM-DD(须早于今天)。 |
end
|
date |
最后一次买入日期,格式 YYYY-MM-DD;默认为今天。 |
series
|
boolean |
是否包含逐笔买入序列(输出较大--除非被要求,否则保持 false)。 |