WalletPress API 🟢

Base URL: http://<your-host>:8001

Wallets

Method	Path	Description
POST	/v1/wallets	Create wallet (label + addresses)
GET	/v1/wallets	List wallets
GET	/v1/wallets/{id}	Wallet detail + balances
DELETE	/v1/wallets/{id}	Delete wallet

Balances & portfolio

Method	Path	Description
GET	/v1/wallets/{id}/balances	All balances, USD-valued
GET	/v1/wallets/{id}/portfolio	Aggregated allocation + P&L
GET	/v1/portfolio	Cross-wallet aggregate

Transactions

Method	Path	Description
GET	/v1/wallets/{id}/tx?chain=&cursor=	Paginated history

Example

curl http://localhost:8001/v1/wallets/w1/balances

{
  "wallet_id": "w1",
  "total_usd": 48213.55,
  "balances": [
    {"chain": "solana", "symbol": "SOL", "amount": "182.4", "usd": 31008.0},
    {"chain": "ethereum", "symbol": "ETH", "amount": "5.1", "usd": 17205.55}
  ],
  "as_of": "2026-08-30T00:00:00Z"
}