Place a pre-signed order

POST/trade/v1/orders/signed

Authorization

personal_access_token orders:place_signed

AuthorizationBearer <token>

Personal access token issued from the web app's Settings → API tokens page. Send as Authorization: Bearer agt_….

In: header

Scope: orders:place_signed

CLOB order creation request body for pre-signed (bot/server-key) submissions. Carries the EIP-712 envelope fields the bot signed over so the router can recover and validate the signature without re-signing.

builder*string

Builder code (0x-prefixed bytes32; usually zero).

chain_token_id*string

CTF position id as the u256 value the bot signed over (decimal or 0x-hex string). Must encode the same numeric value as token_id above — the router validates they match. Carried separately because the lookup token_id is a free-form string whose encoding isn't guaranteed to match what the bot used in the EIP-712 envelope.

expiration_unix_seconds?|

Expiration in Unix seconds. Required for GTD and must be at least 30 seconds in the future; omit it for every other time-in-force.

Formatint64

maker*string

Maker address — must equal the wallet's deposit-wallet address.

maker_amount*string

Maker amount (u256 decimal string in chain micro units).

metadata*string

Metadata hash (0x-prefixed bytes32; usually zero).

order_hash*string

0x-prefixed keccak256 of the EIP-712 typed-data digest.

post_only?|

Post-only flag. The order is rejected instead of crossing the spread. Defaults to false.

price_micro?|

Limit price in micro units.

salt*string

Per-order salt (u256 decimal string). Use a fresh value per order.

shares_micro?|

Shares amount in micro units.

side*Side

Order side.

Value in

"BUY"
"SELL"

side_u8*integer

Side encoded as the contract's uint8: 0 = BUY, 1 = SELL.

Formatint32

Range0 <= value

signature*string

0x-prefixed 65-byte (r||s||v) signature from the user's EOA.

taker_amount*string

Taker amount (u256 decimal string).

time_in_force*ClobOrderTimeInForce

Time in force.

Value in

"FAK"
"FOK"
"GTC"
"GTD"

timestamp*string

Order timestamp (u256 decimal string; usually 0).

token_id*TokenId

Outcome token id.

type*ClobOrderType

Order type — only LIMIT is supported on this endpoint.

Value in

"LIMIT"
"MARKET"

Response Body

`application/json`

`application/problem+json`

curl -X POST "https://example.com/trade/v1/orders/signed" \  -H "Content-Type: application/json" \  -d '{    "builder": "string",    "chain_token_id": "string",    "maker": "string",    "maker_amount": "string",    "metadata": "string",    "order_hash": "string",    "salt": "string",    "side": "BUY",    "side_u8": 0,    "signature": "string",    "taker_amount": "string",    "time_in_force": "FAK",    "timestamp": "string",    "token_id": "string",    "type": "LIMIT"  }'

{  "as_of": "2019-08-24T14:15:22Z",  "order_id": "93101167-9065-4b9c-b98b-5d789a3ed9fe",  "pending_operation": "SUBMIT",  "source": "AGARA",  "status": "PENDING"}

Place a pre-signed order

Authorization

Request Body

Response Body

202application/json

400application/problem+json

401application/problem+json

403application/problem+json

404application/problem+json

409application/problem+json

413application/problem+json

415application/problem+json

422application/problem+json

424application/problem+json

429application/json

500application/problem+json

502application/problem+json

503application/problem+json

`application/json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`

`application/problem+json`