币安 Binance调用手册

查询现货交易对最新价格

无需账户和密钥,取得 BTCUSDT 的最新价格。

官方资料核对 2026-10-15示例代码,未进行真实接口实测
← 返回平台功能

接入准备

  • 能访问适用的 Binance.com 公共现货 API;本例不代表已获得账户或交易资格。

本场景的示例无需设置环境变量;按参数说明替换示例中的资源标识。

调用步骤

  1. 01

    确定现货 symbol,例如 BTCUSDT,注意是大写且没有连字符。

  2. 02

    运行单次查询并检查 HTTP 状态,成功后读取 price 字符串。

  3. 03

    若要批量查询,用 symbols JSON 数组参数并 URL 编码;不能与 symbol 同时发送。

调用 01

查询最新价格

指定单一 symbol 返回对象;不传 symbol/symbols 则可能返回全市场数组。

GEThttps://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT

请求头

Accept
application/json

参数说明

参数表可左右滑动,查看完整说明。

字段 / 位置类型 / 必填说明
symbolQuerystring可选单一交易对。与 symbols 互斥;本场景显式传 BTCUSDT 避免全量查询。

调用代码

替换示例 ID 与请求体内容后运行。cURL 会报 HTTP 错误,业务状态还需按下方返回示例核对。

cURL
# 执行后核对返回 JSON 的业务状态;HTTP 200 仍可能包含业务错误。
curl --silent --show-error --fail-with-body \
  --request GET \
  --url "https://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT" \
  --header "Accept: application/json"
Python 3
import json
import os
import re
import urllib.request
import urllib.error

def expand(value):
    return re.sub(r"\$\{([A-Z][A-Z0-9_]*)\}",
                  lambda match: os.environ[match.group(1)], value)

url = expand("https://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT")
headers = {
    "Accept": expand("application/json"),
}
data = None
request = urllib.request.Request(url, data=data, headers=headers, method="GET")
try:
    with urllib.request.urlopen(request, timeout=30) as response:
        result = json.load(response)
except urllib.error.HTTPError as error:
    print(f"HTTP {error.code}: {error.read().decode('utf-8', errors='replace')}")
    raise SystemExit(1)
print(json.dumps(result, ensure_ascii=False, indent=2))
Node.js
// Node.js 22+,保存为 request.mjs 后运行 node request.mjs
function expand(value) {
  return value.replace(/\$\{([A-Z][A-Z0-9_]*)\}/g, (_, name) => {
    if (!process.env[name]) throw new Error(`缺少环境变量 ${name}`);
    return process.env[name];
  });
}

const url = expand("https://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT");
const headers = Object.fromEntries(
  Object.entries({
  "Accept": "application/json"
}).map(([key, value]) => [key, expand(value)])
);
const response = await fetch(url, {
  method: "GET",
  headers,
  signal: AbortSignal.timeout(30000),
});
const text = await response.text();
if (!response.ok) throw new Error(`HTTP ${response.status}: ${text}`);
const result = JSON.parse(text);
console.log(JSON.stringify(result, null, 2));

返回示例

按官方结构整理的节选示意,非实测结果。symbol 为交易对,price 是报价币种计价的最新价格字符串,不是买卖盘或可保证成交的报价。 以下为结构示意,非本站实测结果。

JSON
{
  "symbol": "BTCUSDT",
  "price": "60000.00000000"
}

常见错误与排查

-1121无效交易对
使用现货交易对标识 BTCUSDT,不加连字符;先核对 exchangeInfo。
HTTP 429 / -1003IP 请求权重或请求频率超限
按 Retry-After 等待并降低调用频率,不持续重试导致 IP 封禁。

调用注意

  • 当前文档单交易对请求权重为 2;省略 symbol 时全量权重为 4。

注意事项

  • 本轮仅提供只读查询;示例不含下单、杠杆、划转或提现。Binance.com 服务与各地区独立站点的账户和资格不能互换。
  • 公开行情无需 API Key,但仍消耗 IP 请求权重;查询权重不是交易手续费,实际交易另按账户费率。

核验来源

本站按官方资料整理本场景的必要调用步骤与代码,覆盖范围以本页列出的接口为准。官方资料用于追溯规范及查看变更。

  1. 01
    Binance REST 签名与时间窗口核验日期 2026-10-15
  2. 02
    Binance Spot 市场查询参数核验日期 2026-10-15
  3. 03
    Binance 现货错误码核验日期 2026-10-15

币安 Binance的其他调用手册

← 返回币安 Binance的全部功能