Skip to main content

Building AI Agents

Can I use Bankr to power an AI agent I'm building?​

Yes — this is one of Bankr's core use cases. Bankr gives your agent a cross-chain wallet, trading capabilities, token launching, and fee collection out of the box. Your agent can fund its own compute from the trading fees it earns.

What's the easiest way to get my agent trading?​

If you're building with OpenClaw or IronClaw, install the Bankr skill. Your agent gets full trading, token launching, and portfolio management immediately.

See OpenClaw Installation for the setup guide.

How do I integrate Bankr via API?​

Generate an API key at bankr.bot/api, then use the REST API to submit natural language prompts and poll for results.

See Agent API Overview and Authentication.

My new API key isn't working for trades or transfers — it seems read-only. Why?​

API keys generated after February 17, 2026 are read-only by default. Swap, transfer, and deploy operations are blocked until you explicitly enable write access.

Fix: go to bankr.bot/api, find your key, and enable the write permissions you need.

My Agent API job is timing out before completing — what timeout should I use?​

Most Agent API jobs complete in under 30 seconds, but complex operations (token launches, leveraged trades, cross-chain swaps) can take up to 5 minutes.

For production systems, set a minimum 5-minute timeout with exponential backoff. The 2-minute example shown in some docs (60 attempts × 2s) is too short for long-running jobs.

The internal maximum timeout is 60 minutes.

My DCA or limit order set via the Agent API keeps failing — why?​

Automations (DCA, limit orders, stop orders) submitted via the Agent API prompt endpoint can fail in some cases due to platform configuration issues.

For now, automations work most reliably when created via the Bankr Terminal, CLI, or social interfaces (X, Farcaster, Telegram). Use these as a workaround while API-based automation support is improved.

What are trusted addresses for agent API keys and what do they do?​

Trusted addresses whitelist the wallet addresses that Bankr is allowed to send funds to via your API key.

  • Any transfer to an address not on your list is hard-blocked
  • This applies to token transfers, swaps, and typed-data signatures
  • Your own Bankr wallet is always implicitly allowed

Security value: if your API key is ever compromised, an attacker can't drain your wallet to an arbitrary address. They'd be blocked at execution, giving you time to revoke and regenerate the key.

You don't need to add your own Bankr wallet — it's always allowed. Add external addresses you actually send to: cold wallets, CEX deposit addresses, teammate wallets.

What is a trusted IP whitelist on my API key?​

A trusted IP whitelist restricts which IP addresses can make requests using your API key. Requests from IPs not on the list are rejected before reaching the agent.

This is the companion to trusted addresses:

  • Trusted addresses protect where funds go
  • Trusted IPs protect who can issue commands

Together they form strong defense-in-depth — a compromised key is useless without also being on an approved IP.

Use if: you're running agents on a fixed server/VPS with a static IP. Can skip if you're testing locally with dynamic IPs.

I had Bankr execute a Polymarket trade but now it can't sell the shares — why?​

A few things can block Polymarket sells:

  • Platform restriction — Polymarket isn't supported over XMTP chat or in wallet mode. Use the Bankr Terminal or Agent API instead
  • Market already resolved — if the market closed, you redeem instead of sell. Try: Redeem my Polymarket winnings
  • Low liquidity — thin order books mean there may not be enough buyers right now
  • Step limit on X — long multi-step Polymarket operations on X can hit execution limits. Break it into smaller steps

What to try:

Show my Polymarket positions
Sell my [X] shares on [market name]
Redeem my Polymarket winnings

Is there a risk when sending funds to a social handle (Farcaster, Telegram)?​

Yes — use caution. Bankr resolves handles to wallet addresses using cached data that refreshes approximately every 7 days. If a handle was recently transferred to a new owner, funds may be sent to the previous owner's wallet address.

Best practice: for large transfers, verify the recipient's wallet address on-chain before sending. When in doubt, use the direct wallet address rather than a social handle.