Release Notes for Wonder Birga API

Release 2.1.727, November 21, 2025

ocr: добавлена поддержка heic формата

Release 2.1.724, November 19, 2025

ocr: в ответе исправлено поле 'NATURAL_GENDER' с 'МУЖ' 'ЖЕН' на 'M' 'F'

Release 2.1.716, November 12, 2025

contest: админский эндпоинт для удаления участников `/be/admin/api/v2/contest/{id}/participants/{nickname}`
contest: добавлены новые админские права
ocr: в ответ добавлено поле `NATURAL_GENDER`

Release 2.1.702, November 5, 2025

contest: в ответ /api/v2/contest/{id}/status добавлено поле 'left_at'

Release 2.1.691, October 31, 2025

contest: новый endpoint /api/v2/contest/{id}/participants/{nickname}/portfolio
contest: новый endpoint /api/v2/contest/{id}/participants/{nickname}/trades
contest: в ответ /api/v2/contest/{id}/leaderboard добавлены поля 'registered_at', 'num_deals', 'place_change'
contest: в ответ /api/v2/contest/{id}/status добавлено поле 'rules_slug'
contest: новые виды ошибок [NOT_PARTICIPATING: 1454], [EMPTY_PORTFOLIO: 1455], [BANNED: 1456], [LEFT: 1457], [FEATURE_DISABLED: 2013]
ocr: изменен ответ с FileParsingError на data:null в случае ответа ocr = {}

Release 2.1.684, October 29, 2025

GW-MD-BOARD: новый шлюз с подпиской board.{symbol}+{extra_code}
gw-hist: новый act=update-option-expiration
gw-hist: в act=order/execution/cancel/masscancel/move/algo-order/algo-execution/algo-cancel добавлены поля extra_code, multileg

Release 2.1.673, October 24, 2025

gw-ocr: Rename service gw-llm-http to gw-ocr-http
gw-ocr: Changed endpoint to /be/api/v2/ocr/passport

Release 2.1.661, August 8, 2025

gw-acc: new mandatory field 'is_main' in response /bank-details/list
gw-acc: added POST /bank-details/set-main
gw-acc: added POST /bank-details/delete
gw-acc: added POST /bank-details/update
acc-mgr admin: added optional field is_main into POST /bank-details/
acc-mgr admin: added optional field is_main into PATCH /bank_details/{id}
acc-mgr admin: added GET /bank_details/get?id_person=123 ,id_person is mandatory parameter

Release 2.1.658, October 15, 2025

ref.yaml: add arrays calendars, expiration_moment_list, options
ref.yaml: в массив instruments добавлены поля type_parameters, settle_calendar

Release 2.1.648, October 10, 2025

gw-llm-http: New service gw-llm-http

Release 2.1.X, September 8, 2025

gw-pf: add topics: UpdateOptionExpiration, OptionAssets
gw-pf: add fields: expiration_moment, is_call (option_type), strike_price to topics pos, assets
gw-pf: new client frame update-option-expiration
gw-pf: rm op: move
gw-tn: trading: extra_code, multileg
gw-tn: new-order, cancel-order: extra_code

Release 2.1.625, September 26, 2025

corp-mgr: New service copr-mgr

Release 2.1.602, September 15, 2025

corp-loader: New service copr-loader

Release 2.1.601, September 4, 2025

notification: Rename admin POST endpoint: notification/send -> notification/bell/send
notification: New admin PUT endpoint: notification/email/send
notification: Rename client PUT, DELETE endpoint: push/fcm -> notification/fcm
gw-notification: New client PUT, DELETE endpoint: notifications/fcm
notification: Rename admin tables:

notifications -> bell
notifications_recipients -> bell_recipients
notifications_templates -> bell_templates
push_feature_flags -> notification_feature_flags
push_whitelist -> notification_whitelist
notifications_templates -> bell_templates
notifications_templates -> bell_templates

notification: New admin tables: email_templates

Release 2.1.X, September 4, 2025

notification: add person_id array in req body for notifications/send

Release 2.1.X, August 13, 2025

promo-manager: new empty response for /promo/check_promise

Release 2.1.534, August 8, 2025

GW-PF: new message scheme MarginSettlement

Release 2.1.520, August 4, 2025

/acc/prop/get: new prop REFERRAL_CODE
/reg/reg: new optional referral_code field
New admin PATCH endpoint /promo/referrals/{id}

Release 2.1.508, July 29, 2025

GW_ACC: upd /prop/get-from provider enum

Release 2.1.503, July 28, 2025

Assed fields in scheme: Asset, RicomInstrument
Assed fields in scheme: MDUpdate.update_type
Assed procedure: dba.wb_get_papers_m, dba.wb_get_papers_riskrates

Release 2.1.478, July 17, 2025

CANDLES BASE: add /stg-corp-event/external-download
CANDLES BASE: add /stg-corp-event/accept/{key}
CANDLES BASE: add /stg-corp-event/deny/{key}

Release 2.1.472, July 16, 2025

ACC MGR: Update records by filters
CANDLES BASE: Update records by filters
CANDLES BASE: Delete records by filters
Feature: Update records by filters
Feature: Delete records by filters
PROMO: Update records by filters
PROMO: Delete records by filters
REPORT: Update records by filters
QUESTIONNAIRE: Update records by filters
PUSH: Update records by filters
PUSH: Delete records by filters

Release 2.1.466, July 11, 2025

gw-reg: added factor params into /credential/add response
gw-reg: added /credential/refresh servlet
gw-auth: added /refresh-factor servlet
gw-auth: added field is_current into /sessions response
gw-acc: added /prop/refresh-factor servlet
gw-acc: added factor params into /prop/set, /prop/get response

Release 2.1.462, July 11, 2025

promo-manager: added new error codes

Release 2.1.455, July 9, 2025

promo-manager: new error response for /submit {id: 1408, code: DontMeetTermsOfPromotion, message: "You don't meet the terms of the promotion", http_code: 400}

Release 2.1.446, July 3, 2025

gw-notification: added be API
wb-notification: added admin API

Release 2.1.410, June 17, 2025

tc/commands/ricom-full-instruments: add instr_types in requestBody

Release 2.1.403, June 11, 2025

promo-manager: added admin CSV API
promo-manager: new right for CSV API promo.table.csv

Release 2.1.388, June 3, 2025

push-events: added admin API

Release 2.1.369, May 28, 2025

gw-acc: added PATCH request /push/settings

Release 2.1.361, May 26, 2025

ref-gen: added new field equity_type

Release 2.1.215, Jan 20, 2025

tm admin: added field price to /admin-transfer and new enum value USE_ASSET_PRICE

Release 2.1.207, Jan 15, 2025

gw-tn topic "trading": added field cancel_reason to frames with exec_type='cancel'

Release 2.1.107, Sep 18, 2024

gw-tn topic "trading": changed type of child_order_no to string

Release 2.1.12, May 27, 2024

gw-tn topic "trading": new field child_order_no

Release 2.1.0, May 2, 2024

gw-hist: new field child_order_no, algo_status changed type to enam

Release 2.0.0, April 9, 2024

Setting null by key NATURAL_OTHER_NAMES is allowed in /acc/prop/set

Release 1.39.0, March 19, 2024

version bump

Release 1.38.115, May 27, 2024

New admin endpoint /report/report-file/download/{id}

Release 1.38.113, May 27, 2024

admin: new filed type LONG

Release 1.38.111, May 24, 2024

new report client gw
new report admin

Release 1.38.96, May 13, 2024

orderkeeper admin: order_id changed type to string

Release 1.38.46, April 8, 2024

New admin endpoint /tm/admin-withdraw
Improvments in /tm/admin-transfer

Release 1.38.29, March 28, 2024

New field updateConversion in /tc/{table}/meta

Release 1.38.27, March 27, 2024

New admin bulk update PATCH /tc/{table}

Release 1.38.25, March 27, 2024

New optional field settle_date in /tm/admin-transfer

Release 1.38.13, March 18, 2024

New admin /accmgr/ endpoints

Release 1.38.12, March 18, 2024

New admin endpoint /tm/admin-transfer
New param field market.time_zone in ref.json

Release 1.38.0, February 26, 2024

New admin endpoints /accmgr/replication/*
New admin endpoints /ricomtransfers/*
New admin endpoints /ordkeeper/*

Release 1.37.10, February 17, 2024

Protocol update in all ws gateways:

Gateways always return json. No "bad format".
'status' filled with an error code similar to http gateways. No "status: -1".
Filed 'text' replaced with 'message'. The field contains the error text. It is not recommended to use this field in auto-processing.
Fields 'status', 'message', 'details' filled similar to http gateways.
Each 'op: data' response contains a 'timestamp'
More detailed errors while validation of commands new-order/cancel-order in gw-tn

Release 1.37.0, February 5, 2024

New advanced filters in admin RestAPI
New data type in /meta FLAGS

Release 1.36.0, January 15, 2024

/auth/logout: added param mode
new endpoint /auth/destroy-session

Release 1.35.0, December 12, 2023

Added multiple authentication using one login
new endpoint /auth/sessions
/acc/account/list: added fields ext_account_code, broker_contract_date to list of contracts
admin: remove editable from /meta

Release 1.34.18, December 12, 2023

CRUD admin: id in PATCH request moved from body to url

Release 1.34.16, December 6, 2023

/acc/prop/: new prop LOGIN_CL_LOGIN

Release 1.34.8, November 27, 2023

tc: Changeed isCreatable, isModifiable values

Release 1.34.0, November 21, 2023

ref: added field group_mask in instruments
ref: added possibility to GET property PERSON_GROUP_MASK in gw-acc
Admin CU: Clients Page added
Admin CU: System Events Page added
Admin CU: Session calc Page added
Admin CU: Transfer Manager Page added
New admin API poskeeper

Release 1.33.19, November 17, 2023

/tc/ricom-full-instruments -> /tc/commands/ricom-full-instruments

Release 1.33.13, November 16, 2023

Added POST and PATCH to sess-calc RestAPI

Release 1.33.5, November 2, 2023

gw-tn topic 'trading': changed type of 'order_no' from int64 to string

Release 1.33.3, November 2, 2023

Rename details.property -> details.field in errors

Release 1.33.0, October 31, 2023

Moved field 'token' in /auth/logout request from http header to http body

Release 1.32.90, October 31, 2023

New admin CRDU API for sess-calc

Release 1.32.82, October 25, 2023

gw-tn topic trading: possible values of field 'text' in messages with exec_type="cancel" are: "cancelled", "rejected", "part cancelled". Value "part cancelled" added.

Release 1.32.70, October 18, 2023

ref: added list of market in instruments

Release 1.32.33, October 6, 2023

Fixed mistake in swagger: /admin/api/v1/auth/token -> /admin/api/v1/auth/ping

Release 1.32.0, September 19, 2023

Token moved to http header Authorization
API versioning in client gateways
Add /acc/user-action/deactivate
New payment_system='sbp' in /input
New field 'revision' in ws logon
New topic assets in gw-pf
New field exec_market in topic trading in gw-tn
New field instruments.is_active in /ref
New field editable in /meta
New mode CALCULATED in /meta
Added update tables to /tc
New /tc endpoints:
- activate, deactivate of instruments
- accept, deny to all update tables
- /tc/replication/status
- /tc/replication/on
- /tc/replication/off

Release 1.31.23, September 8, 2023

/auth/create-token: increased length of field role up to 256

Release 1.31.18, September 5, 2023

tc, acc-mgr: new properties array, foreignKey in /meta

Release 1.31.13, September 4, 2023

gw-tn: new time_in_force value 'GTC'

Release 1.31.7, August 29, 2023

Changes in /tc and /acc-mgr:
- offset, limit -> page, per_page
- MetaField(LONG) -> MetaField(NUMBER)
- GET /{table}/get -> GET /{table}/{id}
- POST /{table}/add -> POST /{table}
- POST /{table}/update -> PATCH /{table}

Release 1.31.0, August 22, 2023

/api/v1/fund/input: added new value "ricom" for param pay_system and new response format
Added admin group "System events" with commands: /events, /new-event, /delete-event
Added admin group "ACC MGR" /admin/api/v1/accmgr/*

Release 1.30.10, July 31, 2023

New endpoint /auth/refresh-token
Added field refresh_token on SUCCESS responses in /auth

Release 1.30.0, July 25, 2023

New properties in /acc/prop/set и /acc/prop/get : CONTACT_AGREEMENT, TFA_INFO_QUESTION1, TFA_INFO_ANSWER1, TFA_INFO_QUESTION2, TFA_INFO_ANSWER2, TFA_INFO_QUESTION3, TFA_INFO_ANSWER3
Extended list of allowed characters for some properties in /acc/prop
In /auth, the response format has been changed to an array of objects, support for new factors has been added
Removed obsolete endpoints /acc/account/rename /auth/login
Changed field optionality in /acc/bank-details/create
Completely new /tc API. The old one has been removed.
Phone uniqueness check separately for verified clients and separately for non-verified clients
Changed the optionality of properties in /acc/user-action
Added field profit to ws topic 'pos'

Release 1.29.9, July 5, 2023

Changed notification of client properties and TFA factors. No backwards compatibility

Release 1.29.0, June 27, 2023

New optional param token_parent in /auth/create-token
Changes in /acc:
- Added endpoint /acc/bank-details/create
- Added endpoint /acc/bank-details/list

Release 1.28.0, May 30, 2023

Removed /withdraw command from gw-pf (BTC)
Added /withdraw command to gw-fund (BTC and RICOM)

Release 1.27.13, May 12, 2023

Removed arg orig_user_login from /proh/prohibitions/delete

Release 1.27.0, May 2, 2023

Extension of enums: object_type, prohibited_object_type in proh
Changed http codes for status != 0
acc: NaturalResident "1" -> "true"

Release 1.26.0, April 3, 2023

Changes in /acc/prop/:
- Added endpoint /account/prop/set
- Changed format of /account/list
- Endpoint /account/rename is deprecated
- Property ContactBirthday replaced with NaturalBirthday
- Property ContactBirthPlace replaced with NaturalBirthPlace
- New property NaturalNaturalPersonStatus
- New properties NaturalVerified*
Added new action Update to /user-action
Added field settle_date to topic pos of gw-pf
Added delimiters _ to all upprcase constants:
- /api/v1/acc/prop/*: all properties (e.g. СONTACTPHONECODE -> CONTACT_PHONE_CODE)
- ref.yaml: markets[i].type (e.g. EXTERNALMARKET -> EXTERNAL_MARKET)
- ref.yaml: assets[i].type (e.g. CRYPTOCURRENCY -> CRYPTO_CURRENCY)
- /api/v1/auth/add-factor: factors (e.g. TFAINFOEMAIL -> TFA_INFO_EMAIL)
- /admin/api/v1/order/*: NEW_ORDER.direction (e.g. SENDERTOADMIN -> SENDER_TO_ADMIN)
- gw-md topic stat: update_type (e.g. OPENPRICE -> OPEN_PRICE)
- gw-pf topic transfers: status (e.g. WAITOPERATORACCEPT -> WAIT_PAYMENT_ACCEPT)
- the list may not be complete
/candles has changed, documentation will be updated later
timestamp fields has changed, documentation will be updated later

Release 1.25.0, March 7, 2023

New UI of the index page
Changed base paths in url:
- separating admin from public API (/api/v1/admin/ -> /admin/api/v1/)
- move all gw-ws to /api/v1/ws/
New properties in /acc/prop/:
- NaturalCitizenship
- NaturalGender
- NaturalResident
- NaturalInnCode
- DocumentSerDoc
- DocumentSubdivisionCode
- ContactBirthPlace
- ContactSpecialWord
- AccBkrBrokerContractId
- AccBkrDepositoryContractId
- PersonPersonStatus
New endpoint /acc/user-action
New admin endpoints:
- /order/list
- /order/execute
Changes in gw-md:
- New topics: heartbeat, tob.{market}, stat.{market}, dom.{market}/{symbol}, trades.{market}/{symbol}
- Added filed market to payload
Changes in gw-tn:
- Updated fields in the documentation
- Extension of enum ord_type
- Added fields for algo to newOrder message: expired_moment, stop_price, trail
- Trading topic format has been divided into 3 parts by exec_type (new/cancel/trade)
- Added fields to trading payload: order_no, trade_no, expired_moment, stop_price_initial, stop_price, trail, algo_status
- Field timestamp contains the time of matching
Added op field to gw-ws responses
Changes in ref.yaml:
- Field type added to instruments[]
- Added markets[] array

Release 1.24.6, February 13, 2023

Removed 2 admin proh endpoints: /active-prohibition, /active-prohibitions

Release 1.22.0, February 6, 2023

New param updateId in candles , poshist
Changes in request format of candles
New endpoint /admin/proh/prohibitions/delete
Old "CU Admin" deleted
New page Market Data in CU Admin

Release 1.21.21, February 2, 2023

Fixed collapse of messages while issuing of executions from gw-tn in snapshot mode in topic="trading"
Added issuing of executions on all active orders from gw-tn in snapshot mode in topic="trading"

Release 1.21.19, January 31, 2023

Change in field 'market' of command new-order in gw-tn . New default value BEX instead of WB. Optional field. Use default or nothing.

Release 1.21.10, January 24, 2023

Fixed error in /admin/tc/instrument . Fields code, mask_halt_group replaced with ticker, group_mask
Added attribute is_primary for currencies in ref
Update doc for /acc/prop/

Release 1.21.0, January 11, 2023

Replace of PropTFALevels* with PropTFAUser* in gw-acc
Delete field tfa-level in /prop/get
Changes in response format of poshist
New gw admin/proh/
Changes in response format of /admin/roles
Removed redundant messages in gw-tn in topic 'trading'

Release 1.20.1, December 14, 2022

Changes in gw-acc:
- New endpoint /prop/add-factor
- Updated endpoint (only response) /prop/set
- Updated endpoint (only response) /prop/get

Release 1.19.0, November 30, 2022

Upgrade UI of this API page. Separation of Swagger into:
- public
- admin
- backdoor
Changes in new admin UI: improved candle chart, added section with rights and roles
New API of gw-auth (full backward compatibility):
- Endpoint /auth/login is deprecated. It will be removed in future releases.
- New Endpoint /auth/create-token
- New Endpoint /auth/add-factor
Changes in ref.yaml :

New field 'ticker' instead of 'code'
Field code is deprecated. It will be removed in future releases.
New array equity_issues[]

Release 1.18.0, October 18, 2022

New money input function in gw-fund
Single password check during registration
New admin GUI (link in header)

Release 1.17.0, September 14, 2022

New poshist http gw

Release 1.16.0, Jule 19, 2022

New API of gw-reg (no backward compatibility):

Updated request reg/reg
Delete request reg/reg-confirm
Added request reg/credential/add
Added request reg/credential/delete
Added request reg/credential/confirm
Added request reg/submit
Added request reg/status

New field exi_id in request of auth/login
New admin file with SMS/email codes: passcodes.json

Release 1.15.0, June 10, 2021

Added instruments AAPL, GOOG, etc
Browsing / searching users in admin gui
Searching instruments in admin gui

Release 1.14.0, December 24, 2020

New commands for start/stop bot_deal and bot_mm in CU Admin

Release 1.13.0, September 28, 2020

New page in CU Admin: view roles and rights
New page in CU Admin: viewing and editing instruments

Release 1.12.0, July 6, 2020

Fix URL generation of candles json file
Add ping to REST API
Add field role to login
Auto logout after make-person-verified

Release 1.11.0, January 30, 2020

New admin UI with authorization, scheduling CU jobs, cutter job

Release 1.10.0, November 6, 2019

New format of reference book . Block `assets` is deprecated.
Added admin WB Live Structure GUI
Admin cron cu functions

Release 1.9.0, August 16, 2019

Increased stability of http-gw. Fixed 2 multithreading errors.
Added description of stat topic in asyncapi
Fixed field order in md-gw
API change: new field side_buy (documentation not yet updated)
API change: ts format has changed (documentation not yet updated)
API change: OpenInterest (documentation not yet updated)

Release 1.8.4, June 13, 2019

Technical update

Release 1.8.3, June 6, 2019

Added topic stat to md for obtaining statistical information about instrument. You can subscribe to all instruments and to specific one. It is recommended to be used instead of tob, in case when minimum delay is not required.

Release 1.8.1, April 29, 2019

Rename Instrument codes (example: BTC/USDT -> BTCUSDTFX)
Rename Instrument/Asset codes from (example: ERC20-TEST01I -> ERC20TEST01I)
Added new-order price multiplicity check

Release 1.8.0, April 16, 2019

Anonymous deals snapshot size increased to 50 instead of 10
Added attribute of main cryptocurrency to ref (Asset.is_primary)
Fixed object_not_found error when trying to cancel order

Release 1.7.2, April 4, 2019

Fix OBJECT_NOT_FOUND error in CancelOrder

Release 1.7.1, April 3, 2019

Added field 'amt_initial' to topic 'trading' in tn-gw (mean_price = total_value / (amt_init - amt_rest))

Release 1.7.0, April 3, 2019

Fixed freezing problem with trades
Added field 'total_exec_value' to reply of tn-gw with exec_type='new'/'trade'
Prohibit orders with nonpositive amount

Release 1.6.0, March 29, 2019

Added more detailed filling of fields net_trades,net_transfers,margin_value,open_price in topic pos
Added token auto prolongation if user connected to ws gw(tn-gw, pf-gw) or send request to http gw (gw-acc, gw-fund) about every 2 min. Token lifetime changed from 1 day to 5 min.
New HTTP API function reference book with instruments,assets,trade modes.
Added 100 last 'trade' to snapshot in topic trading

Release 1.5.0, March 15, 2019

Ws documentation is structured
Fix the freezing problem during a client registration
Added candles json files to REST API

Release 1.4.0, March 04, 2019

Add websocket API documentation
Add transfers between accounts of one user (move command) in pf-gw
Add ping from all ws gateways (system frame for disconnection prevention)
Add market order support (earlier all new-orders with ord_type='MARKET' processed like ord_type='LIMIT' with 0 price)

Release 1.3.0, February 21, 2019

Migration to production ready matching unit with risks checks. Clordeid must be unique per user. Added cross-market check.

Added admin function for inputting asset to any account for testing purposes. /api/v1/admin/create-input-transfer

Added 2 topics in gw-pf:

'money' - estimation of all user assets in main currency
'pos' - position for all user assets

Release 1.2.0, January 30, 2019

In all ws gateways:

removed use of supertoken
forbidden repeated login

New HTTP API functions:

/api/v1/acc/account/create
/api/v1/acc/account/rename
/api/v1/admin/get-new-hotwallet-address

Implimented BTC input/withdraw operations:

New ws topic "transfer" (table of transfers)
Send withdraw BTC request as ws frame
For performing inputs read "Testing input/withdraw BTC" in API homepage
use /admin functions for testing input/withdraw
No ws API doc ready yet. See python examples

Release 1.1.2, January 28, 2019

Fixed issuing of anonymous trades in online.
Added bandwidth limitation of market data.

Release 1.1.1, December 25, 2018

Auth token expiry time increased from 5 min to 1 day.

Release 1.1.0, December 14, 2018

New API:

/api/v1/acc/account/list
/api/v1/fund/input-address/create
/api/v1/fund/input-address/list
/api/v1/admin/reserve-input-address
/api/v1/admin/get-new-crypto
/api/v1/admin/crypto/generate-blocks
Added DOM(depth of market) in md ws. New topic 'dom/{instrument}'.

Fix:

Fixed. Field token removed from response on method /reg/reg if status not 0.
Fixed. CORS error in admin script

Short tutorial for using BTC core client on Wonder Birga API page top. It will be useful in subsequent releases with input/withdraw BTC functionality.

Release 1.0.1, December 6, 2018

Fixed. Support registration/authorization of user with uppercase login
Fixed. Fix swagger API method calls. Replace default server 'localhost' with current '/'

Release 1.0.0, December 5, 2018

First release with documentation for HTTP methods:

/api/v1/reg/reg
/api/v1/reg/reg-confirm
/api/v1/acc/prop/set
/api/v1/acc/prop/get
/api/v1/auth/login
/api/v1/auth/logout
/api/v1/admin/make-person-verified