How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

WhiteBIT Spot Trading API

Endpoints for spot trading operations

WhiteBIT Spot Trading API is one of 25 APIs that WhiteBIT publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 20 JSON Schema definitions.

Tagged areas include Spot Trading. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 20 JSON Schemas.

This API exposes 18 operations across 18 paths, and defines 16 schemas. It is described by OpenAPI 3.2.0, at version 4.0.0.

Requests are made against 4 base URLs: https://whitebit.com, https://whitebit.eu, https://whitebit.tr, https://whitebit.ge.

18 operations 18 paths 16 schemas 18 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
4.0.0
Servers
https://whitebit.com
https://whitebit.eu
https://whitebit.tr
https://whitebit.ge
Authentication
API Key, API Key, API Key
Resource Areas
1

Authentication & Security 3

WhiteBIT Spot Trading API declares 3 security schemes for authenticating requests. An API key is passed in the header as X-TXC-APIKEY (ApiKeyAuth). An API key is passed in the header as X-TXC-PAYLOAD (PayloadAuth). An API key is passed in the header as X-TXC-SIGNATURE (SignatureAuth). By default, every request must be authenticated.

  • ApiKeyAuth — The public WhiteBIT API key.
  • PayloadAuth — Base64-encoded JSON request body.
  • SignatureAuth — HMAC-SHA512 signature of the payload, hex-encoded. Computed as hex(HMAC-SHA512(payload, apisecret)).

Paths & Operations 18

Across 18 paths, the API surfaces 18 operations — 18 POST. Each is listed below with its method, path, parameters, and response codes.

Spot Trading 18

Endpoints for spot trading operations

POST
/api/v4/trade-account/balance
Trading Balance
tradeAccountBalance body → 200400422503
POST
/api/v4/order/new
Create Limit Order
createLimitOrder body → 200400422503
POST
/api/v4/order/bulk
Bulk limit order
createBulkLimitOrder body → 200400422503
POST
/api/v4/order/market
Create market order
createMarketOrder body → 200400422503
POST
/api/v4/order/stock_market
Create buy stock market order
createStockMarketOrder body → 200400422503
POST
/api/v4/order/stop_limit
Create stop-limit order
createStopLimitOrder body → 200400422503
POST
/api/v4/order/stop_market
Create stop-market order
createStopMarketOrder body → 200422503
POST
/api/v4/order/cancel
Cancel order
cancelOrder body → 200400422503
POST
/api/v4/order/cancel/bulk
Cancel bulk orders
cancelBulkOrders body → 200400422503
POST
/api/v4/order/cancel/all
Cancel all orders
cancelAllOrders body → 200400422503
POST
/api/v4/orders
Query unexecuted(active) orders
getActiveOrders body → 200400422503
POST
/api/v4/trade-account/executed-history
Query executed order history
getExecutedOrderHistory body → 200400422503
POST
/api/v4/trade-account/order
Query executed order deals
getOrderDeals body → 200400422503
POST
/api/v4/trade-account/order/history
Query executed orders
getOrderHistory body → 200400422503
POST
/api/v4/trade-account/order/history/query
Query delisting and maintenance orders
getDelistingOrderHistory body → 200400422503
POST
/api/v4/order/modify
Modify order
modifyOrder body → 200400422503
POST
/api/v4/order/kill-switch
Sync kill-switch timer
setKillSwitch body → 200400422
POST
/api/v4/order/kill-switch/status
Status kill-switch timer
getKillSwitchStatus body → 200400422

Schemas 16

The contract defines 16 schemas that model the data the API accepts and returns. The most detailed are OrderResponse (25 properties), LimitOrderRequest (13 properties), BulkOrderItem (11 properties), ExecutedDeal (11 properties). Each schema is shown below with its type and property counts.

LimitOrderRequest
object
13 properties 5 required
OrderStatus
string
Order lifecycle status. FILLED — fully executed. CANCELED — canceled before execution. PARTIALLYFILLED — partially executed, remainder still active. CANCELEDTA…
BulkOrderItem
object
11 properties 3 required
OrderHistoryStatus
string
Order status returned by this endpoint, in uppercase. FILLED — fully executed. CANCELED — canceled before full execution; the endpoint also returns AUTOCANCELE…
CancelOrderResponse
object
Final state of a canceled order.
StopMarketOrderRequest
object
8 properties 6 required
BulkCancelOrderResult
object
Acknowledgement that a single item was canceled. The endpoint echoes the identifiers from the request item and, when available, the order's timestamp and mtime…
5 properties
StockMarketOrderRequest
object
7 properties 5 required
MarketOrderRequest
object
7 properties 5 required
ErrorResponse
object
3 properties
BulkCancelOrderItem
object
A single cancel target. Provide market and exactly one of orderId or clientOrderId. Sending both, or neither, returns a per-item validation error.
3 properties 1 required
ExecutedDeal
object
11 properties
BulkLimitOrderResponse
array
BulkCancelOrderResponse
array
Per-item cancel results. response[i] corresponds to request.orders[i]. Each item contains either result (cancellation succeeded) or error (cancellation failed…
StopLimitOrderRequest
object
10 properties 6 required
OrderResponse
object
Shared order shape returned by the order-creation, cancel, active-orders list, and modify endpoints. Field presence varies by endpoint and order type — see the…
25 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

whitebit-spot-trading-api-openapi.yml Raw ↑

Other APIs WhiteBIT publishes across the network.

WhiteBIT WebSocket API
WhiteBIT Account Endpoints API
WhiteBIT Address Checker API
WhiteBIT Authentication API
WhiteBIT Codes API
WhiteBIT Collateral Trading API
WhiteBIT Convert API
WhiteBIT Credit Line API
WhiteBIT Crypto Lending - Fixed API
WhiteBIT Crypto Lending - Flex API
WhiteBIT Deposit API
WhiteBIT Fees API
Where this information came from

This is an independent, third-party profile of WhiteBIT Spot Trading API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.