API Reference

Botanary is self-custodial: the API never holds a key and never signs. Every operation that moves funds or grants authority is a two-phase flow - the backend builds an unsigned ERC-4337 UserOp, the owner signs it client-side, and only then is the signed op relayed to the bundler.

Every endpoint below is generated directly from the OpenAPI spec, including request/response schemas and a live "Try it" panel.

Endpoint groups

• Session - Exchange a Privy auth token for a Botanary session token.
• Account - The owner's self-custodial ERC-7579 smart account.
• Devices - Manage the device set on the account's validator.
• Balance - Unified multi-stablecoin balance and reference data.
• Delegations - Scoped, revocable session-key delegations.
• Activity - The tamper-evident, hash-chained audit log.
• Rules - On-chain account rules: caps, allowlists, denylists.
• Simulation - Pre-flight preview of an intent before signing.
• Money - Send, receive, and swap intents.
• Gas - Owner-selectable gas methods and per-method balances.
• Notifications - The alerts feed.
• Recovery - On-chain guardian / social-recovery module.
• Depeg - Depeg visibility for held stablecoins.
• User Ops - Relay a client-signed UserOp to the bundler.
• Agent - Build seams for the agent runtime.
• Waitlist - Public pre-launch waitlist signup.
• Marketplace - Read-only discovery of the agent marketplace.
• Market - Read-only tokenized-equity catalog.
• Launchpad - Read-only browse of the token launchpad.
• Markets - The unified market token index.