Batch Fetch Order

post

https://dma-api.zerocap.com/v2/orders/fetch_orders

Get a list of orders filtered by optional query parameters.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

symbol

string

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

Optional. Returns only orders for this instrument, for example BTC/USD. Only letters, numbers, '_', '.', '-' and '/' are allowed (HTTP 422 otherwise).

start_datetime

integer

Defaults to 0

Unix timestamp in milliseconds. Returns only orders created at or after this time. Use it together with end_datetime.

end_datetime

integer

Defaults to 0

Unix timestamp in milliseconds. Returns only orders created before this time (exclusive). Defaults to the current time. To filter by time, pass end_datetime, or both start_datetime and end_datetime.

page

integer

Defaults to 1

Page number for set of orders desired, starting from 1. Default 1.

limit

integer

Defaults to 500

Maximum number of orders returned on a single page. Default 500, maximum 500; larger values are treated as 500.

ids

string

Bulk order ID

status

string

enum

Allowed:

sort_order

string

enum

Defaults to desc

asc or desc by time

Allowed:

order_type

string

enum

Allowed:

side

string

enum

Allowed:

Headers

api-key

string

required

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

signature

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.

timestamp

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

200Successful Response

400Business error, the body carries the reason in error.description.

401Unauthorized: missing or unknown api-key, bad signature, or the request IP is not in the key's IP allow-list.

408The timestamp header differs from server time by more than 30 seconds.

422Validation Error

429Rate limit exceeded: 50 requests per second per endpoint per client IP.