BuyCoins API Guide
Search…
Post Limit Order
Place a limit order
A limit order is a type of order to buy or sell a cryptocurrency at your specified price or better.
Unlike market orders, limit orders are not executed instantly at the current market price. Limit orders are executed only when a market order equal to or better than the price you specified is received.
For buy limit orders, the order will only be executed when a seller is willing to sell to you at a price that is lower than or equal to your specified buy price. For sell limit orders, the order will only be executed when a buyer is willing to buy at a price that is higher than or equal to your specified sell price.
For example, if you place a limit order to buy bitcoin at the rate of N6,500,000 per bitcoin, your order will be fulfilled only for market orders that offer to sell at N6,500,000 or less .

When to place a limit order

Place a limit order when you want to specify a price and you do not need the order to execute instantly.

Placing a limit order

You can place a limit order that shows up in the order book using the postProLimitOrder mutation.
1
mutation {
2
postProLimitOrder(pair: btc_ngnt, quantity: 0.01, price: 26000000, side: buy, timeInForce: good_til_cancelled) {
3
id
4
pair
5
price
6
side
7
status
8
timeInForce
9
orderType
10
fees
11
filled
12
total
13
initialBaseQuantity
14
initialQuoteQuantity
15
remainingBaseQuantity
16
remainingQuoteQuantity
17
meanExecutionPrice
18
engineMessage
19
}
20
}
Copied!

Parameters

  • pair: The currency pair you want to buy or sell
  • quantity: The amount of the base currency you want to buy or sell
  • price: The amount of the quote currency you to want to buy or sell the quantity you provided above
  • side: The order side either buy or sell
  • timeInForce: The timeInForce option for your order
Response
  • id: Unique identifier of the order
  • pair: The currency pair of the order
  • price: The price the order was executed at
  • side: The order side either buy or sell
  • status: The status of the orderpending, in_progress, cancelled, successful, failed, partially_filled
  • timeInForce: The timeInForce option of the order
  • orderType: The type of the order either limit_order, market_order
  • fees: The fees incurred for placing the order
  • filled: The amount of the base currency that was filled
  • total: An alias for initial base quantity.
  • initialBaseQuantity: The initial quantity of the base currency
  • initialQuoteQuantity: The initial quantity of the quote currency
  • remainingBaseQuantity: The remaining base quantity that has not been filled.
  • remainingQuoteQuantity: The remaining quote quantity that has not been filled. (Only applies to market buy orders)
  • meanExecutionPrice: The price that an order was executed at if it matched with one other order. The average price if it matched with multiple other orders.
  • engineMessage: The reason why an order failed