> ## Documentation Index
> Fetch the complete documentation index at: https://docs.multiliquid.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Run the daily batch

> Post capacity for a batch, retrieve and execute its released orders, and report each outcome.

This is a capital provider's daily routine for batch orders. Every request carries your API key, and the times are New York time.

## Before you start

* **A capital provider with batch orders on**, and its `id`, from `GET /v1/batch-orders/capital-providers?network=evm-mainnet`: on Ethereum, your stablecoin delegate's ID. An empty `capitalProviders` list means your organization has none with batch orders on for the network; [Get set up](https://docs.multiliquid.xyz/api-reference/capital-providers/overview.md#get-set-up) says how to get one.

  ```bash theme={null}
  curl "https://api.multiliquid.xyz/v1/batch-orders/capital-providers?network=evm-mainnet" \
    -H "Authorization: Bearer $MULTILIQUID_API_KEY"
  ```

  ```json Response expandable theme={null}
  {
    "network": "evm-mainnet",
    "batch": {
      "batchId": "2026-11-06",
      "opensAt": "2026-11-05T22:00:00Z",
      "cutoffAt": "2026-11-06T21:30:00Z",
      "releasesAt": "2026-11-06T22:00:00Z",
      "executionTargetAt": "2026-11-06T22:15:00Z",
      "reportingClosesAt": "2026-11-06T22:30:00Z",
      "intakeOpen": true
    },
    "capitalProviders": [
      {
        "capitalProvider": {
          "id": "0x58e27f2731863499e6a23a1662ebeed9041d6b40996ea9ca7f4ebc54201823b4",
          "name": "Uniform Labs",
          "address": "0x0630582db5a1949509f21b315677c40b9aeb7bda"
        },
        "operator": "0x3333333333333333333333333333333333333333",
        "acceptingOrders": true,
        "capacity": [
          {
            "token": {
              "address": "0x43415eb6ff9db7e26a15b704e7a3edce97d31c4e",
              "symbol": "USTB",
              "name": "Invesco Short Duration US Government Securities Fund",
              "decimals": 6,
              "kind": "rwa",
              "issuer": "Superstate"
            },
            "status": "active",
            "posted": "250000",
            "reserved": "95.238095",
            "available": "249904.761905"
          },
          {
            "token": {
              "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
              "symbol": "USDC",
              "name": "USD Coin",
              "decimals": 6,
              "kind": "stablecoin",
              "issuer": "Circle"
            },
            "status": "active",
            "posted": "5000000",
            "reserved": "0",
            "available": "5000000"
          }
        ]
      }
    ],
    "nextCursor": null
  }
  ```
* **An operator.** An admin, or a key with `cp:admin`, selects the wallet that executes your orders:

  ```bash theme={null}
  curl -X PUT "https://api.multiliquid.xyz/v1/batch-orders/capital-providers/$CAPITAL_PROVIDER_ID/operator" \
    -H "Authorization: Bearer $MULTILIQUID_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{ "network": "evm-mainnet", "operator": "0x3333333333333333333333333333333333333333" }'
  ```

  Without an operator, users cannot place orders with you.
* **On Solana, durable nonce accounts** for your operator. Each Solana order uses one, and users cannot place orders while the pool is empty. [Batch operations](https://docs.multiliquid.xyz/api-reference/capital-providers/batch-operations.md#solana-nonce-accounts) explains how to register them.

## 1. Post capacity, before 4:30 PM

Set how much of a token you will fill in a batch. `posted` is the total in whole tokens, with at most 6 decimal places, not an increment: `250000` is 250,000 USTB. `token` is the token's address. `batchId` names the batch by its release date: the `batch.batchId` that `GET /v1/batch-orders/capital-providers` returns for the batch now taking orders, or a later date.

```bash theme={null}
curl -X PUT "https://api.multiliquid.xyz/v1/batch-orders/capital-providers/$CAPITAL_PROVIDER_ID/capacity" \
  -H "Authorization: Bearer $MULTILIQUID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "network": "evm-mainnet",
    "batchId": "'"$BATCH_ID"'",
    "token": "0x43415eb6ff9db7e26a15b704e7a3edce97d31c4e",
    "posted": "250000"
  }'
```

It returns the token's capacity:

```json Response theme={null}
{
  "token": {
    "address": "0x43415eb6ff9db7e26a15b704e7a3edce97d31c4e",
    "symbol": "USTB",
    "name": "Invesco Short Duration US Government Securities Fund",
    "decimals": 6,
    "kind": "rwa",
    "issuer": "Superstate"
  },
  "status": "active",
  "posted": "250000",
  "reserved": "95.238095",
  "available": "249904.761905"
}
```

You can post for later batches in advance, and change a total until the batch's 4:30 PM cut-off. A batch's `intakeOpen` is about users' orders only: it is `false` for a later batch that still takes capacity. Orders reserve capacity as they arrive, so a new total cannot go below what they already reserve.

## 2. Check what the batch needs

`GET /v1/batch-orders/batches/{batchId}/requirements` totals the output and protocol fees the batch's orders need, by capital provider, operator, and token. `batchId` is the release date, such as `2026-11-06`.

```bash theme={null}
curl "https://api.multiliquid.xyz/v1/batch-orders/batches/$BATCH_ID/requirements?network=evm-mainnet" \
  -H "Authorization: Bearer $MULTILIQUID_API_KEY"
```

```json Response expandable theme={null}
{
  "requirements": [
    {
      "capitalProvider": {
        "id": "0x58e27f2731863499e6a23a1662ebeed9041d6b40996ea9ca7f4ebc54201823b4",
        "name": "Uniform Labs",
        "address": "0x0630582db5a1949509f21b315677c40b9aeb7bda"
      },
      "operator": "0x3333333333333333333333333333333333333333",
      "currentOperator": "0x3333333333333333333333333333333333333333",
      "token": {
        "address": "0x43415eb6ff9db7e26a15b704e7a3edce97d31c4e",
        "symbol": "USTB",
        "name": "Invesco Short Duration US Government Securities Fund",
        "decimals": 6,
        "kind": "rwa",
        "issuer": "Superstate"
      },
      "outputAmount": "95.238095",
      "protocolFeeAmount": "0",
      "orderCount": 1
    }
  ],
  "nextCursor": null
}
```

Make sure your custody can fund those totals before the release.

## 3. Retrieve the released orders, at 5:00 PM

`GET /v1/batch-orders/payloads` returns each released order with its complete signed authorization. Only your organization receives them. The authorization is what the operator executes on-chain, so its `assetInAmt` and `assetOutAmt` are in base units: `1000000000` is 1,000 USDC.

```bash theme={null}
curl "https://api.multiliquid.xyz/v1/batch-orders/payloads?network=evm-mainnet" \
  -H "Authorization: Bearer $MULTILIQUID_API_KEY"
```

```json Response expandable theme={null}
{
  "payloads": [
    {
      "runtime": "evm",
      "orderId": "019a5c1e-8f3b-7c2d-9e4f-6a1b2c3d4e5f",
      "batchId": "2026-11-06",
      "acceptedAt": "2026-11-06T15:04:05Z",
      "releasedAt": "2026-11-06T22:00:01Z",
      "authorization": {
        "chainId": 1,
        "verifyingContract": "0xd66211cf522ba23b59789fff6524c1f03e13e20c",
        "user": "0x2222222222222222222222222222222222222222",
        "operator": "0x3333333333333333333333333333333333333333",
        "receiver": "0x2222222222222222222222222222222222222222",
        "inputs": [
          {
            "routeId": "0",
            "assetInId": "0x58e27f2731863499e6a23a1662ebeed9041d6b40996ea9ca7f4ebc54201823b4",
            "assetOutId": "0x6f640388b2d2075b1c9f2f195fa3d1e4b26167f5e25357294d44c4b7c877da68",
            "stablecoinDelegateId": "0x58e27f2731863499e6a23a1662ebeed9041d6b40996ea9ca7f4ebc54201823b4",
            "assetInAmt": "1000000000",
            "assetOutAmt": "95238095"
          }
        ],
        "unordered": true,
        "nonce": "73956102446718823311893571045",
        "deadline": "1794003300",
        "signature": "0x111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111111b"
      }
    }
  ],
  "nextCursor": null
}
```

On Solana, each payload carries the user-signed transaction with the operator's signature slot empty.

## 4. Execute each order

Your operator executes each order on-chain, targeting 5:15 PM and always before the order's signed deadline. On Solana, the operator adds its signature to the transaction and sends it.

## 5. Report each outcome, by 5:30 PM

Report every order between the release, at or just after 5:00 PM, and the 5:30 PM close, with a `reason`:

| `status` | Report it when |
| - | - |
| `success` | Your operator executed the order |
| `userFailure` | A condition on the user's side prevented execution, such as the user's balance, allowance, or eligibility |
| `capitalProviderFailure` | You could not execute the order |

```bash theme={null}
curl -X POST "https://api.multiliquid.xyz/v1/batch-orders/$ORDER_ID/reports" \
  -H "Authorization: Bearer $MULTILIQUID_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "network": "evm-mainnet",
    "status": "success",
    "reason": "Executed in one transaction.",
    "transactionId": "0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
  }'
```

It answers `201` with the recorded revision:

```json Response theme={null}
{
  "revision": 1,
  "authorUserId": "0f6b1f9e-2c4d-4e8a-9b7c-1d2e3f4a5b6c",
  "receivedAt": "2026-11-06T22:09:00Z",
  "status": "success",
  "reason": "Executed in one transaction.",
  "transactionId": "0x0123456789abcdef0123456789abcdef0123456789abcdef0123456789abcdef"
}
```

A report is a claim, not proof. Multiliquid records each order's outcome from verified on-chain execution, and your latest report counts. An order whose reported success it has not verified is `underReview` until it does. [Reports](https://docs.multiliquid.xyz/api-reference/capital-providers/batch-operations.md#reports) says what each status does to the order.

## When something goes wrong

| Code | What happened | What to do |
| - | - | - |
| `CAPACITY_BELOW_RESERVED` | The new total is below what orders already reserve | Post at least `details.reserved` |
| `CUSTODY_NOT_WHITELISTED` | The RWA's whitelist does not admit your custody, or the RWA has no whitelist adapter | Ask the RWA's issuer to admit your custody. A total of `0` skips this check. |
| `INTAKE_CLOSED` | The batch's 4:30 PM cut-off has passed | Post for a later batch |
| `BATCH_ORDERS_DISABLED` | Batch orders are off for the capital provider | An admin turns them on in the Multiliquid app |
| `REPORTING_CLOSED` | The report is outside 5:00 PM to 5:30 PM | Report within the window |
| `UNAUTHORIZED` | The API key is missing, invalid, expired, or revoked | Send a valid key |
| `INSUFFICIENT_SCOPE` | The API key lacks the route's scope | Use a key with the scope the route needs |
| `FORBIDDEN` | The capital provider belongs to another organization, or a member who is not an admin selected the operator | Use one of your own capital providers. An admin, or a key with `cp:admin`, selects the operator. |
| `NOT_FOUND` | The ID is not a batch order capital provider on the network, or the order is not yours | Check the ID and the network |
| `NETWORK_NOT_ACTIVE` | Batch orders are not active on the network, when you register a nonce account or list your Solana capital providers | Don't retry |

Users cannot prepare orders while you have no operator (`OPERATOR_NOT_SELECTED`), or on Solana while your operator has no idle nonce account (`NONCE_ACCOUNT_UNAVAILABLE`). [Errors](https://docs.multiliquid.xyz/api-reference/guides/errors.md) lists every code.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.