Skip to main content

Agent API Overview

The Agent API allows you to interact with Bankr's AI agent to execute prompts and transactions on behalf of your wallet.

Capabilities​

Using the Agent API, you can:

  • Submit prompts to the Bankr AI agent for your wallet
  • Check the status of submitted jobs
  • Cancel pending or processing jobs
  • Manage your project page (the /agent/profile endpoints, which keep the older name)
Wallet Operations

Non-agentic operations (balances, signing, submitting transactions) live under the Wallet API.

Getting Started​

  1. Sign up at bankr.bot/api-keys
  2. Generate an API key — Agent API access is on by default for new keys
  3. Subscribe to Bankr Club or top up LLM credits for Max Mode — one of these is required
  4. Fund your account with the assets you want to trade
  5. Start making requests using your API key
Security

Do not share your Bankr API key with anyone or any untrusted app. If you share your API key with agent access enabled, you risk losing all assets in that Bankr account.

If you leak your API key, visit bankr.bot/api-keys and revoke it immediately. For production agents, use a dedicated account with a scoped key — see API Keys.

OpenAPI specification​

The public API-key surface — Agent, Wallet, Tokens, Token Launches, Fees, Agent Profiles, Files, Bankr Club, LLM Credits, x402 Cloud and Webhooks — is described in a single OpenAPI 3.0 document at /openapi/api.yaml. It is a raw file meant for AI agents, tool integrations and client code generation; point your generator or agent at https://docs.bankr.bot/openapi/api.yaml.

Example Applications​

Check out example apps built on the Agent API:

github.com/BankrBot/bankr-api-examples

Base URL​

https://api.bankr.bot

Authentication​

All endpoints require an API key with Agent API access enabled, sent as X-API-Key (or Authorization: Bearer <key>):

X-API-Key: your_api_key_here

Basic Flow​

Submit a prompt with POST /agent/prompt: it answers 202 Accepted with a jobId and a threadId. Poll GET /agent/job/{jobId} about every 2 seconds until status is completed, failed or cancelled, then read response. See Prompt Endpoint and Job Management for the request, response and status details.

Next Steps​