Place Order - DexBuilder Docs

POST

api

broker

event_contracts

orders

Place Order

curl --request POST \
  --url https://api.dexbuilder.com/api/v4/broker/event_contracts/orders \
  --header 'Content-Type: application/json' \
  --header 'KEY: <api-key>' \
  --header 'SIGN: <sign>' \
  --header 'Timestamp: <timestamp>' \
  --header 'X-User-Wallet-Address: <x-user-wallet-address>' \
  --data '
{
  "token_id": "<string>",
  "price": "<string>",
  "size": "<string>",
  "total_cost": "<string>",
  "client_order_id": "<string>",
  "post_only": true,
  "sell_all": true,
  "expire_time": 123
}
'

import requests

url = "https://api.dexbuilder.com/api/v4/broker/event_contracts/orders"

payload = {
    "token_id": "<string>",
    "price": "<string>",
    "size": "<string>",
    "total_cost": "<string>",
    "client_order_id": "<string>",
    "post_only": True,
    "sell_all": True,
    "expire_time": 123
}
headers = {
    "Timestamp": "<timestamp>",
    "SIGN": "<sign>",
    "X-User-Wallet-Address": "<x-user-wallet-address>",
    "KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "client_order_id": "<string>",
  "created_at": 123,
  "order_id": "<string>",
  "status": "processing"
}

{
  "label": "INVALID_ARGUMENT",
  "message": "invalid request"
}

{
  "label": "INVALID_ARGUMENT",
  "message": "invalid request"
}

{
  "label": "INVALID_ARGUMENT",
  "message": "invalid request"
}

Submits an order. Base URL: https://api.dexbuilder.com Authentication: Use a Broker API Key and sign this request with Timestamp and SIGN. Pass a wallet address that belongs to your Broker in X-User-Wallet-Address. Calculate the signature using the external Broker path. See Broker API Key and signing and Access on behalf of a user.

Request

curl -X POST "https://api.dexbuilder.com/api/v4/broker/event_contracts/orders" \
  -H "KEY: ${BROKER_API_KEY}" \
  -H "SIGN: ${SIGN}" \
  -H "Timestamp: ${TIMESTAMP}" \
  -H "X-User-Wallet-Address: ${USER_WALLET}" \
  -H "Content-Type: application/json" \
  -d '<request-body>'

The request body contains only the public token, side, price/size or total cost, order type/mode, and optional client order and expiry fields shown in the OpenAPI definition. The OpenAPI panel below is the source of truth for required parameters, types, enum values, and request-body fields. Timestamps are Unix timestamps unless the field description states otherwise.

Response

Returns an acceptance object containing the order identifier and processing status. Query the order or subscribe to the private order channel for subsequent state changes. A successful response uses HTTP 200. Invalid parameters or request bodies return HTTP 400. Private endpoints can return HTTP 401 when authentication fails, and temporary upstream failures can return HTTP 503. The error response contains a machine-readable label and message. For order, position, claim, transfer, and account operations, treat the response as the current server result and query the resource again when the operation is asynchronous.

Authorizations

KEY

string

header

required

Broker API Key, created through the project administrator's process.

Headers

Timestamp

string

required

Unix timestamp in seconds; the gateway allows at most 60 seconds of clock skew.

SIGN

string

required

Hexadecimal HMAC-SHA512 signature over the external request path, query string, and body.

X-User-Wallet-Address

string

required

End-user wallet address. The gateway checks that this wallet belongs to the current Broker.

Body

application/json

token_id

string

required

side

enum<string>

required

Available options:

BUY,

SELL

price

string

size

string

total_cost

string

order_type

enum<string>

Time-in-force: GTC, GTD, FOK, or FAK

Available options:

GTC,

GTD,

FOK,

FAK

order_mode

enum<string>

Execution mode: LIMIT or MARKET

Available options:

LIMIT,

MARKET

client_order_id

string

post_only

boolean

sell_all

boolean

expire_time

integer

Response

Request succeeded

Response object.

client_order_id

string

created_at

integer

order_id

string

status

enum<string>

Available options:

processing

Place Order

curl --request POST \
  --url https://api.dexbuilder.com/api/v4/broker/event_contracts/orders \
  --header 'Content-Type: application/json' \
  --header 'KEY: <api-key>' \
  --header 'SIGN: <sign>' \
  --header 'Timestamp: <timestamp>' \
  --header 'X-User-Wallet-Address: <x-user-wallet-address>' \
  --data '
{
  "token_id": "<string>",
  "price": "<string>",
  "size": "<string>",
  "total_cost": "<string>",
  "client_order_id": "<string>",
  "post_only": true,
  "sell_all": true,
  "expire_time": 123
}
'

import requests

url = "https://api.dexbuilder.com/api/v4/broker/event_contracts/orders"

payload = {
    "token_id": "<string>",
    "price": "<string>",
    "size": "<string>",
    "total_cost": "<string>",
    "client_order_id": "<string>",
    "post_only": True,
    "sell_all": True,
    "expire_time": 123
}
headers = {
    "Timestamp": "<timestamp>",
    "SIGN": "<sign>",
    "X-User-Wallet-Address": "<x-user-wallet-address>",
    "KEY": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "client_order_id": "<string>",
  "created_at": 123,
  "order_id": "<string>",
  "status": "processing"
}

{
  "label": "INVALID_ARGUMENT",
  "message": "invalid request"
}

{
  "label": "INVALID_ARGUMENT",
  "message": "invalid request"
}

{
  "label": "INVALID_ARGUMENT",
  "message": "invalid request"
}

​Request

​Response

Authorizations

Headers

Body

Response

Request

Response