API Reference
API Reference

Create an Order

post
https://dma-api.zerocap.com/v2/orders/create_order

Create a limit order. Orders are executed as FOK (fill-or-kill): the order is filled immediately in full at the current market price, or it is not filled. A buy order priced below the market price, or a sell order priced above it (beyond a small tolerance), is canceled with error 10502 or 10503. Orders can only be placed if your account has sufficient funds or credit.

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

Optional. At most 50 characters; only letters, numbers, '-' and '_' are allowed (error 10607 if too long, 10608 if it contains other characters).

string
required
^[A-Za-z0-9_./-]*$

Instrument, for example BTC/USD. Only letters, numbers, '_', '.', '-' and '/' are allowed (HTTP 422 otherwise).

string
enum
required
Allowed:
const
enum
required

Order type. Only limit is supported.

Allowed:
string
required
string
required
Headers
string
required

Your API key, sent in the api-key request header.

string
required

Lowercase hex-encoded HMAC-SHA256 of the timestamp header value, using your API secret as the key: hex(HMAC_SHA256(api_secret, timestamp)). Only the timestamp is signed; the request path and body are not part of the signature. An invalid signature returns HTTP 401.

string
required

A Unix timestamp in seconds, sent with every request and used as the signed message. Your timestamp must be within 30 seconds of the API server time, otherwise the request is considered expired and rejected with HTTP 408. We recommend using the Get Time endpoint to query the API server time if you believe there is a time difference between your server and the API servers.

Responses

Updated 4 months ago

Did this page help you?
Language
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 4 months ago

Did this page help you?