Agara
Batches

Replace a pending account batch

POST
/trade/v1/batches/{batch_hash}/supersede

Authorization

Authorization
Required
Bearer <token>

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

In: header

Scope: batches:submit

Request Body

application/jsonRequired

deadline_unix_seconds
Required
integer

Signature deadline, unix seconds.

Minimum: 0Format: "int64"

ops
Required
array<object | object | object | object | object | object | object>

Typed ops in execution order.

signature
Required
string

Holder signature over the successor digest (same seq), 0x hex.

Path Parameters

batch_hash
Required
string

The PENDING batch to replace

curl -X POST "https://app.agara.xyz/trade/v1/batches/string/supersede" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "deadline_unix_seconds": 1794700800,
    "ops": [
      {
        "amount_micro": 1000000,
        "destination": "0x1111111111111111111111111111111111111111",
        "kind": "WITHDRAW"
      }
    ],
    "signature": "0x4f3a8e9b00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000001b"
  }'

Successor accepted at the same seq.

{
  "batch": {
    "batch_hash": "string",
    "created_at": "2019-08-24T14:15:22Z",
    "deadline_unix_seconds": 0,
    "executed_at": "2019-08-24T14:15:22Z",
    "failure_reason": "string",
    "heals_batch_hash": "string",
    "origin": "string",
    "seq": 0,
    "status": "string",
    "superseded_by_batch_hash": "string",
    "tx_hash": "string",
    "unwound_at": "2019-08-24T14:15:22Z"
  },
  "outcome": "SUPERSEDED"
}

Previous

Get a batch group GET

Next

Profile