Orders

Order management

Place a new order

post

Places a new order for the authenticated account.

Security: Requires both XApiKey (header) and Ed25519Sig (query) via the global security requirement. The signature is computed over the request query string (including timestamp and any other parameters you send).

Parameter rules (enforced server-side):

  • LIMIT: requires quantity, price, and timeInForce; stopPrice not allowed.

  • MARKET: requires quantity; price, timeInForce, stopPrice not allowed.

  • STOP_LOSS: requires quantity and stopPrice; price and timeInForce not allowed.

  • STOP_LOSS_LIMIT / TAKE_PROFIT_LIMIT: require quantity, price, stopPrice, and timeInForce.

Examples (query-string style):

  • LIMIT BUY: symbol=PLEX-HBAR&side=BUY&type=LIMIT&timeInForce=GTC&quantity=1.5&price=1800.00&timestamp=1724952745123

  • MARKET SELL: symbol=WBTC-USDC&side=SELL&type=MARKET&quantity=0.05&timestamp=1724952745123

  • STOP_LOSS_LIMIT BUY: symbol=WBTC-USDC&side=BUY&type=STOP_LOSS_LIMIT&timeInForce=GTC&quantity=0.01&price=65000.00&stopPrice=64000.00&timestamp=1724952745123

Authorizations
X-API-KEYstringRequired
signaturestringRequired

Ed25519 signature of payload

Query parameters
symbolstring · min: 3 · max: 33Required

Trading pair symbol

Example: WETH-USDCPattern: ^[A-Z0-9_]+-[A-Z0-9_]+$
sidestring · enumRequired

Order side

Possible values:
typestring · enumRequired

Supported order types. LIMIT requires price, quantity, and timeInForce. MARKET requires quantity. STOP_LIMIT requires stopPrice and quantity. *_LIMIT types require price, stopPrice, quantity, and timeInForce.

Possible values:
timeInForcestring · enumOptional

Applied to LIMIT and *_LIMIT orders.

Possible values:
quantitystringOptional

Order quantity. Required for LIMIT, MARKET, STOP_LOSS, STOP_LOSS_LIMIT, TAKE_PROFIT_LIMIT

Example: 1.5
pricestringOptional

Price for LIMIT and *_LIMIT orders.

Example: 1800
newClientOrderIdstringOptional

Optional client-assigned ID (must be unique per account)

Example: myorder-001Pattern: ^[A-Za-z0-9._-]{1,36}$
stopPricestringOptional

Trigger price for STOP/TAKE_PROFIT orders

Example: 64000
Responses
200

Order accepted

application/json
post
/api/v1/order
POST /api/v1/order?symbol=text&side=BUY&type=LIMIT HTTP/1.1
Host: aincent.com
X-API-KEY: YOUR_API_KEY
Accept: */*

{
  "symbol": "PLEX-HBAR",
  "orderId": "123456789012345",
  "clientOrderId": "myorder-001",
  "transactTime": 1724952746123
}

Cancel an existing order

delete

Deletes an existing order for the authenticated account.

Security: Requires both XApiKey (header) and Ed25519Sig (query) via the global security requirement. The signature is computed over the request query string (including timestamp and any other parameters you send).

Authorizations
X-API-KEYstringRequired
signaturestringRequired

Ed25519 signature of payload

Query parameters
symbolstring · min: 3 · max: 33Required

Trading pair symbol

Example: PLEX-HBARPattern: ^[A-Z0-9_]+-[A-Z0-9_]+$
orderIdstring · uuidOptional

Server-assigned order ID (if combined with origClientOrderId, must refer to same order)

Example: 26a911ff-f546-eaaf-4b22-e57657b57571
origClientOrderIdstringOptional

Original client-assigned order ID (optional if orderId is set)

Example: myorder-001Pattern: ^[A-Za-z0-9._-]{1,36}$
newClientOrderIdstringOptional

New client-assigned order ID (optional)

Example: cancelOrder1Pattern: ^[A-Za-z0-9._-]{1,36}$
Responses
200

Order canceled

application/json
delete
/api/v1/order
DELETE /api/v1/order?symbol=PLEX-HBAR HTTP/1.1
Host: aincent.com
X-API-KEY: YOUR_API_KEY
Accept: */*

{
  "symbol": "PLEX-HBAR",
  "origClientOrderId": "myorder-001",
  "orderId": "26a911ff-f546-eaaf-4b22-e57657b57571",
  "clientOrderId": "canceledOrder1",
  "transactTime": 1724952746123,
  "price": "0.01234567",
  "origQty": "100.00000000",
  "executedQty": "25.00000000",
  "cumulativeQuoteQty": "0.30864175",
  "status": "CANCELED",
  "timeInForce": "GTC",
  "type": "LIMIT",
  "side": "BUY",
}
PreviousOrder booksNextAccount

Last updated