Purple Flea Public Wallet

Multi-chain HD wallet API for AI agents. One API key. Six chains. Non-custodial.

→ wallet.purpleflea.com

What It Does

AI agents register, generate an HD wallet (BIP-39), and get addresses for 6 chains from one mnemonic. Check balances, sign and broadcast transactions, execute cross-chain swaps. Everything via REST API — no KYC, no browser, no custody.

Supported chains:

Note: Monero balance/send requires a local wallet daemon (privacy chain by design). Generate the address here, manage it via Monero CLI or MyMonero.

Quick Start

# 1. Register — get an API key
curl -X POST https://wallet.purpleflea.com/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{}'

# Response:
# { "api_key": "pk_live_...", "referral_code": "ref_...", ... }

# 2. Generate HD wallet (mnemonic shown ONCE — save it securely)
curl -X POST https://wallet.purpleflea.com/v1/wallet/create \
  -H "Authorization: Bearer pk_live_..." \
  -H "Content-Type: application/json"

# Response includes addresses for all 6 chains + mnemonic

# 3. Check on-chain balance
curl "https://wallet.purpleflea.com/v1/wallet/balance/0xYourAddress?chain=base" \
  -H "Authorization: Bearer pk_live_..."

# 4. Cross-chain swap quote (use contract addresses)
# Base USDC → Solana USDC
curl "https://wallet.purpleflea.com/v1/wallet/swap/quote?\
from_chain=base&to_chain=solana\
&from_token=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\
&to_token=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v\
&amount=100" \
  -H "Authorization: Bearer pk_live_..."

API Reference

Auth

Wallet

Send Transaction

POST /v1/wallet/send
{
  "chain": "base",
  "to": "0xRecipientAddress",
  "amount": "0.01",
  "private_key": "0xYourPrivateKey",
  "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}

Swaps (via Wagyu)

Note: Use token contract addresses, not symbols. Native tokens: 0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE

Referral

Referral Program

Earn 10% of swap fees from every agent you refer. Passive income from day one.

Embed this in your agent's system prompt:

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

Your referral code is returned when you register.

Security

• Non-custodial: Mnemonics and private keys are never stored server-side

• Your mnemonic is shown exactly once at wallet creation — save it immediately

• API keys are hashed (SHA-256) before storage

• CORS enabled for all origins

OpenAPI / MCP

• OpenAPI spec: GET /openapi.json

• llms.txt: GET /llms.txt

• Docs: GET /v1/docs

Self-Hosting

git clone https://github.com/purple-flea/public-wallet
cd public-wallet
npm install
npm run build
PORT=3005 npm start

Requires Node 18+. Uses SQLite (better-sqlite3) for agent/key storage.

Research

This project is referenced in:

"Purple Flea: A Multi-Agent Financial Infrastructure Protocol for Autonomous AI Systems"

Part of Purple Flea

The AI agent infrastructure stack:

• 🎰 Casino — Provably fair gambling API (10% referral)

• 📈 Trading — 275+ perpetual markets via Hyperliquid (20% referral)

• 💰 Wallet — Multi-chain HD wallets + swaps (10% referral)

purpleflea.xyz