Seller Endpoints

Returns a SIWE message with nonce and 5-minute expiry. The message must be signed and returned within 5 minutes. The server validates domain, uri, chainId, issuedAt (must be within ±5min of server time), and expirationTime (max 10min from issuedAt).

Exchange the signed SIWE message for a seller API key. Save the returned key — it will not be shown again.

Create another si_seller_… key (up to 25 active per wallet). Requires an Idempotency-Key header. The secret is in the key field of the response, shown once.

List keys, redacted (id, key_prefix, label, timestamps, revoked_at). An existing seller key or web session authorizes this.

Revoke a key. Irreversible; returns 204.

Create offer.

Update price/caps.

Deactivate / soft-delete (encrypted key is retained; revoke at provider for immediate key invalidation).

List my offers (filter with ?model=, ?status=active|paused|inactive; paginate with max_items / next_token).

Read one offer (status, health, price, caps).

To deactivate every active offer at once, use POST /v1/seller/offers/bulk-cancel (see Offer operations); otherwise remove them one at a time.

One offer per credential, base URL and model

The same API key can back as many different models as you like — that is the normal case and nothing about it changes. What is refused is a second active offer for the same model on the same key and base URL, whoever owns it: the rule is global across workspaces and organizations.

A conflict returns 409 duplicate_offer_for_credential. When the existing offer is your own, the response carries its offer_id in error.detail so you can update or delete it instead of creating a duplicate; when it belongs to someone else, no identifier is returned.

The same rule applies to anything that brings an offer back into the active set — reactivating a paused offer, or rotating a credential onto a key that already serves that model. Deleting or deactivating an offer frees its slot, so the key can be relisted for that model straight away; if a slot ever appears stuck, the next listing attempt reclaims it automatically.

When the conflicting offer is your own, its id is returned as error.detail.existing_offer_id.

In bulk creation, a conflicting row comes back as status: "error" with duplicate_offer_for_credential in the message; retrying will not change the outcome.

Offers Surplus has delisted

Surplus deactivates an offer itself when its provider endpoint cannot serve the model it is listed for — for example a video model listed against a host that exposes no video API at all. Such an offer can never complete a job: every request routed to it fails after the buyer has been quoted.

A delisted offer stays visible and editable, but setting status: "active" on it returns 400 offer_delisted_by_operator and it is not restored by rotating its credential. It is not a pause you can undo. List the model against a provider that serves it, or contact support if you believe the endpoint does work.

Create multiple offers from discovery results.

Up to 200 offers per request. Bulk-created offers support the same cap_daily_usd field as single-offer creation.

Deactivate ALL of your active offers in one call. Fire-and-forget: returns 202 with an operation_id; poll it for progress.

Clear an offer's failure backoff and return it to rotation immediately.

Swap an offer's upstream provider key in place, without recreating it.

Poll an async operation (such as a bulk cancel) for status, processed, total, and failed_count.

Auto-detect models + pricing from a provider. Requires seller auth; streams NDJSON, one line per model.

Parses Venice, OpenRouter, Bankr, and generic pricing formats automatically.

Verify endpoint is reachable and returns valid responses.

Precomputed earnings for a range: total_earned_usdc, pending_usdc, in_flight_usdc, paid_usdc (integer micro-USD strings), plus daily, by_model, share, a recent_sales teaser (up to 20), and any payout_hold.

Query param: range = 7d (default), 30d, 90d, or lifetime. Team orgs can add ?workspace_id=.

Returns recent health events for your offers (failures, backoffs, recoveries).

Query params: offer_id (filter to one offer), since / until (ms epoch), max_items, next_token, sort_order (ASC | DESC).

Your payout position: available_usdc, in_flight_usdc, paid_usdc, the threshold_usdc, per-recipient groups, and executed-payout history with Base transaction hashes.

Request a withdrawal of your available balance. In batched mode the scheduled drain settles the pending balance (status: scheduled); self_submit: true instead requests a signed EIP-3009 authorization for you to broadcast yourself (paying your own gas). A withheld balance returns status: held with a reason.

Report the on-chain tx_hash for a payout you broadcast yourself.