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

基础信息

基础信息


获取公司概况

GET
https://api.bitget.com
/api/v3/reality/market/company-overview

获取指定股票的公司概况信息。

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

获取公司概况 › Request Parameters

code
​string · required

公司代码 如 MU

获取公司概况 › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
peRatio
​string

市盈率

pbRatio
​string

市净率

totalShares
​string

总股本

marketCap
​string

总市值

high52Week
​string

52周最高价格

low52Week
​string

52周最低价格

code
​string

公司代码

name
​string

公司名称

ListingDate
​string

上市日期

employees
​string

员工人数

companyAddress
​string

公司地址

GET/api/v3/reality/market/company-overview
curl 'https://api.bitget.com/api/v3/reality/market/company-overview?code=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1740000000000, "data": { "peRatio": "12.5", "pbRatio": "3.2", "totalShares": "1100000000", "marketCap": "120000000000", "high52Week": "150.00", "low52Week": "60.00", "code": "MU", "name": "Micron Technology, Inc.", "ListingDate": "1984-06-01", "employees": "48000", "companyAddress": "8000 S. Federal Way, Boise, ID 83716-9632" } }
json
application/json

获取估值指标

GET
https://api.bitget.com
/api/v3/reality/market/valuation-indicators

获取指定股票的估值指标数据。

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

获取估值指标 › Request Parameters

code
​string · required

公司代码 如 MU

获取估值指标 › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
date
​string

数据日期

pb
​string

市净率

pbEd
​string

市净率(期末)

pbPd
​string

市净率(期间均值)

pbMrq
​string

市净率(最新季度)

pe
​string

市盈率

peLyr
​string

市盈率(LYR)

peTtmEd
​string

市盈率(TTM,期末)

peTtmPd
​string

市盈率(TTM,期间均值)

ps
​string

市销率

psLyr
​string

市销率(LYR)

psTtmEd
​string

市销率(TTM,期末)

psTtmPd
​string

市销率(TTM,期间均值)

pcf
​string

市现率

pcfNet
​string

市现率(净现金流)

pcfNetTtmEd
​string

市现率(净现金流,TTM,期末)

pcfNetTtmPd
​string

市现率(净现金流,TTM,期间均值)

pcfTtmEd
​string

市现率(TTM,期末)

pcfTtmPd
​string

市现率(TTM,期间均值)

evEbitda
​string

企业价值倍数

equityValue
​string

股权价值

grossEv
​string

企业总价值

netEv
​string

企业净价值

tmvUsd
​string

总市值(美元)

cirTmvUsd
​string

流通市值(美元)

dividendYieldTtm
​string

股息率(TTM)

GET/api/v3/reality/market/valuation-indicators
curl 'https://api.bitget.com/api/v3/reality/market/valuation-indicators?code=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1740000000000, "data": { "date": "2026-08-25", "pb": "3.2", "pbEd": "3.1", "pbPd": "3.3", "pbMrq": "3.2", "pe": "12.5", "peLyr": "13.0", "peTtmEd": "12.4", "peTtmPd": "12.6", "ps": "2.1", "psLyr": "2.2", "psTtmEd": "2.0", "psTtmPd": "2.3", "pcf": "10.5", "pcfNet": "10.6", "pcfNetTtmEd": "10.4", "pcfNetTtmPd": "10.7", "pcfTtmEd": "10.3", "pcfTtmPd": "10.8", "evEbitda": "8.5", "equityValue": "120000000000", "grossEv": "130000000000", "netEv": "125000000000", "tmvUsd": "120000000000", "cirTmvUsd": "118000000000", "dividendYieldTtm": "0.45" } }
json
application/json

获取盈利预测

GET
https://api.bitget.com
/api/v3/reality/market/earnings-forecast

获取指定股票的个股盈利预测数据。

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

获取盈利预测 › Request Parameters

code
​string · required

公司代码 如 MU

获取盈利预测 › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
fiscalYear
​string

年度

publicationDeadline
​string

公布截止日期

isActual
​boolean

是否实际值 true 实际值 false 预测值

revenue
​string

营业收入 单位为百万美元

ebit
​string

息税前利润 单位为百万美元

netIncomeParent
​string

归属母公司股东的净利润 单位为百万美元

eps
​string

每股收益

bps
​string

每股净资产

cfps
​string

每股现金流

roe
​string

净资产收益率

roa
​string

总资产收益率

currency
​string

货币

GET/api/v3/reality/market/earnings-forecast
curl 'https://api.bitget.com/api/v3/reality/market/earnings-forecast?code=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1740000000000, "data": { "fiscalYear": "2026", "publicationDeadline": "2026-09-30", "isActual": false, "revenue": "35000", "ebit": "9000", "netIncomeParent": "7500", "eps": "8.50", "bps": "45.20", "cfps": "12.30", "roe": "0.18", "roa": "0.10", "currency": "USD" } }
json
application/json

获取停复牌资讯

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

获取指定股票公司的停复牌信息。

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

获取停复牌资讯 › Request Parameters

code
​string · required

公司代码 如 MU

获取停复牌资讯 › Response Parameters

200

Successful response

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

公司代码 如 MU

name
​string

公司名称 基于语言返回,如中文为美光科技,英文为 MU

suspensionDate
​string

停牌日期

suspensionTime
​string

停牌时间

suspensionReason
​string

停牌原因

suspensionPrice
​string

停牌价格

resumptionDate
​string

复牌日期

resumptionQuoteTime
​string

恢复报价时间

resumptionTradingTime
​string

恢复交易时间

GET/api/v3/reality/market/suspension-resumption-info
curl 'https://api.bitget.com/api/v3/reality/market/suspension-resumption-info?code=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1740000000000, "data": { "code": "MU", "name": "美光科技", "suspensionDate": "2026-08-20", "suspensionTime": "09:30:00", "suspensionReason": "待发布重大公告", "suspensionPrice": "120.50", "resumptionDate": "2026-08-21", "resumptionQuoteTime": "09:00:00", "resumptionTradingTime": "09:30:00" } }
json
application/json

获取分红与拆分

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

获取指定股票的分红派息历史记录。

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

获取分红与拆分 › Request Parameters

code
​string · required

公司代码 如 MU

limit
​string

每页数量 默认:20。最大:100

cursor
​string

游标 首次查询不传游标,后续分页使用上一次查询返回的游标

获取分红与拆分 › Response Parameters

200

Successful response

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

分红与拆分列表

cursor
​string

游标

GET/api/v3/reality/market/dividends
curl 'https://api.bitget.com/api/v3/reality/market/dividends?code=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1740000000000, "data": { "list": [ { "type": "cash_dividend", "announcementDate": "2026-05-10", "recordDate": "2026-06-01", "exrightDate": "2026-06-02", "dividendDate": "2026-06-15", "dividendPerShare": "0.12", "stockDividendPerShare": "", "splitValidDate": "", "splitNumerator": "", "splitDenominator": "" } ], "cursor": "1233319323918499840" } }
json
application/json

获取股本变动

GET
https://api.bitget.com
/api/v3/reality/market/share-capital-change

获取指定股票的股本变动数据。

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

获取股本变动 › Request Parameters

code
​string · required

公司代码 如 MU

获取股本变动 › Response Parameters

200

Successful response

code
​string
msg
​string
requestTime
​integer
​object
announcementDate
​string

公告日

changeDate
​string

变动日

totalShares
​string

总股本

commonShares
​string

普通股股数

preferredShares
​string

优先股股数

otherShares
​string

其他类别股股数

specialExplain
​string

股本结构特殊说明

changeReason
​string

变动原因

GET/api/v3/reality/market/share-capital-change
curl 'https://api.bitget.com/api/v3/reality/market/share-capital-change?code=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1740000000000, "data": { "announcementDate": "2026-08-10", "changeDate": "2026-08-01", "totalShares": "1100000000", "commonShares": "1100000000", "preferredShares": "0", "otherShares": "0", "specialExplain": "", "changeReason": "员工股权激励计划行权" } }
json
application/json

获取内部人交易

GET
https://api.bitget.com
/api/v3/reality/market/inner-trades

获取指定股票公司的内部人交易信息。

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

获取内部人交易 › Request Parameters

code
​string · required

公司代码 如 MU

limit
​string

每页条目数 默认值20,最大值为100

cursor
​string

游标ID 首次查询不传游标,后续分页使用上一次查询返回的游标

获取内部人交易 › Response Parameters

200

Successful response

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

内部人交易列表

cursor
​string

游标ID

GET/api/v3/reality/market/inner-trades
curl 'https://api.bitget.com/api/v3/reality/market/inner-trades?code=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1740000000000, "data": { "list": [ { "reporterName": "John Smith", "issueOrgName": "美光科技", "endDate": "2026-08-15", "announcementDate": "2026-08-16", "innerType": "Director", "position": "首席财务官", "securityTitle": "普通股", "tradeDate": "2026-08-14", "designatedExerciseDate": "", "innerTradeType": "S", "actionType": "decrease", "tradeVolume": "5000", "tradePrice": "120.50", "holdingType": "direct", "indirectHoldingStatement": "", "postTradeQuantity": "45000" } ], "cursor": "1233319323918499840" } }
json
application/json

获取管理层持股明细

GET
https://api.bitget.com
/api/v3/reality/market/executive-shareholdings

获取指定股票的管理层持股明细数据。

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

获取管理层持股明细 › Request Parameters

code
​string · required

公司代码 如 MU

limit
​string

每页条目数 默认值20,最大值为100

cursor
​string

游标ID 首次查询不传游标,后续分页使用上一次查询返回的游标

获取管理层持股明细 › Response Parameters

200

Successful response

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

管理层持股列表

cursor
​string

游标ID

GET/api/v3/reality/market/executive-shareholdings
curl 'https://api.bitget.com/api/v3/reality/market/executive-shareholdings?code=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1740000000000, "data": { "list": [ { "name": "John Smith", "holdingNum": "45000", "holdingRatio": "0.03", "voteRatio": "0.03", "period": "2026Q2", "announcementDate": "2026-08-16" } ], "cursor": "1233319323918499840" } }
json
application/json

获取主要股东持股明细

GET
https://api.bitget.com
/api/v3/reality/market/sharehold-detail

获取指定股票的主要股东持股明细数据。

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

获取主要股东持股明细 › Request Parameters

code
​string · required

公司代码 如 MU

limit
​string

每页条目数 默认值20,最大值为100

cursor
​string

游标ID 首次查询不传游标,后续分页使用上一次查询返回的游标

获取主要股东持股明细 › Response Parameters

200

Successful response

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

主要股东持股列表

cursor
​string

游标ID

GET/api/v3/reality/market/sharehold-detail
curl 'https://api.bitget.com/api/v3/reality/market/sharehold-detail?code=<string>'
Example Responses
{ "code": "00000", "msg": "success", "requestTime": 1740000000000, "data": { "list": [ { "name": "The Vanguard Group, Inc.", "holdingNum": "120000000", "holdingRatio": "0.109" } ], "cursor": "1233319323918499840" } }
json
application/json

Reality 市场行情数据