Orders

Place several orders at once

Up to 25 orders — several services, one link or several — paid together from your balance. Every order is checked first, at today’s price, exactly as it would be placed (link, quantity, order fields, your key’s caps, running orders per link counting the batch’s own, your balance for all of it). If any one cannot go, none is placed and nothing is charged: batch_invalid with every item’s reason in details.items (or insufficient_balance with the shortfall for all of it).

Then each is placed on its own, never above the price just checked. Should one fail at that very moment (your balance spent elsewhere meanwhile), the others stay placed and that one says why — nothing is charged for it.

A batch counts as one checkout for the orders-per-minute pace: checked once before the first order, so a batch of 10 is not stopped half-way by its own orders.

Send an Idempotency-Key: a retry with the same key places exactly the same orders again — the ones placed answer with their order, never a second charge; the same key with other orders is idempotency_conflict. max_total (the total you agreed to) refuses everything with price_changed if prices moved above it. dry_run: true checks and prices only.

An item with a schedule becomes an automation (nothing charged now; each part when it goes).

post/api/v1/orders/batch

Request

  • Base URL: https://spoofy.social
  • URL: https://spoofy.social/api/v1/orders/batch
  • Auth: one of:
    • HTTP bearer
    • API key in cookie better-auth.session_token

Headers

Idempotency-Keystring

Any unique string (≤ 120 chars) per intended order. Retrying with the same key returns the first order instead of charging twice.

Request body

dry_runboolean
max_totalstring

The most to pay now, USD (the total you showed and agreed to).

Response

A dry run — or a replay of an earlier batch with the same Idempotency-Key (replayed: true, the same batch).

dry_rununknown
okboolean

Every order can go, nothing stops the batch, and your balance holds it.

totalstring

Today’s price of all of it. USD as a decimal string.

needsstring

What your balance must hold now. USD as a decimal string.

balancestring

Your balance. USD as a decimal string.

sufficientboolean
shortfallstring

What to top up first (0.00 when nothing). USD as a decimal string.

Changes

No recorded changes to this operation across all 1 revision of this API.