币安加密货币API接口文档

金融数据出海
446 阅读5分钟

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_0UTC0时区今日涨幅百分比
data.list.percent_change_24h24小时涨幅百分比
data.list.percent_change_7d7天涨幅百分比
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"
        ]
    ]
}

响应参数说明

字段说明
0K线开盘时间（时间戳）
1开盘价
2最高价
3最低价
4收盘价（当前K线未结束的即为最新价）
5成交量
6K线收盘时间（时间戳）
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. 注意事项

  1. 所有接口需要key参数，key需要联系API提供方获取。
  2. 交易对符号格式为BASEQUOTE，如BTCUSDT表示BTC/USDT。
  3. key参数需要替换为实际获取的密钥。
  4. 每个接口的响应数据中，code为200表示操作成功，其他值表示错误。
  5. 请勿频繁请求，避免被限制访问。
  6. 币种ID与市场ID（如338表示币安）相关，如需对接其他交易所，请联系API提供方获取相应ID。
avatar
文章
阅读
粉丝