Bitget APIBitget API
UTAClassic
Legacy Doc
  • Overview
  • API Documentation
  • WebSocket
  • Agent Hub
  • SDK
  • Changelog
Copied to clipboard
Reality
    Reality Basic Info
      Get Company OverviewgetGet Valuation IndicatorsgetGet Earnings ForecastgetGet Suspension Resumption InfogetGet DividendsgetGet Share Capital ChangegetGet Inner TradesgetGet Executive ShareholdingsgetGet Sharehold Detailget
    Reality Market Data
      Get Reality OrderBookgetGet Reality FillsgetGet Stock InfogetGet Market StatesgetGet Market Calendarget
    Reality Trading
      Place Reality OrderpostCancel Reality Orderpost
Reality
Reality

Reality Market Data

Reality Market Data


Get Reality OrderBook

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

Rate limit: 10/sec/UID

Permission: UTA trade (read)

Query the order book depth snapshot for a specified Reality (US stock) trading pair (up to 40 levels). The depth data returned is raw (unaggregated).

Access requirements: This endpoint requires API Key authentication. You must contact your Business Development (BD) representative in advance to apply for whitelist access.

Get Reality OrderBook › Request Parameters

symbol
​string · required

Trading pair e.g., RAAPLUSDT

Get Reality OrderBook › Response Parameters

200

Successful response

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

Trading pair

a
​array[]

Sell asks. Sorted by price in ascending order

b
​array[]

Buy bids. Sorted by price in descending order

ts
​string

Data snapshot timestamp A Unix timestamp in milliseconds

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

Get Reality Fills

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

Rate limit: 10/sec/UID

Permission: UTA trade (read)

Query recent platform fill records for a specified Reality (US stock) trading pair. This endpoint only returns fills from the last 3 months.

Access requirements: This endpoint requires API Key authentication. You must contact your Business Development (BD) representative in advance to apply for whitelist access.

Get Reality Fills › Request Parameters

symbol
​string · required

Trading pair e.g., RAAPLUSDT. Only Reality trading pairs are supported

limit
​string

Limit per page Default: 100. Maximum: 100

Get Reality Fills › Response Parameters

200

Successful response

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

Fill ID

price
​string

Fill price

size
​string

Fill quantity Unit: base coin

side
​string

Trade side buy Buy sell Sell

ts
​string

Fill time A Unix timestamp in milliseconds

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 Stock Info

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

Get stock information for a specified Reality (US stock) trading pair.

  • Rate limit: 1/sec/IP
  • Permission: None

Get Stock Info › Request Parameters

symbol
​string

Trading pair e.g., RAAPLUSDT If not provided, all trading pairs will be returned

Get Stock Info › Response Parameters

200

Successful response

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

Trading pair name

code
​string

Stock ticker symbol e.g., AAPL

name
​string

Company name

tradingPeriod
​string

Tradable sessions pre_market Pre-market regular Regular hours after_hours After-hours overnight Overnight

weekendTradable
​string

Weekend trading availability yes Supported no Not supported

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 Market States

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

Get stock market status information.

:::info US Stock Trading Hours Pre-market session: ET 04:00 – 09:30 Regular session: ET 09:30 – 16:00 After-hours session: ET 16:00 – 20:00 Overnight session: ET 20:00 – 04:00 (T+1) :::

  • Rate limit: 1/sec/IP
  • Permission: None

Get Market States › Response Parameters

200

Successful response

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

Market Currently only US (US equities) is supported

daylightType
​string

Daylight saving type standard Standard time (winter) dst Daylight saving time (summer)

​object[]

List of market session states

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 Market Calendar

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

Get the market holiday and closure calendar for US stocks.

  • Rate limit: 1/sec/IP
  • Permission: None

Get Market Calendar › Response Parameters

200

Successful response

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

Time zone Always returns EST

​object[]

Special closure list Used for non-regular closures such as holidays or special events

regularConfig
​string[]

Regular closure list Used for regular weekend closures e.g., 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 Basic InfoReality Trading