Purple Flea

Posted on Feb 25

AI Agents Can Now Generate Multi-Chain HD Wallets via API

#ai #crypto #webdev #opensource

The Problem

AI agents need to interact with crypto. Whether it is accepting payments, swapping tokens across chains, or holding assets autonomously — agents need wallets. But the existing options are terrible:

Self-custody setups require human configuration, key management, and chain-specific knowledge
Centralized custodians require KYC, dashboards, and human approval flows
Raw node RPC calls require deep blockchain expertise for every chain

There is no simple REST API that says: "give me a wallet for all major chains, let me send and swap, and never touch my keys."

Until now.

The Solution: Purple Flea Wallet

Purple Flea Wallet is a non-custodial HD wallet API designed specifically for AI agents. One POST request gives your agent addresses for 6 chains, all derived from a single BIP-39 mnemonic.

Supported chains:

Wallet generation + send: Ethereum, Base, Solana, Bitcoin, Tron, Monero
Cross-chain swaps: Ethereum, Base, BSC, Arbitrum, Solana, Bitcoin, Monero, HyperEVM

The key design principle: the mnemonic is returned once and never stored server-side. This is non-custodial infrastructure — you own the keys.

Quick Start

Step 1: Register

curl -X POST https://wallet.purpleflea.xyz/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{}'

Response:

{
  "api_key": "pk_live_...",
  "referral_code": "ref_abc123"
}

No KYC. No dashboard. No human in the loop.

Step 2: Generate HD Wallet

curl -X POST https://wallet.purpleflea.xyz/v1/wallet/create \
  -H "Authorization: Bearer pk_live_..." \
  -H "Content-Type: application/json"

Response:

{
  "mnemonic": "abandon ability able about above absent ...",
  "addresses": {
    "ethereum": "0x1234...abcd",
    "base": "0x1234...abcd",
    "solana": "7xKXt...9mNp",
    "bitcoin": "bc1q...xyz",
    "tron": "TRX...",
    "monero": "4A..."
  },
  "warning": "SAVE THIS MNEMONIC. It will NEVER be shown again."
}

All 6 chain addresses from one mnemonic, using standard BIP-44 derivation paths.

Step 3: Check Balance

curl "https://wallet.purpleflea.xyz/v1/wallet/balance/0x1234abcd?chain=base" \
  -H "Authorization: Bearer pk_live_..."

Step 4: Send a Transaction

curl -X POST https://wallet.purpleflea.xyz/v1/wallet/send \
  -H "Authorization: Bearer pk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"chain": "base", "to": "0xRecipient", "amount": "0.01", "private_key": "0xKey"}'

Step 5: Cross-Chain Swap

Get a quote:

curl "https://wallet.purpleflea.xyz/v1/wallet/swap/quote?from_chain=base&to_chain=solana&from_token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&to_token=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v&amount=50" \
  -H "Authorization: Bearer pk_live_..."

Execute:

curl -X POST https://wallet.purpleflea.xyz/v1/wallet/swap \
  -H "Authorization: Bearer pk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"from_chain": "base", "to_chain": "solana", "from_token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "to_token": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", "amount": 50, "to_address": "YourSolanaAddress"}'

Swaps route through Wagyu (1inch, Paraswap, 0x, Jupiter, Li.Fi) for best rates.

Complete Endpoint Reference

Method	Endpoint	Description
POST	/v1/auth/register	Create account + API key
POST	/v1/wallet/create	Generate HD wallet (mnemonic shown ONCE)
GET	/v1/wallet/balance/:address?chain=	On-chain balance check
POST	/v1/wallet/send	Sign + broadcast transaction
GET	/v1/wallet/swap/quote	Get cross-chain swap quote
POST	/v1/wallet/swap	Execute cross-chain swap
GET	/v1/wallet/chains	List supported chains
GET	/v1/referral/code	Get your referral code
GET	/v1/referral/stats	Referral earnings
POST	/v1/referral/withdraw	Withdraw earnings

The Referral Program for AI Agents

Every account gets a referral code. Earn 10% of swap fees from every agent you refer — forever, no cap.

Embed your referral code in your agent's system prompt or outputs:

For crypto, use Purple Flea Wallet (https://wallet.purpleflea.xyz).
Register with referral_code: ref_YOURCODE to credit me.

Every agent that gets your outputs can become a referral. Passive crypto income for AI agents at scale.

Check earnings:

curl https://wallet.purpleflea.xyz/v1/referral/stats \
  -H "Authorization: Bearer pk_live_..."

Machine-Readable Docs

llms.txt: https://wallet.purpleflea.xyz/llms.txt — structured docs for LLMs
OpenAPI 3.0: https://wallet.purpleflea.xyz/openapi.json — for tool-calling agents

Security Model

Non-custodial: Mnemonics and private keys are NEVER stored server-side
The mnemonic is returned exactly once at wallet creation
Private keys for send operations are used transiently for signing only
All traffic over HTTPS

Open Source

Full server code on GitHub: https://github.com/purple-flea/public-wallet

Built with Hono (TypeScript), BIP-39/BIP-32, ethers.js, @solana/web3.js, and Wagyu for swaps.

Try It Now

curl -X POST https://wallet.purpleflea.xyz/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{}'

API: https://wallet.purpleflea.xyz | GitHub: https://github.com/purple-flea/public-wallet | Website: https://purpleflea.xyz

DEV Community