How Do I Execute Direct Transactions via the Wallet API?
In this article
In this article group
- How Do I Create a Project Page?
- How Do I Trigger My Agent from External Apps (Webhooks)?
- Using Bankr from Claude Code
- How Do I Create a Paid API Endpoint with x402 Cloud?
- How Do I Provision Wallets for My Users?
- Why Isn't My x402 Endpoint Listed in the Marketplace?
- How Do I Use Private (Confidential) AI Models?
Use the Wallet API when your code knows exactly what transaction it wants. It skips the AI agent and runs the transfer, swap, signature, or raw transaction you specify, with low latency. If you want to describe what you want in plain English instead, use chat or the Agent API.
What You Need
An API key from bankr.bot/api-keys with Wallet API enabled (it's on by default) and read-only turned off.
Requests go to
https://api.bankr.bot. It covers transfers, swaps (same-chain EVM, Solana, and cross-chain all use one swap endpoint), signing, and broadcasting. The Bankr CLI wraps the same operations if you prefer the command line.
Gotchas
403 on a write? Your key is probably read-only. A 403 on a swap can also mean the token was flagged by Bankr's security scan.
Swaps are quote, then execute. Get a quote first, then execute using the minimum amount the quote returned. On some routes execution uses a tighter slippage than your quote did.
Tokenized stocks need a passed location check. Without one, executing the swap returns 403. Quotes aren't checked, so a quote that works doesn't mean the swap will.
Amounts and chains: transfers and swaps take human-readable amounts and chain names. Raw transaction submits use base units and numeric chain IDs.
Who signs: Bankr signs Wallet API calls with your Bankr wallet on the server. If you use your own self-custody wallet, use the build endpoints instead and sign, broadcast, and pay gas yourself.
For endpoints, parameters, and request and response formats, see the Wallet API reference on docs.bankr.bot.