Skip to main content
All endpoints below are under https://api.puffinmoney.com/v1/gateway/api and require the X-API-Key header — see Authentication. See Wallet-as-a-Service for a walkthrough.

Create a wallet

POST /wallets Supports the same Idempotency-Key header as payment intents. Returns 402 plan_limit if you’re at your plan’s wallet cap, 400 unsupported_asset if the chain/token pair isn’t in the WaaS matrix (the response body includes the current supported matrix so you don’t have to hardcode it).

List wallets

GET /wallets — returns every wallet you’ve created via this API, plus the current supported chain/token matrix.

Get a wallet

GET /wallets/:id

Get a balance

GET /wallets/:id/balance

List deposits

GET /wallets/:id/deposits — up to the 50 most recent deposits to this wallet.

Send a withdrawal

POST /wallets/:id/withdrawals Debits the wallet immediately (reserved before broadcast — you can’t double-spend by racing two withdrawal calls). Fees are charged per your waas capability pricing — see Pricing.
Need to move funds to a different chain, not just a different address on the same chain? Use Bridge instead.