Limit orders
Create, list, get, replace, and cancel off-chain limit orders. Public create and replace requests mirror the quote shape and add minAmountOut plus expiry controls.
Prerequisites
API key (header
Authorization: Bearer YOUR_API_KEY)Base URL:
https://api.gateway.zert.com/api/v1
Step 1: Create a limit order
Call POST /limit-orders/limit with the quote-style fields fromChain, toChain, tokenIn, tokenOut, and amount, plus minAmountOut. Create requests require an Idempotency-Key.
curl -X POST 'https://api.gateway.zert.com/api/v1/limit-orders/limit' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Idempotency-Key: limit-create-001' \
-d '{
"timeInForce": "GTC",
"minAmountOut": "1",
"fromChain": "arbitrum",
"toChain": "avax",
"tokenIn": "TBTC",
"tokenOut": "WETH",
"network": "mainnet",
"amount": "100.00",
"slippageBps": 75,
"recipient": "0x1234567890123456789012345678901234567890"
}'Response includes data.limitOrderId, data.status, data.expiresAtMs, and data.minAmountOut.
Step 2: List your limit orders
Call GET /limit-orders/limits to list orders for the authenticated owner. Use query limit (1–200) and optional status (e.g. open, canceled).
Step 3: Get or cancel a single order
Get:
GET /limit-orders/limit/{limitOrderId}— returns full order details.Cancel:
DELETE /limit-orders/limit/{limitOrderId}— requiresIdempotency-Key; optional body{"reason": "..."}.
Step 4: Replace an open order
Call POST /limit-orders/limit/{limitOrderId}/replace with the same request shape as create. Replacement requests also require Idempotency-Key.
Summary
1
POST /limit-orders/limit
Create limit order
2
GET /limit-orders/limits
List owner's limit orders
3
GET /limit-orders/limit/{id}
Get one order
3
DELETE /limit-orders/limit/{id}
Cancel one order
4
POST /limit-orders/limit/{id}/replace
Replace an open order
See Create Limit Order, List Limit Orders, Get or Cancel Limit Order, and Replace Limit Order for full parameters and responses.
Last updated

