REST API

The authenticated creator's profile and balance summary — handle, display name, current credit, whether a key has been claimed, and the key fingerprint.

Current inference credit plus the live key view fetched from OpenRouter: live_usage, live_limit, and disabled. The live fields are eventually consistent and may be null if the provider is unreachable.

Your tips, newest first.

{
  "data": [
    { "id": "369330cb-…", "creator_handle": "copyleftdev", "status": "settled",
      "gross": "5.000000", "net_to_tokens": "4.068225",
      "tipper_name": null, "tipper_note": null,
      "created_at": "2026-07-19T10:03:00Z",
      "held_at": "2026-07-19T10:03:20Z", "settled_at": "2026-07-19T10:07:00Z" }
  ],
  "next_cursor": null
}

One tip, by id. 404 if it is not yours.

The active key's non-secret fingerprint, mint time, and live usage. Never returns the secret — it is not stored. 404 before you have claimed a key.

Disables the current key and mints a replacement carrying the same balance. The new secret is returned exactly once — save it before you close the response. Accepts Idempotency-Key. Emits key.rotated.

{ "secret": "sk-or-v1-…", "fingerprint": "sk-or-v1-117…2dce",
  "limit": "4.068225", "minted_at": "2026-07-19T10:07:00Z" }

Lifetime aggregates: tips total, settled, and held, plus settled gross, settled net (the inference credit you have received), and lifetime gross.

Your tokens — id, non-secret prefix, name, scope, and when each was created and last used. Never the token itself. A creator-scoped token sees only creator-scoped tokens; an operator token sees every token on the account.

Revoke immediately. 204 on success, 404 if it is not yours or not visible to your scope. A token may revoke itself. A creator-scoped token cannot revoke an operator-scoped one, so a leaked creator token cannot lock you out of your own operator access.

Your registered endpoints. Secrets are never returned here.

Register an endpoint. Returns 201 with the signing secret once. Omit events to receive everything in scope.

{ "url": "https://you.example/hook", "events": ["tip.settled"] }

Every entry in events must be a type from the catalogue; an unknown one is rejected with 400 rather than silently subscribing you to nothing. stream.lagged is stream-only and cannot be delivered by webhook.

Remove an endpoint. 204 on success, 404 if it is not yours.

A text/event-stream of your own events, held open until you disconnect.

The system-wide stream: every creator's events plus operator-only solvency and abuse signals.

System snapshot: the solvency pool (committed credit, drawable balance, headroom, state), money totals, and vitals.

Every tip across every creator, newest first. Same pagination and filters as /v1/tips.

Creators with balances and live key usage joined in. Takes limit and cursor.

Force-settle a held tip now, bypassing the fraud-hold window. The solvency guard still applies: if the grant would over-commit the pool the tip stays held and the response says so. Accepts Idempotency-Key.

{ "status": "settled", "message": "settled — inference credit granted" }

Kill switch for fraud response — remotely disables a creator's live key. The creator can rotate to restore access.