[Requires authentication] Call the authenticate tool first to start or confirm 1inch Business login (initialize 200 is still anonymous). If authenticate or this tool returns HTTP 401, complete OAuth, then retry. Limit orders via the 1inch Orderbook API (v4.1).
IMPORTANT: The "action" parameter is REQUIRED. Must be one of: "build", "create", "list", "cancel".
Actions with example parameters:
1. build (recommended first step):
{ "action": "build", "chain": 1, "makerAsset": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48", "takerAsset": "0xdAC17F958D2ee523a2206206994597C13D831ec7", "makingAmount": "1000000", "takingAmount": "990000", "makerAddress": "0x..." }
Optional: expirationSeconds (default 604800 = 7 days). With an active WalletConnect session, the order is signed and submitted automatically (set execute=false to return typed data only).
2. create (after signing typedData from build):
{ "action": "create", "chain": 1, "orderHash": "0x...", "signature": "0x...", "orderData": { ... } }
3. list (query orders):
- By maker: { "action": "list", "chain": 1, "listMode": "by_maker", "makerAddress": "0x..." }
- By hash: { "action": "list", "chain": 1, "listMode": "by_hash", "orderHash": "0x..." }
- Browse: { "action": "list", "chain": 1, "listMode": "all", "limit": 10 }
4. cancel (inspect + guidance):
{ "action": "cancel", "chain": 1, "orderHash": "0x..." }
Typical flow: build -> sign typedData -> create (or one build call when WalletConnect is connected — order signed and submitted automatically).
The maker asset may require a one-time ERC-20 approval for the Limit Order Protocol; it costs native gas even though the limit order itself is gasless. When a build response includes an "approval" block, tell the user upfront (approval.estimatedCost holds the estimated cost in native units) and broadcast the included approveTx before signing. With WalletConnect, the approve is sent automatically — "approvalTxSent": true means the first wallet prompt was the one-time approval.
Requires authentication. For raw HTTP access, use product_api.