API Reference
Create AccountLogin

Create Market Order

post
https://sandbox-api.oneliquidity.technology/merchant/v1/market/

Creates a new market order for the provided quoteAsset. Market orders fill at the best available price on the order book. Price is optional — when omitted the order fills at whatever the best price is. The order is queued via SQS and matched asynchronously.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Quote asset for the order pair.

Body Params

Create market order payload. Unit fields take precedence when both decimal and unit fields are supplied. Price is optional.

Request payload for creating a market order. Market orders fill at the best available price on the order book. Price is optional — when omitted the order fills at whatever the best price is. Decimal and unit fields are both supported. If both are sent for the same value, the *InUnits value takes precedence. Send at least one of qtyTotal or qtyTotalInUnits.

string
required

Base asset being advertised.

string
enum
required

Trade side for the order.

Allowed:
string

Quote asset. Optional when already provided in path.

Human-readable price limit. Optional for market orders — omit to fill at best available price.

string

Price limit in smallest units (bigint string). Optional — omit to fill at best available price.

Human-readable total quantity.

string

Total quantity in smallest units (bigint string). Must be greater than zero.

Human-readable minimum quantity allowed per order.

string

Minimum quantity per order in smallest units (bigint string).

Human-readable maximum quantity allowed per order.

string

Maximum quantity per order in smallest units (bigint string).

boolean
Defaults to true

Whether to send email notifications on fills. Defaults to true.

Responses

Updated 3 days ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 days ago