Bitget APIBitget API
统一账户经典账户
旧文档
  • 概览
  • API 文档
  • WebSocket
  • Agent Hub
  • SDK
  • 更新日志
Copied to clipboard
Reality
    基础信息
      获取公司概况get获取估值指标get获取盈利预测get获取停复牌资讯get获取分红与拆分get获取股本变动get获取内部人交易get获取管理层持股明细get获取主要股东持股明细get
    Reality 市场行情数据
      获取Reality深度数据get获取Reality平台成交数据get获取股票信息get获取市场状态get获取休市日历get
    Reality 交易
      创建Reality股票订单post撤销Reality股票订单post
Reality
Reality

Reality 市场行情数据

Reality 市场行情数据


获取Reality深度数据

GET
https://api.bitget.com
/api/v3/account/reality-orderbook

限频规则: 10次/秒/UID

需要统一账户交易只读/读写权限

获取指定 Reality 美股交易对的订单簿深度快照(最多 40 档)。返回的深度数据为未合并的原始深度。

接入要求:该接口需要 API Key 认证,请提前联系 BD 申请开通白名单权限。

获取Reality深度数据 › Request Parameters

symbol
​string · required

交易对 如 RAAPLUSDT

获取Reality深度数据 › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
symbol
​string

交易对

a
​array[]

卖盘深度,按价格升序排列

b
​array[]

买盘深度,按价格降序排列

ts
​string

数据快照时间戳 Unix毫秒时间戳

GET/api/v3/account/reality-orderbook
curl 'https://api.bitget.com/api/v3/account/reality-orderbook?symbol=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1740000000000, "data": { "symbol": "RAAPLUSDT", "a": [ [ "227.55", "80" ], [ "227.60", "300" ] ], "b": [ [ "227.50", "100" ], [ "227.45", "250" ] ], "ts": "1740000000000" } }
json
application/json

获取Reality平台成交数据

GET
https://api.bitget.com
/api/v3/account/reality-fills

限频规则: 10次/秒/UID

需要统一账户交易只读/读写权限

获取指定 Reality 美股交易对的平台成交历史记录。该接口仅返回近三个月的成交数据。

接入要求:该接口需要 API Key 认证,请提前联系 BD 申请开通白名单权限。

获取Reality平台成交数据 › Request Parameters

symbol
​string · required

交易对 如 RAAPLUSDT,仅支持传 Reality 交易对

limit
​string

每页条数 默认值:100,最大值:100

获取Reality平台成交数据 › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object[]
execId
​string

成交ID

price
​string

成交价格

size
​string

成交数量 单位为base coin

side
​string

交易方向 buy 买入 sell 卖出

ts
​string

成交时间 Unix毫秒时间戳

GET/api/v3/account/reality-fills
curl 'https://api.bitget.com/api/v3/account/reality-fills?symbol=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1740000000000, "data": [ { "execId": "1234567890", "price": "227.50", "size": "10", "side": "buy", "ts": "1740000000000" } ] }
json
application/json

获取股票信息

GET
https://api.bitget.com
/api/v3/reality/market/stock-info

获取Reality美股指定交易对的股票信息。

  • 限频规则: 1次/秒/IP
  • 权限: 无

获取股票信息 › Request Parameters

symbol
​string

交易对 股票交易对名称,如 RAAPLUSDT 如不填,则返回所有交易对

获取股票信息 › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object[]
symbol
​string

交易对名称

code
​string

股票代码 如 AAPL

name
​string

公司名称

tradingPeriod
​string

可交易时段 pre_market 盘前 regular 盘中 after_hours 盘后 overnight 夜盘

weekendTradable
​string

周末可交易 yes 是 no 否

GET/api/v3/reality/market/stock-info
curl https://api.bitget.com/api/v3/reality/market/stock-info
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1740000000000, "data": [ { "symbol": "RAAPLUSDT", "code": "AAPL", "name": "Apple Inc.", "tradingPeriod": [ "pre_market", "regular", "after_hours" ], "weekendTradable": "yes" } ] }
json
application/json

获取市场状态

GET
https://api.bitget.com
/api/v3/reality/market/states

获取股票市场状态信息。

:::info 美股交易时间表 盘前交易:ET 04:00 - 09:30 持续交易时段:ET 09:30 - 16:00 盘后交易时段:ET 16:00 - 20:00 夜盘交易时段:ET 20:00 - 04:00(T+1) :::

  • 限频规则: 1次/秒/IP
  • 权限: 无

获取市场状态 › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object[]
market
​string

市场 当前仅支持 US 美股

daylightType
​string

日照时间类型 standard 冬令时 dst 夏令时

​object[]

状态列表

GET/api/v3/reality/market/states
curl https://api.bitget.com/api/v3/reality/market/states
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1740000000000, "data": [ { "market": "US", "daylightType": "dst", "stateList": [ { "state": "pre_market", "timeZone": "ET", "startTime": "04:00", "endTime": "09:30" }, { "state": "regular", "timeZone": "ET", "startTime": "09:30", "endTime": "16:00" } ] } ] }
json
application/json

获取休市日历

GET
https://api.bitget.com
/api/v3/reality/market/calendar

获取美股市场的休市日历信息。

  • 限频规则: 1次/秒/IP
  • 权限: 无

获取休市日历 › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
timeZone
​string

时区 固定返回 EST

​object[]

特殊休市列表 用于节日或特殊事件等非常规休市场景

regularConfig
​string[]

常规休市列表 用于周末假日等常规休市场景 如 SATURDAY、SUNDAY

GET/api/v3/reality/market/calendar
curl https://api.bitget.com/api/v3/reality/market/calendar
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1787212600475, "data": { "timeZone": "EST", "specificConfig": [ { "remark": "", "startTime": "2026-06-18 20:00", "endTime": "2026-06-19 20:00" } ], "regularConfig": [ "SATURDAY", "SUNDAY" ] } }
json
application/json

基础信息Reality 交易