币安加密货币API接口文档
1. 概述
本API提供加密货币市场数据接口,包括交易对列表、最新行情、最新价格、K线数据和近期成交记录。所有接口均需要key
参数进行身份验证,key
需要联系API提供方获取。
2. 接口列表
2.1 交易对列表
接口描述
获取加密货币交易对列表,支持分页查询。
请求方法
GET
请求URL
https://api.stocktv.top/crypto/pairlist?key=联系我们获取key&page=1&size=100&marketId=338
请求参数
参数 | 必填 | 说明 | 默认值 |
---|---|---|---|
key | 是 | API访问密钥 | - |
page | 否 | 分页参数,第几页 | 1 |
size | 否 | 分页大小,每页记录数 | 100 |
marketId | 否 | 市场ID,338表示获取币安数据 | 338 |
响应示例
{"code": 200,"message": "操作成功","data": {"total_count": 412,"total_page": 206,"list": [{"symbol": "BTC","legal_currency_price": 119188.63826104486,"market_cap_display": "$2,368,163,669,304.77","percent_change_utc0_3d": 3.35,"today_change_faq": "今日涨幅是指当前价格相对于今日 UTC 0 点(今日北京时间 8 点)价格的变化。","cc_kline": 1,"today_change": "今日涨幅","price": "119188.8600000000000000","price_change_today": "+0.0000000000000000","price_high_display": "0","rank": 1,"logo": "https://camelhash.s3.ap-southeast-1.amazonaws.com/1726799669489_g0kma14xdww_btc.webp","id": 113538,"tag": "","price_display": "119,188.86","is_price_abnormal": 0,"price_abnormal_icon": "https://cdn.mytoken.org/warning3x.png","price_low_display": "0","price_display_cny": 119188.63826104486,"tv_symbol": null,"is_new": 0,"com_id": "btc_usdt","market_id": 338,"legal_currency_sign": "$","market_cap_display_cny": "2368163669304.77","market_name": "Binance","market_cap_usd": "2368163669304.77","exchange_time": "刚刚","percent_change_1h": 0.13,"legal_currency_price_display": "119,189","percent_change_utc8_0": -0.94,"volume_24h_rate": "14.79%","percent_change_today": null,"name": "Bitcoin","volume_24h": "2134448308.904214","percent_change_utc0_yesterday": -0.51,"price_display_cny_accuracy": 119188.63826104486,"percent_change_utc0_0": 0.42,"global_price_second_price_display": "$119,189","price_usd": "119188.8600000000000000","is_favorite": false,"price_change_utc8": "+0.0000000000000000","available_supply": 19905246,"hr_price_display": "$119,189","volume_24h_from": 17919.6,"enabled": 1,"market_logo": "https://cdn.mytoken.org/Fn3df8UZZGNuWd87rTXSD26WD0-R","kline_enabled": 1,"price_accuracy": "119188.8600000000000000","percent_change_24h": -0.69,"percent_change_display": "0.4200","alias": "比特币","currency": "BTC","percent_change_range": "今日","kline_source": "binance","currency_name": "Bitcoin","market_alias": "币安Binance","currency_on_market_name": "Bitcoin","price_updated_at": 1755008213,"name_id": "bitcoin","pair": "BTC/USDT","percent_change_utc8_yesterday": 1.26,"hr_price_display_web": "119,189","price_usd_accuracy": "119188.8600000000000000","percent_change_utc0": 0.42,"anchor_sign": "₮","anchor": "USDT","legal_currency_price_usd": "","volume_24h_usd": "2134448308.904214","volume_24h_to": null,"percent_change_3d": 2.97,"percent_change_utc8": 1.59,"volume_24h_legal_currency": "2134448308.904214","percent_change_7d": 4.26,"category": "现货","currency_id": 1,"search_field": "Bitcoin BTC 比特币"}]}
}
响应参数说明
字段 | 说明 |
---|---|
code | 状态码,200表示操作成功 |
message | 操作结果消息 |
data.total_count | 总记录数 |
data.total_page | 总页数 |
data.list | 交易对列表 |
data.list.symbol | 币种符号 |
data.list.price | 当前价格 |
data.list.price_display | 价格显示格式 |
data.list.percent_change_utc0_0 | UTC0时区今日涨幅百分比 |
data.list.percent_change_24h | 24小时涨幅百分比 |
data.list.percent_change_7d | 7天涨幅百分比 |
data.list.pair | 交易对,如BTC/USDT |
2.2 获取最新行情
接口描述
获取指定交易对的最新行情数据。
请求方法
GET
请求URL
https://api.stocktv.top/crypto/tickerPrice?key=联系我们获取key&symbols=BTCUSDT,ETHUSDT
请求参数
参数 | 必填 | 说明 | 默认值 |
---|---|---|---|
key | 是 | API访问密钥 | - |
symbols | 是 | 交易对列表,通过逗号隔开,最多100个 | - |
响应示例
{"code": 200,"message": "操作成功","data": [{"priceChange": "2760.75000000","symbol": "BTCUSDT","count": 1731863,"openPrice": "64151.26000000","lastId": 3702658682,"quoteVolume": "2016822851.96679820","firstId": 3700926820,"volume": "30907.41655000","weightedAvgPrice": "65253.68591400","lowPrice": "63456.70000000","highPrice": "67480.00000000","closeTime": 1721980525357,"openTime": 1721894100000,"priceChangePercent": "4.304","lastPrice": "66912.01000000"},{"priceChange": "78.37000000","symbol": "ETHUSDT","count": 1700560,"openPrice": "3173.21000000","lastId": 1491753771,"quoteVolume": "1225148148.34218900","firstId": 1490053212,"volume": "385445.44180000","weightedAvgPrice": "3178.52545517","lowPrice": "3087.53000000","highPrice": "3276.00000000","closeTime": 1721980525357,"openTime": 1721894100000,"priceChangePercent": "2.470","lastPrice": "3251.58000000"}]
}
响应参数说明
字段 | 说明 |
---|---|
symbol | 交易对,如BTCUSDT |
lastPrice | 最新价格 |
openPrice | 当前开盘价格 |
highPrice | 当前最高价 |
lowPrice | 当前最低价 |
priceChange | 价格变化值 |
priceChangePercent | 涨跌幅百分比 |
volume | 成交量 |
quoteVolume | 成交额 |
2.3 获取最新价格
接口描述
获取指定交易对的最新价格。
请求方法
GET
请求URL
https://api.stocktv.top/crypto/lastPrice?key=联系我们获取key&symbols=BTCUSDT,ETHUSDT
请求参数
参数 | 必填 | 说明 | 默认值 |
---|---|---|---|
key | 是 | API访问密钥 | - |
symbols | 是 | 交易对列表,通过逗号隔开,最多100个 | - |
响应示例
{"code": 200,"message": "操作成功","data": [{"symbol": "BTCUSDT","price": "66630.20000000"},{"symbol": "ETHUSDT","price": "3307.74000000"}]
}
响应参数说明
字段 | 说明 |
---|---|
symbol | 交易对,如BTCUSDT |
price | 最新价格 |
2.4 K线数据
接口描述
获取指定交易对的K线数据。
请求方法
GET
请求URL
https://api.stocktv.top/crypto/getKlines?key=联系我们获取key&symbol=BTCUSDT&interval=5m
请求参数
参数 | 必填 | 说明 | 默认值 |
---|---|---|---|
key | 是 | API访问密钥 | - |
symbol | 是 | 交易对 | - |
interval | 是 | 时间间隔,支持1s, 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M | - |
响应示例
{"code": 200,"message": "操作成功","data": [[1721832000000,"66895.35000000","67038.81000000","66850.15000000","66876.57000000","241.28984000",1721832299999,"16158644.69122830",14103,"110.77452000","7418717.11651610","0"],[1721832300000,"66876.57000000","67000.00000000","66876.57000000","66967.71000000","223.31503000",1721832599999,"14968218.08592150",13325,"100.46735000","6711542.50281500","0"]]
}
响应参数说明
字段 | 说明 |
---|---|
0 | K线开盘时间(时间戳) |
1 | 开盘价 |
2 | 最高价 |
3 | 最低价 |
4 | 收盘价(当前K线未结束的即为最新价) |
5 | 成交量 |
6 | K线收盘时间(时间戳) |
7 | 成交额 |
8 | 成交笔数 |
9 | 主动买入成交量 |
10 | 主动买入成交额 |
11 | 请忽略该参数 |
2.5 获取近期成交
接口描述
获取指定交易对的近期成交记录。
请求方法
GET
请求URL
https://api.stocktv.top/crypto/getTrades?key=联系我们获取key&symbol=BTCUSDT
请求参数
参数 | 必填 | 说明 | 默认值 |
---|---|---|---|
key | 是 | API访问密钥 | - |
symbol | 是 | 交易对 | - |
响应示例
{"code": 200,"message": "操作成功","data": [{"quoteQty": "67.03305000","price": "67033.05000000","qty": "0.00100000","isBestMatch": true,"id": 3702674679,"time": 1721981582129,"isBuyerMaker": false},{"quoteQty": "123.45678900","price": "67033.05000000","qty": "0.00184200","isBestMatch": true,"id": 3702674680,"time": 1721981582130,"isBuyerMaker": true}]
}
响应参数说明
字段 | 说明 |
---|---|
id | 成交ID |
time | 成交时间(时间戳) |
price | 价格 |
qty | 成交量 |
quoteQty | 成交额 |
isBestMatch | 是否是最佳匹配 |
isBuyerMaker | 是否是买方挂单 |
3. 错误码说明
错误码 | 说明 |
---|---|
400 | 请求参数错误 |
401 | 未授权,key无效 |
403 | 禁止访问 |
500 | 服务器内部错误 |
4. 使用示例
4.1 获取BTC/USDT的最新价格
GET https://api.stocktv.top/crypto/lastPrice?key=YOUR_KEY_HERE&symbols=BTCUSDT
4.2 获取BTC/USDT和ETH/USDT的K线数据(5分钟间隔)
GET https://api.stocktv.top/crypto/getKlines?key=YOUR_KEY_HERE&symbol=BTCUSDT&interval=5m
5. 注意事项
- 所有接口需要
key
参数,key
需要联系API提供方获取。 - 交易对符号格式为
BASEQUOTE
,如BTCUSDT表示BTC/USDT。 key
参数需要替换为实际获取的密钥。- 每个接口的响应数据中,
code
为200表示操作成功,其他值表示错误。 - 请勿频繁请求,避免被限制访问。
- 币种ID与市场ID(如338表示币安)相关,如需对接其他交易所,请联系API提供方获取相应ID。