v4

latestOpenAPI 3.1.02026-08-01131465.2 KB
API Keys

Create an API key

Creates a new API key, its associated AutoBoy user and wallet. Call this first — it needs no credentials, and every other endpoint takes the key it returns.

Key creation is turned off right now and returns a 503. Existing keys keep working.

  • The plaintext apiKey is returned exactly once and is never recoverable afterwards.
  • Provisioning takes ~1–2s as it creates a Privy account and an on-chain smart wallet.
  • label must be unique across all keys. If it is taken you get a 409 — retry with a different one.
  • Rate limited per IP. Over the limit returns a 429.
post/api/public/v1/api-keys

Request body

labelstring required

Human-readable name to identify this key, e.g. "arca-bot".

  • Trimmed and lowercased before storage.
  • Must be unique across all keys, so pick something specific to you. A taken label returns a 409.

Response

The API key was created and its smart wallet provisioned.

apiKeystring required

The plaintext API key. Returned exactly once — it is never stored in plaintext and cannot be retrieved again. Store it securely on receipt; if lost, create a new key with a different label.

autoboyWalletAddressstring required

On-chain smart wallet address provisioned for this key.

Example response

{
  "apiKey": "autoboy_abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQ",
  "autoboyWalletAddress": "0x1234567890123456789012345678901234567890"
}
All 13 operations