One Trading WebSocket Streams API
Real-time WebSocket API for market data (order book, price ticks, book ticker) and, after authenticating, private trading events (order lifecycle, trades, settlement, funding payments, balance adjustments).
AsyncAPI Specification
asyncapi: 2.6.0
info:
title: One Trading WebSocket Streams API
version: '1.0'
description: >-
Real-time WebSocket (WSS) API for the One Trading exchange. Clients receive
market data feeds (order book, price ticks, book ticker) and, after
authenticating, private trading event streams (order lifecycle, trade
execution, settlement, funding payments, balance adjustments). Orders can be
created and cancelled over the same connection.
Provenance: reconstructed by API Evangelist from the provider's public
documentation index (https://docs.onetrading.com/llms.txt) and the WebSocket
authentication page (https://docs.onetrading.com/websocket/authenticate.md).
Message payload shapes below reflect the documented channel catalog; this is
not the provider's official AsyncAPI document.
x-provenance:
generated: '2026-07-20'
method: generated
source:
- https://docs.onetrading.com/llms.txt
- https://docs.onetrading.com/websocket/authenticate.md
servers:
production:
url: streams.fast.onetrading.com
protocol: wss
description: One Trading production WebSocket endpoint (wss://streams.fast.onetrading.com)
defaultContentType: application/json
channels:
/:
description: >-
Single multiplexed WebSocket connection. Clients send AUTHENTICATE and
SUBSCRIBE control messages and receive market-data and (once authenticated)
private trading events. All messages carry a "type" discriminator.
subscribe:
operationId: receiveEvents
summary: Messages the server sends to the client.
message:
oneOf:
- $ref: '#/components/messages/Authenticated'
- $ref: '#/components/messages/OrderBookSnapshot'
- $ref: '#/components/messages/OrderBookUpdate'
- $ref: '#/components/messages/PriceTick'
- $ref: '#/components/messages/BookTick'
- $ref: '#/components/messages/OrderBooked'
- $ref: '#/components/messages/OrderRejected'
- $ref: '#/components/messages/OrderClosed'
- $ref: '#/components/messages/OrderFullyFilled'
- $ref: '#/components/messages/TradeExecuted'
- $ref: '#/components/messages/Settlement'
- $ref: '#/components/messages/FundingPayment'
- $ref: '#/components/messages/BalanceAdjustment'
- $ref: '#/components/messages/ErrorMessage'
publish:
operationId: sendCommands
summary: Messages the client sends to the server.
message:
oneOf:
- $ref: '#/components/messages/Authenticate'
- $ref: '#/components/messages/Subscribe'
- $ref: '#/components/messages/Ping'
- $ref: '#/components/messages/CreateOrder'
- $ref: '#/components/messages/CancelAllOrders'
- $ref: '#/components/messages/CancelOrderByOrderId'
- $ref: '#/components/messages/CancelOrderByClientId'
- $ref: '#/components/messages/MoveOrder'
- $ref: '#/components/messages/MarginUpdate'
components:
messages:
Authenticate:
name: AUTHENTICATE
summary: Authenticate the connection with an API token (Trade permission required).
payload:
type: object
properties:
type: { type: string, const: AUTHENTICATE }
api_token: { type: string }
required: [type, api_token]
Authenticated:
name: AUTHENTICATED
summary: Authentication succeeded.
payload:
type: object
properties:
type: { type: string, const: AUTHENTICATED }
Subscribe:
name: SUBSCRIBE
summary: Subscribe to one or more channels for a set of instruments.
payload:
type: object
properties:
type: { type: string, const: SUBSCRIBE }
Ping:
name: PING
summary: Keep-alive ping; server replies with PONG.
payload:
type: object
properties:
type: { type: string, const: PING }
CreateOrder:
name: CREATE_ORDER
summary: Create an order over the WebSocket connection.
payload:
type: object
properties:
type: { type: string, const: CREATE_ORDER }
instrument_code: { type: string }
side: { type: string, enum: [BUY, SELL] }
amount: { type: string }
price: { type: string }
client_id: { type: string, format: uuid }
CancelAllOrders:
name: CANCEL_ALL_ORDERS
payload:
type: object
properties:
type: { type: string, const: CANCEL_ALL_ORDERS }
CancelOrderByOrderId:
name: CANCEL_ORDER
payload:
type: object
properties:
type: { type: string, const: CANCEL_ORDER }
order_id: { type: string, format: uuid }
CancelOrderByClientId:
name: CANCEL_ORDER_BY_CLIENT_ID
payload:
type: object
properties:
type: { type: string, const: CANCEL_ORDER_BY_CLIENT_ID }
client_id: { type: string, format: uuid }
MoveOrder:
name: MOVE_ORDER
summary: Move (reprice) an existing order.
payload:
type: object
properties:
type: { type: string, const: MOVE_ORDER }
MarginUpdate:
name: MARGIN_UPDATE
summary: Update margin on a futures position.
payload:
type: object
properties:
type: { type: string, const: MARGIN_UPDATE }
OrderBookSnapshot:
name: ORDER_BOOK_SNAPSHOT
summary: Full order book snapshot for a subscribed instrument.
payload:
type: object
properties:
type: { type: string, const: ORDER_BOOK_SNAPSHOT }
instrument_code: { type: string }
OrderBookUpdate:
name: ORDER_BOOK_UPDATE
summary: Incremental order book update.
payload:
type: object
properties:
type: { type: string, const: ORDER_BOOK_UPDATE }
instrument_code: { type: string }
PriceTick:
name: PRICE_TICK
summary: Trade price tick for a subscribed instrument.
payload:
type: object
properties:
type: { type: string, const: PRICE_TICK }
instrument_code: { type: string }
price: { type: string }
BookTick:
name: BOOK_TICK
summary: Best bid/ask (top-of-book) update.
payload:
type: object
properties:
type: { type: string, const: BOOK_TICK }
instrument_code: { type: string }
OrderBooked:
name: ORDER_BOOKED
summary: An order was accepted and booked.
payload: { $ref: '#/components/schemas/OrderEvent' }
OrderRejected:
name: ORDER_REJECTED
summary: An order was rejected.
payload: { $ref: '#/components/schemas/OrderEvent' }
OrderClosed:
name: ORDER_CLOSED
summary: An order was closed/cancelled.
payload: { $ref: '#/components/schemas/OrderEvent' }
OrderFullyFilled:
name: ORDER_FULLY_FILLED
summary: An order was fully filled.
payload: { $ref: '#/components/schemas/OrderEvent' }
TradeExecuted:
name: TRADE_EXECUTED
summary: A trade was executed against one of the client's orders.
payload:
type: object
properties:
type: { type: string, const: TRADE_EXECUTED }
instrument_code: { type: string }
amount: { type: string }
price: { type: string }
Settlement:
name: SETTLEMENT
summary: A futures settlement event.
payload:
type: object
properties:
type: { type: string, const: SETTLEMENT }
FundingPayment:
name: FUNDING_PAYMENT
summary: A futures funding payment was applied.
payload:
type: object
properties:
type: { type: string, const: FUNDING_PAYMENT }
BalanceAdjustment:
name: BALANCE_ADJUSTMENT
summary: An account balance was adjusted.
payload:
type: object
properties:
type: { type: string, const: BALANCE_ADJUSTMENT }
ErrorMessage:
name: ERROR
summary: Error envelope; carries a single machine-readable code.
payload:
type: object
properties:
error: { type: string, example: AUTHENTICATION_FAILED }
schemas:
OrderEvent:
type: object
properties:
type: { type: string }
order_id: { type: string, format: uuid }
client_id: { type: string, format: uuid }
instrument_code: { type: string }
side: { type: string, enum: [BUY, SELL] }
price: { type: string }
amount: { type: string }
status: { type: string }