Documentation

Everything you need to give your AI agent a crypto wallet.

API Base URL

All requests go to:

https://api.aiwallet.tech

Quickstart

Three steps to get your agent transacting onchain.

1

Create a wallet

Create wallet
curl -X POST https://api.aiwallet.tech/wallet/create \
  -H "Content-Type: application/json" \
  -d '{"userId": "my-agent"}'

This generates a Base (EVM) + Solana wallet pair. Private keys are encrypted server-side with AES-256-GCM. You get back public addresses only.

2

Fund the wallet

Send ETH (on Base network) or SOL to the addresses returned in step 1. You need a small amount for gas fees. For testing, use small amounts — wallets are stored in memory and will reset if the server restarts.

3

Start transacting

Use natural language or call endpoints directly:

Natural language
curl -X POST https://api.aiwallet.tech/agent/chat \
  -H "Content-Type: application/json" \
  -d '{"userId": "my-agent", "message": "swap 0.01 ETH to USDC on base"}'
Direct endpoint
curl -X POST https://api.aiwallet.tech/tx/swap/execute \
  -H "Content-Type: application/json" \
  -d '{"userId": "my-agent", "chain": "base", "sellToken": "ETH", "buyToken": "USDC", "amount": "0.01"}'

Agent Integration

Three ways your agent can discover and use AIWallet:

OpenAPI 3.1
https://api.aiwallet.tech/openapi.json
Full spec with schemas. Drop into any agent framework that supports OpenAPI tool discovery.
MCP Tools
https://api.aiwallet.tech/.well-known/mcp.json
5 pre-defined tools. Works with Claude Desktop, Claude Code, and any MCP-compatible agent.
Natural Language
POST https://api.aiwallet.tech/agent/chat
Send plain English. The agent parses intent and routes the action. Zero schema mapping needed.

API Reference

Click any endpoint to see request/response examples.

Agent

Wallet

Transactions

Discovery

Supported Chains

Base
EVM Layer 2
ETH, USDC, WETH, DAI, USDbC
0x Protocol — 150+ liquidity sources
Solana
SPL
SOL, USDC, USDT, BONK, JUP, WIF
Jupiter — Raydium, Orca, + more

Security

Encrypted at rest — Private keys stored with AES-256-GCM. Never plaintext, never logged.
Decrypt-sign-wipe — Keys decrypted only at signing time, then immediately wiped from memory.
No key export — No endpoint ever returns private keys. Signing capability without key exposure.
Production path — For production, swap the key vault to Turnkey, Fireblocks, or AWS KMS. Same API, hardened storage.

Important Notes

Your userId is your wallet identifier. Use the same ID across requests to access the same wallet.
Wallets are currently stored in memory. If the server restarts, wallets reset. Fund with small amounts for testing.
You need ETH on Base for gas fees, even when swapping ERC-20 tokens.
All amounts are human-readable — send "0.1" not "100000000000000000".