BuyCoins API Guide
Search…
Naira Token Account
Orderbook Trading
Receiving
Webhooks
P2P Trading (Deprecated)
Post Market Order
Place a market order
This mutation has been deprecated. Use the postProMarketOrder mutation instead to place a market order.
A market order is an order to immediately buy or sell cryptocurrency at the best available current price.
Unlike limit orders, you do not specify a price when you place a market order. When you place a market order, it is matched with an existing limit order with the best buy or sell price at the time of the request.
When to place a market order
Place market orders when you want your order to execute as soon as possible, regardless of the price.
Placing a market order
To post a market order call the
postMarketOrder mutation, and specify the order side (buy or sell), coin amount, and the cryptocurrency you want to trade.The
orderSide parameter indicates the type of limit order to engage, whether a buy limit order or a sell limit order. When you want to sell cryptocurrency,
orderSide should be buy so that your order is matched with a buy limit order. To buy cryptocurrency, orderSide should be sell. 1
postMarketOrder(orderSide: buy, coinAmount: 0.01, cryptocurrency: bitcoin){
2
id
3
cryptocurrency
4
coinAmount
5
side
6
status
7
createdAt
8
pricePerCoin
9
priceType
10
staticPrice
11
dynamicExchangeRate
12
}
13
}
Copied!
Parameters
- orderSide: The order side either buy or sell
- coinAmount: Amount of coins to trade
- cryptocurrency: Type of cryptocurrency. default: bitcoin
Response
- id: Unique identifier of the order
- coinAmount: Amount of coins to trade
- pricePerCoin: The price per coin in Naira
- side: The order side (buy or sell)
- status: The status of the order
- createdAt: The timestamp when the order was created
- *staticPrice: null
- *priceType: null
- *dynamicExchangeRate: null
*
postOrder always returns null for staticPrice, price_type, and dynamic_exchange_rate fields.Copy link