Agara

Place a signed order

POST/order/v1/orders/signed

Required token scope: orders:place_signed.

Submit a pre-signed Agara LIMIT order. Complete wallet setup and approvals first. Sign using the chain and exchange domain described in pre-signed orders. The maximum request body is 16 KiB.

HTTP 200 provides an order state; it does not imply that the order remains open or that settlement is complete. HTTP 202 with TAKE_ORDER_DELAY acknowledges a wait before matching; it does not confirm a fill or a resting order. HTTP 202 with UNKNOWN leaves the placement unresolved. Keep the exact signed body, hash and any returned ID; read the original order before signing a replacement. A retry is checked against the timestamp or expiry rules again and may be refused after an earlier success.

For a delayed order, follow the original ID or hash through reads and account events; cancellation is refused during the wait. See taker delays.

See the order management guide for cancellation, fills and recovery.

Authorization

bearerAuth
AuthorizationBearer <token>

Use an agt_ API token with the scope listed on the operation, or a supported browser access token. HTTP authentication is separate from the EIP-712 order signature.

In: header

Request Body

application/json

Signed Agara LIMIT order. Compute collateral_micro = floor(price_micro × shares_micro / 1000000). Notional must be from 0.10 through 100000 collateral units. Keep the API fields consistent with the signed fields.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/problem+json

application/json

curl -X POST "https://example.com/order/v1/orders/signed" \  -H "Content-Type: application/json" \  -d '{    "token_id": "string",    "side": "BUY",    "type": "LIMIT",    "time_in_force": "GTC",    "price_micro": 1,    "shares_micro": 1,    "salt": "string",    "maker": "string",    "chain_token_id": "string",    "maker_amount": "string",    "taker_amount": "string",    "side_u8": 0,    "timestamp": "string",    "metadata": "string",    "builder": "string",    "order_hash": "string",    "signature": "string"  }'
{  "order_id": "f6179e34-1b64-5a10-a662-32f25759da1a",  "source": "AGARA",  "status": "OPEN",  "pending_operation": "NONE",  "as_of": "2026-11-04T12:00:00Z",  "engine_reference": "12345",  "remaining_engine_size": "100"}