Trading

All endpoints in this section require authentication

Order types

Market — an order that the Client makes through Order Book to buy or sell Symbol immediately at the best price currently available. The Price field should be missing if the order type is Market. Please contact our support or your account-manager if you need market order type or additional order types.

Limit — an order placed by Client through Order Book to buy or sell an amount of current trading pair at a specified price or better. Both quantity and price fields should be filled if the order type is Limit. Because the limit order is not a market order, it may not be executed if the price set by the Client cannot be met during the period of time, in which the order is left open.
 After being placed, Limit orders can be:

  1. Fully executed immediately

  2. Not executed immediately, and left open to be fully of partially executed, or cancelled

  3. Partially executed immediately and have open outstanding amount waiting to be fully or partially executed, or cancelled.

  4. Fill-or-Kill - cancelled completely if not executed immediately.

Stop— a stop order is used to trigger a market sell when the market drops to your trigger price or used to trigger a market buy if the market rises to your trigger price. This is often used as a stop-loss order if the market is moving in an unfavourable direction. Stop orders will fully execute as a market order once the trigger price is reached.

Example: If the current market price is 50 000, the trader in a long position might want to sell if the price drops to 49 900 to avoid further losses. A stop sell at 49 900 will be used in this case.

Example: If the current market price is 50 000, the trader in a short position might want to buy if the price reaches 50 100 to avoid further losses. A stop buy at 50 100 will be used in this case.

Stop-Limit— a stop-limit order triggers a limit order. With a stop-limit, the trader sets a stop price at which the order is triggered and a limit price at which the order may be filled. Once the stop of a stop-limit order is triggered, the limit order is automatically placed.

Example: If a trader would like to buy once the market price reaches 50 000, but not pay more than 50 100, then a stop price of 50 000 and limit price of 51 000 will be specified at the same time using a stop-limit order. If the market price reaches 50 000, the order is triggered and will match the best available asks up to 50 100. If the market price moves to 50 101 or above, then the order may go partially unfilled due to the limit price.

Get trades

Description

This endpoint retrieves your executed trades with its price, volume, and direction. Trades are sorted in reverse creation order.

HttpRequest

GET https://trade.nebulaecn.com/api/v2/backend/market/trades

Request Parameters

Name

Located In

Description

Required

Schema

market

query

string

limit

query

Limit the number of returned trades. Default to 100.

integer

page

query

Specify the page of paginated results.

integer

time_from

query

An integer represents the seconds elapsed since Unix epoch.If set, only trades executed after the time will be returned.

integer

time_to

query

An integer represents the seconds elapsed since Unix epoch.If set, only trades executed before the time will be returned.

integer

order_by

query

If set, returned trades will be sorted in specific order, default to 'desc'.

string

Response Content

Code

Description

Schema

200

Get your executed trades. Trades are sorted in reverse creation order.

Trade

Cancel an order

Description

Submit cancel request, cancels order from orderbook.

HttpRequest

POST https://trade.nebulaecn.com/api/v2/trading/market/orders/cancel/{id|uuid}

Responses

code

description

201

Your cancel request was submitted and awaits for processing

422

Invalid request, make sure every mandatory fields are present

500

Internal Server Error

Cancel orders

Description

Submit cancel request, cancels all your orders from orderbook.

HttpRequest

POST https://trade.nebulaecn.com/api/v2/trading/market/orders/cancel

Request Parameters (JSON)

param

type

desc

market

string

market id

side

string

buy or sell

Responses

code

description

200

Your cancel request was submitted and awaits for processing

422

Invalid request, make sure every mandatory fields are present

500

Internal Server Error

Example

curl -X POST https://trade.nebulaecn.com/api/v2/trading/market/orders/cancel/1 \
-H 'Content-Type: application/json'
curl -X POST https://trade.nebulaecn.com/api/v2/trading/market/orders/cancel/b47d2527-5a0c-11ea-822c-1831bf9834b0 \
-H 'Content-Type: application/json'

Create an order

Description

Submit a new order to API. Notice that while the response from the server is ok, the order can still be rejected by the matching engine. You should wait the confirmation from the websocket to be sure that your order has been added to the orderbook.

HttpRequest

POST https://trade.nebulaecn.com/api/v2/trading/market/orders

Request Parameters (JSON)

param

type

desc

market

string

market id

side

string

buy or sell

amount

decimal

valid decimal value

type

string

market, limit, post_only

price

decimal

valid decimal value

Response Content

Code

Description

201

Your order was submitted and awaits for processing

400

Bad request, make sure the JSON syntax of your request is correct

422

Invalid request, make sure every mandatory fields are present

500

Internal Server Error

Example Request

curl -X POST https://trade.nebulaecn.com/api/v2/trading/market/orders \
  --data '{"market":"btcusd", "amount":"1.0","type":"limit", "side":"sell", "price":"1"}' \
  -H 'Content-Type: application/json'

Example Answer (JSON)

{
 "uuid":"b436163d-5c73-11ea-be71-1831bf9834b0",
 "side":"sell",
 "type":"limit",
 "market_id":"btcusd",
 "volume":"1",
 "price":"1",
 "state":"pending",
 "created_at":1583146260
 }

Create a list of orders

Description

Bulk api to create a list of orders in one request. The default limit is set to 100 orders for one request, this might be configured by support.

HttpRequest

POST https://trade.nebulaecn.com/api/v2/trading/market/bulk/orders

Request Parameters (JSON)

param

type

desc

[]

[]object

array of order params (refer to create order params)

Responses

code

description

201

Your order was submitted and awaits for processing

422

Invalid request, make sure every mandatory fields are present

413

Request entity too large. Your request contains too much orders.

500

Internal Server Error

Example

curl -X POST https://trade.nebulaecn.com/api/v2/trading/market/bulk/orders \
  --data '[{"market":"btcusd", "amount":"1.0","type":"limit", "side":"sell", "price":"1"}, {"market":"btcusd", "amount":"1.0","type":"limit", "side":"sell", "price":"1"}]' \
-H 'Content-Type: application/json'
[{"uuid":"b76aef45-5c73-11ea-be71-1831bf9834b0","side":"sell","type":"limit","market_id":"btcusd","volume":"1","price":"1","state":"pending","created_at":1583146265},{"uuid":"b76afa8b-5c73-11ea-be71-1831bf9834b0","side":"sell","type":"limit","market_id":"btcusd","volume":"1","price":"1","state":"pending","created_at":1583146265}]

Cancel orders by UUID

Description

Bulk api to cancel orders.

HttpRequest

DELETE https://trade.nebulaecn.com/api/v2/trading/market/bulk/orders

Request Parameters (JSON)

param

type

desc

[]

[]string

Order UUIDs to cancel

Responses

code

description

200

Your cancel requests were submitted and await for processing

422

Invalid request, make sure every mandatory fields are present

413

Request entity too large. Your request contains too much orders.

500

Internal Server Error

Example

curl -X DELETE https://trade.nebulaecn.com/api/v2/trading/market/bulk/orders \
 --data '["580d891d-5c8b-11ea-a012-1831bf9834b0", "580d891d-5c8b-11ea-a012-1831bf9834b0"]' \
-H 'Content-Type: application/json'
"orders.cancel.accepted"

Cancel orders by ID

Description

Bulk api to cancel orders.

HttpRequest

DELETE https://trade.nebulaecn.com/api/v2/trading/market/bulk/orders_by_id

Request Parameters (JSON)

param

type

desc

[]

[]integer

Array of ids to cancel

Responses

code

description

200

Your cancel requests were submitted and await for processing

422

Invalid request, make sure every mandatory fields are present

413

Request entity too large. Your request contains too much orders.

500

Internal Server Error

Example

curl -X DELETE https://trade.nebulaecn.com/api/v2/trading/market/bulk/orders_by_id \
--data '[1, 2, 3, 4]' \
-H 'Content-Type: application/json'
"orders.cancel.accepted"

Get orders

Description

Get your orders, result is paginated.

HttpRequest

GET https://trade.nebulaecn.com/api/v2/backend/market/orders

Request Parameters

Name

Located In

Description

Required

Schema

market

query

No

string

base_unit

query

No

string

quote_unit

query

No

string

state

query

Filter order by state.

No

string

limit

query

Limit the number of returned orders, default to 100.

No

integer

page

query

Specify the page of paginated results.

No

integer

order_by

query

If set, returned orders will be sorted in specific order, default to "desc".

No

string

ord_type

query

Filter order by ord_type.

No

string

type

query

Filter order by type.

No

string

time_from

query

An integer represents the seconds elapsed since Unix epoch.If set, only orders created after the time will be returned.

No

integer

time_to

query

An integer represents the seconds elapsed since Unix epoch.If set, only orders created before the time will be returned.

No

integer

Response Content

Code

Description

Schema

200

Get your orders, result is paginated.

Order

Get specified order

Description

Get information of specified order.

HttpRequest

GET https://trade.nebulaecn.com/api/v2/backend/market/orders/{id}

Request Parameters

Name

Located In

Description

Required

Schema

id

path

Yes

string

Response Content

Code

Description

Schema

200

Get information of specified order.

Order

PreviousAccountNextModels

Last updated