network in the body, and a GET or DELETE route takes it in the query string. Every route serves the four network keys, except nonce-accounts, which serves only svm-mainnet and svm-devnet.
A route names a capital provider by its id, the same capitalProvider.id that pairs, quotes, and batch orders carry: the stablecoin delegate ID on Ethereum, the capital provider’s wallet on Solana. A capital provider of another organization answers 403 with code FORBIDDEN, and an ID that is not a batch order capital provider on the network, such as a delegate whose batch orders were never turned on, answers 404 with code NOT_FOUND. An orderId is a lowercase UUID. A list’s cursor continues only the listing it was issued for: the same route, network, and filters, with a credential of your organization; another limit is fine.
The public order reads,
GET /v1/batch-orders/{orderId} and GET /v1/batch-orders?user=, return the same order for every caller, as Batch orders describes.
Your capital providers
GET /v1/batch-orders/capital-providers?network= lists your organization’s capital providers whose batch orders are on for the network. The response holds the network, the batch, the capitalProviders, and nextCursor. It takes batchId, limit, and cursor as batch info does, but neither route continues the other’s cursor. An empty list means your organization has no such capital provider on the network, as Get set up explains. Each entry has:
Capacity
PUT /v1/batch-orders/capital-providers/{capitalProviderId}/capacity sets the posted total of one token for one batch, and returns the token’s capacity. It needs cp:operate.
Response
batchIdnames the batch by its New York release date, from2000-01-01through9999-12-29; a date outside that range is rejected with422andINVALID_BODY. A batch takes capacity until its cut-off whatever itsintakeOpen, which is about users’ orders only.tokenis the token’s address: on Ethereum, the capital provider’s stablecoin or any RWA the network lists, including one its delegate does not whitelist, which is posted asinactive; on Solana, a mint of one of its pairs. Any other token is rejected with422andINVALID_BODY, withdetails.fieldtoken, and on Ethereum a capital provider the network no longer lists with422andUNSUPPORTED_ROUTE.postedis the absolute total in whole tokens, not an increment: a decimal string from0, with at most 6 decimal places and no more than the token’s decimals. Any other value is rejected with422andINVALID_BODY, withdetails.fieldposted. You can post for the current batch until its 4:30 PM cut-off and for later batches in advance.- Accepted orders reserve capacity as they arrive. A total below what they already reserve is rejected with
409andCAPACITY_BELOW_RESERVED, whosedetails.reservedis the floor, in whole tokens. - On
evm-mainnet, a nonzero RWA total requires the capital provider’s custody to pass the RWA’s whitelist adapter; otherwise, or when the RWA has no adapter, the update is rejected with409andCUSTODY_NOT_WHITELISTED. A zero total skips the check, so unreserved capacity can always be withdrawn. - An update after the cut-off is rejected with
INTAKE_CLOSED, and one for a capital provider whose batch orders are off withBATCH_ORDERS_DISABLED.
Operator
PUT /v1/batch-orders/capital-providers/{capitalProviderId}/operator with {"network": "...", "operator": "..."} selects or replaces the wallet that executes the capital provider’s orders: an address on Ethereum, a base58 key on Solana. DELETE on the same path, with network in the query string, clears it. Both return 204 and need cp:admin, which only an admin holds and only an admin can grant to a key.
- A capital provider without an operator takes no new orders, and preparation answers
OPERATOR_NOT_SELECTED. - Orders are signed for the operator that was current when they were prepared. After a change, a new order signed for the old operator is rejected with
OPERATOR_MISMATCH, whosedetails.expectednames the new one, or isnullafter the operator is cleared. Orders accepted before the change keep their signed operator, which the order list shows and the requirements show beside the current one. - Clearing an operator leaves the capital provider’s capacity stored. Repeating it changes nothing.
Funding requirements
GET /v1/batch-orders/batches/{batchId}/requirements?network= totals the accepted, uncanceled orders of one batch by capital provider, signed operator, and token, so you can fund your custody before the release. batchId is the release date in YYYY-MM-DD form. It needs read, filters by operator and capitalProvider, and pages with limit and cursor.
The totals are what you pay out, never netted against what you receive.
Released payloads
GET /v1/batch-orders/payloads?network= returns your organization’s orders once their batch is released at 5:00 PM, with what the operator executes. Without batchId or orderId, it returns the latest released batch. It needs read, filters by operator, including your earlier operators, and capitalProvider, and pages with limit and cursor. Canceled orders never appear.
Each payload has runtime, orderId, batchId, acceptedAt, and releasedAt, and:
- on Ethereum,
authorization, the complete signed authorization:chainId,verifyingContract,user,operator,receiver,inputs, with their signed amounts in base units,unordered(alwaystrue),nonce,deadline, and the user’ssignature; - on Solana, the user-signed
transactionin base64 with the operator’s signature slot empty, theoperator,nonceAccount,nonceValue, anddeadline.
Reports
POST /v1/batch-orders/{orderId}/reports records your report of one released order’s outcome. It needs cp:operate.
status says what happened to the order:
An order you never report is treated as a failure report, and a verified execution makes the order
completed whatever you report.
reasonis required.transactionIdis optional: the transaction hash on Ethereum or the signature on Solana. It points Multiliquid’s search for the execution but is not itself evidence of it.- Reports are accepted from the batch’s release, at or just after 5:00 PM (the payloads’
releasedAt), until its 5:30 PM close, and never for canceled orders. A report outside that window is rejected with409andREPORTING_CLOSED. - Each accepted report adds a revision and returns
201with it:revision,authorUserId,receivedAt,status,reason, andtransactionId. The latest revision counts. A report filed with an organization key has anullauthorUserId.
underReview, as Batch orders describes. The body is limited to 4 KiB.
Your orders
GET /v1/batch-orders/capital-providers/orders?network= lists the uncanceled orders of your organization’s capital providers, newest first. Each entry has the order, as GET /v1/batch-orders/{orderId} returns it, with the operator it signed, the only wallet that can execute it, and its signed deadline in Unix seconds. It needs read, filters by user and capitalProvider, and pages with limit and cursor.
GET /v1/batch-orders/{orderId}/attempts?network= returns up to 100 of an order’s Ethereum execution attempts, newest first, each with transactionId, blockNumber, observedAt, and state: confirmed, reverted, unresolved, or orphaned when a chain reorganization removed it. Solana orders return an empty list. It reads only your organization’s uncanceled orders.
Solana nonce accounts
POST /v1/batch-orders/nonce-accounts with {"network": "svm-mainnet", "address": "<base58>"} adds a durable nonce account to an operator’s pool, and returns 200 with its address, operator, and nonceValue. It needs cp:operate. The account must be an initialized nonce account whose authority is an operator that your organization selected on the network:
- an address that is not an initialized nonce account answers
422withINVALID_BODY; - an account whose authority is not one of your selected operators answers
403withFORBIDDEN; - an account that holds another operator’s order answers
409withCONFLICT.
NONCE_ACCOUNT_UNAVAILABLE when the pool has none. Each open order holds its account until it executes, expires, or is canceled, so the pool’s size limits the operator’s open orders. You never advance the nonces: once a released order’s deadline passes with its nonce unchanged, Multiliquid records the order as not executed and returns the account to the pool. The body is limited to 128 bytes.
Errors
Errors gives each code’s remedy.