REST API provides basic set of functions to establish connection, download initial data, create, modify and cancel orders. 11B.io made sure that its REST API is completely sufficient to obtain real-time prices, maintain mirror of your positions and accounts at brokerage via set of simple requests. Ordering requests return completed states and eliminate the need to verify order status and position or account changes caused by execution.

Functionality includes: obtaining account and market data, placing orders, load account exposure. The GET and POST parameters need to be url-encoded. Response details will contain json structures. Certain endpoints are protected from flooding by enforcing 10rps from one IP. For more details - please, see below.

Websocket API is a bit more sophisticated interface as it provides access to streaming prices, messages and lower latency communications. In order to get benefits from being microseconds faster, you will need to implement message handling - prices that you're subscribed for, orders that are executed and positions that created.

The connection can be established using popular socket.io library, check out Javascript and Python implementations. 11B.io Websocket protocol is quite simple, and consists of connecting to wss:// endpoint, subscribing to the data and processing received data in sockets onMessage method.

There is no need to subscribe to messages related to your account; this is implied by connecting. The subscription to market data is done via emiting encoded json request soon after socket is connected. Parameters should contain the list of symbols and quote updates level:

  {type: 'subscribe', symbols: [{symbol: 'EUR/JPY', level: 1 }] }

You should start receiving messages like this one:

['L1',0,'2019-01-06T19:34:53.828539Z',['EUR/JPY',128.115,128.129,0,0]]

To unsubscribe, please, send the unsubscribe message or disconnect the socket. Please, check below Quote object structure for quote structure. Another type of messages that you will receive using this connection will contain field type

{type: 'unsubscribe', symbols: [{symbol: 'EUR/USD', level: 1 },...] }

For example, new position:

{type: 'OP', action: 0, seq: 2, time: '2019-01-06T19:40:59.001994Z', position: {position_id: 27, symbol: 'EUR/USD', side: 'SELL', account_id: 'A00-000-00X', open_price: 1.12997, orig_quantity: 10000, quantity: 10000, open_order_id: 35, open_time: '2019-01-06T19:40:59.001994Z'}}

For messages with type field, please, pay attention to action field:

Also, you need to watch for socket disconnection using OnClose method to protect yourself from connection interrupptions. Please, see below for the WS opening call parameters.

FIX API is for institutional traders integration convenience but its a bit outside of scope of this description. Please, send us a request to api@11b.io along with your email and account name for docs, rules of engagement and dictionary. We support FIX 4.4 with few custom fields additionals added (optional, needed for retail flow support only: position maintenance orders, STOP_LOSS, TAKE_PROFIT order links, etc.)

To use 11B.io API, you will need to register live or demo account and then obtain API_URL, API_ACCOUNT and API_TOKEN (last is for Bearer authorization and optional, another choice is to use our authority server to obtain JWT token) - all via Trading GUI on System -> Settings page.

For your convenience, you can put tokens in config modules, see our examples:

config.js:

const config = {};

// Replace with your API KEY generated on Trading GUI System -> Settings page:
config.API_KEY = '77632e97-2767-4db2-a756-9f42aa0e7084';
config.API_URL = 'http://api.demo.11b.io/api/v1';
//config.API_URL = 'http://api.live.11b.io/api/v1';
config.API_ACCOUNT = 'XXX-XXX-XXX';

module.exports = config;

Make sure your API_TOKEN is secured and safe as it is sufficient enough to gain full control of trading on your account (provided ACCOUNT_ID is also exposed).

GUI only - restricted to JWT Token. Restricted to 1 request per minute.

Broker and Trader settings and collateral.

Trading activity records - open positions, active orders and history

Trading operations - obtaining market data

Trading operations - create, modify and cancel orders

Account Reports