Back to Piggy

Developer

Piggy Bank API

Add Piggy Bank to apps, wallets, or agents. Scan one wallet's balances, estimate sweepable value, and prepare transaction data on Base and BNB Chain.

1. Overview2. API Routes3. Limits

Wallet balance scan

Scan is not a token holder scan. It analyzes the token balances of one provided wallet address.

Two paid routes

Scan finds sweepable balances. Build prepares quote-backed transaction data for selected tokens.

Base USDC payment

Scan and Build are protected by x402. Catalog stays free so clients can read route metadata before paying.

API Routes

Scan

POST/api/v1/piggy/scan

$0.005 USDC

Scan one wallet address for sweepable token balances on Base or BNB Chain.

Build

POST/api/v1/piggy/digest

$0.025 USDC

Prepare quote-backed transaction data for selected balances.

Catalog

GET/api/v1/piggy/catalog

Free

Read Piggy Bank API metadata before paying for Scan or Build.

Limits

Chains

Base and BNB Chain.

Route safety

If a token cannot be routed safely, it is skipped instead of returned as a transaction.

Wallet signing

Piggy Bank returns payloads only. The connected wallet still reviews and signs each transaction.