Changelog

This documentation is maintained based on BFX Exchange · API Integration Documentation.

v1.0.8 · 2026

• 2.1 Common Conventions: added a "Time Format" section — RFC3339 fractional-second digits are not fixed and must be parsed with a general-purpose parser; empty values are returned as null.
• 2.5 Wallet Transfer (Deposit / Withdraw): added error codes 10040 (a request with the same ticket_id is in flight) and 10050 (same ticket_id sent with a different amount / currency).
• 2.5 Wallet Transfer (Deposit / Withdraw): added "Idempotency and Deduplication Rules" — the dedup key includes the transaction type, amount and currency must match exactly, and X-Idempotency-Key plays no part in transfer idempotency.
• 2.6 Common Integration Errors and 3.6 Query APIs Error Reference: added 10040 and 10050.
• 3.1 Bet Ticket Query: clarified the semantics of settled_time and updated_at, added an "Order Level vs. Trade Level" section and how to query voided bets.
• 3.2 Wallet Transfer Records: added the id, source_id, source_id_type, kind, and order_ids response fields, plus "order_ids Behavior" and "Incremental Reconciliation" sections.
• 3.2 Wallet Transfer Records: corrected BET_CANCEL_VOID_REFUND to BET_CANCEL_REFUND, added ADMIN_CANCEL_REFUND and ADMIN_CANCEL_CLAWBACK, and marked RE_SETTLEMENT_PAYOUT / MARKET_SUSPEND_REFUND as reserved values.
• 3.3 Transaction Status Query: clarified that 10030 covers both "does not exist" and "not yet posted", and added the rate-limit note.
• Rate-limit notes across the query APIs now state explicitly that the quota is counted per api_key × endpoint.
• 05 / FAQ: added 5.10 "How long after a rollback does re-settlement happen" and 5.11 "Final status when an event is cancelled".

v1.0.7 · 2026

• 3.1 Bet Ticket Query: completed the items[] and trades[] response fields, and added an amount calculation formula section.
• 2.1 Login: added the lang request parameter (specifies the initial game UI language).
• 2.5 Wallet Transfer (Deposit / Withdraw): added notes on transaction failure and refund handling.
• 01 / Integration Flow: clarified that an agent is bound to a single currency, which cannot be changed after account creation.
• 05 / FAQ: added 5.1 "Which languages are currently supported".
• 05 / FAQ: added 5.9 "Sports Prediction Market Rules" (price as probability, settlement, three steps, commission calculation).

v1.0.6 · 2026

• Added 03 / Query APIs (Optional): Bet Ticket Query, Wallet Transfer Records Query, and Transaction Status Query, with a dedicated error reference.
• Corrected the mid_rate exchange-rate direction definition in 3.1 Bet Ticket Query (1 USD = mid_rate in player currency).
• Currency Docs: removed the duplicate primary currency table and consolidated into a single complete list.
• Login, Balance Query, and Wallet Transfer (Deposit / Withdraw): currency notes now link to the currency docs.

v1.0.5 · 2026

• Expanded 1.1 Submit Application: added a complete application checklist including master agent / agent details, wallet type, currency, IP allowlist, and how account-creation details are returned.
• Added 1.1.1 IP Allowlist Notes: distinguishes the front-end (machine integration) and back-end (staff login) allowlists, with CIDR format notes.

v1.0.4 · 2026

• Expanded the supported currency list (added LKR, PKR, KES, INR, ZAR, HKD, PGK, AUD, CAD, NZD, SGD, EUR, GBP, and more).

v1.0.3 · 2026

• Login + Wallet APIs (Login, Balance Query, Deposit / Withdraw).
• HMAC Signing Flow (JCS + SHA-256 + HMAC-SHA256).
• Integration Flow, Currency Docs, and FAQ.