Skip to content

feat(v3.2.6): UTA Oct 15 batch and rToken depth - #3

Merged
JJ-Cro merged 2 commits into
masterfrom
update19102026
Oct 20, 2026
Merged

JJ-Cro merged 2 commits into
masterfrom
update19102026

Conversation

@JJ-Cro

@JJ-Cro JJ-Cro commented Oct 19, 2026

Copy link
Copy Markdown
Owner

Summary

Monday SDK batch for the Bitget UTA changelog through 15 Oct 2026, checked against https://www.bitget.com/docs/uta/changelog/2026-10 and the live public API. Version 3.2.6. Base 71d95ec.

getServerTime now calls GET /api/v3/market/time. The old /api/v3/public/time path returns 404, so clock sync was broken.

Changelog

  • CFD GET /api/v3/cfd/trade/history-order: request cursor (last orderId from page 2 on) and pageNo. First page may return more rows than limit.
  • getOpenInterestHistory - GET /api/v3/market/open-interest-history (symbol, period 5m..1d).
  • getInterestRateHistory - GET /api/v3/market/interest-rate-history. VIP query param is level (vip0-vip7, pro1-pro6). vipLevel is ignored by the API. limit and cursor work live.
  • getServerTime returns serverTime (ms) and serverTimeMicros.
  • getAnnouncements - GET /api/v3/public/annoucements (Bitget spelling). Live rows use cTime and annDesc. Docs call the time createdTime.
  • getCoins - GET /api/v3/market/coins. Live chains use withdrawMinScale. The docs example names that field withdrawPrecision.
  • Instruments: fullName, instrumentType (metal/energy/stock/etf/crypto), marketRegion, isin. symbolType is unchanged. Crypto returns marketRegion and isin as null.
  • Place order and batch place: requestTime + receiveWindow ([10, 60000] ms). An order that arrives after requestTime + receiveWindow is canceled.
  • Place order, WS place-order, and order info: venue (internalization | lit_market) and rTokenTimeInForce (gtd | gtc, gtc is 90 days). place-reality-order gets the same optional fields. The 13 Oct changelog describes them for that endpoint. Its parameter table does not list them yet.
  • Rate-limit quota: a sub-account may call get/set for itself. uid / uids are not required and are ignored on that call. The master account still must send them.
  • getMaxOpenAvailable: marginMode (crossed default, isolated). Isolated available excludes futures trial funds.
  • Unfilled strategy orders: response side.
  • STP groups (MM whitelist): createStpGroup, getStpGroups, addStpGroupMembers, removeStpGroupMembers. uids is a comma-separated string, max 50.
  • getRealityOrderBookSegmented and WS topic reality-orderbook-segmented. Levels are [price, onshoreQty, offshoreQty], up to 50. Whitelist required. Go-live 20 Oct 2026. Pairs that have not finished the matching-engine upgrade do not return data. A crossed book after the upgrade is expected.
  • Public topics books1 and books5. books1 and books5 are full snapshots on every push. books and books50 are a snapshot, then incremental updates. rToken: books1 pushes at all times. books5 / books50 / books push only outside US market hours. REST orderbook for rToken returns only the BBO during weekday market hours.
  • UTA financial-record type is the official enum from https://www.bitget.com/docs/uta/enum, including Bitget's MARIN_BUY_DEAL / MARIN_SELL_DEAL spelling.

Checked, no SDK change:

  • books50 helpers and examples do not assume a full snapshot. There is no local orderbook merger. The V3 public example only logs raw messages. The existing WsOrderBookDataV3 note already said snapshot then incremental. JSDoc now also separates books1/books5 (always a snapshot) so that note is not applied to them.
  • UA account-update balanceOriginal was already on WsAccountCoinV3 and REST AccountAssetV3 (new coin balance, without deducting borrow).
  • UA deposit dest (on_chain | internal_transfer) and status (pending | success | fail) already match Bitget.Net TransferType / TransferStatus. Withdrawal dest matches. Withdrawal status already matches WithdrawStatus.

Checks

  • npm run build
  • npm run lint (eslint src + apidoc prettier)
  • npm run test:public - 3 suites, 29 tests passed (keyless)
Open in Web Open in Cursor 

cursoragent and others added 2 commits October 19, 2026 06:09
CFD history-order gains cursor and pageNo. The first page may return more rows than limit.

New public methods: getOpenInterestHistory, getInterestRateHistory (query param is level, vipLevel is ignored), getAnnouncements, getCoins. getServerTime now calls /api/v3/market/time and returns serverTimeMicros. /api/v3/public/time is 404.

Instruments add fullName, instrumentType, marketRegion, and isin. symbolType is unchanged. place-order and place-batch add requestTime and receiveWindow. place-order and the WS place-order params add venue and rTokenTimeInForce. Order info returns those two fields. place-reality-order gets the same optional routing fields; its parameter table does not list them yet, the 13 Oct changelog does.

Rate-limit quota: a sub-account may omit uids/uid. max-open-available adds marginMode. Unfilled strategy orders add side.

STP group create, list, add, and remove. reality-orderbook-segmented REST and WS, whitelist, go-live 20 Oct 2026. books1 and books5 are public topics. books and books50 stay snapshot then incremental.

UTA financial-record type is the official enum, including Bitget's MARIN_BUY_DEAL spelling.

Co-authored-by: Jerko J <JJ-Cro@users.noreply.github.com>
@JJ-Cro
JJ-Cro merged commit cb6f1a9 into master Oct 20, 2026
0 of 2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants