Bridging & swaps

Move USDC and USDT across Solana, Polygon, BSC, and Base from one API

Puffin automatically routes cross-chain transfers the fastest safe way for the specific pair you’re moving — you call one endpoint, we handle picking and executing the route.

How it works

Smart routing

Every transfer is evaluated against the assets and chains involved, and routed however it completes fastest and most reliably — no wrapped assets, no manual liquidity-pool slippage to account for.

One endpoint, always

Same-asset transfers between chains and cross-asset swaps both go through the same call. You never choose the mechanism yourself.

POST /bridge/quote tells you the network fee and an ETA before you commit — route in the response is an internal routing identifier for support purposes only; it’s not something you need to branch on client-side.

Quote, then execute

curl -X POST https://api.puffinmoney.com/v1/gateway/api/bridge/quote \
  -H "X-API-Key: mk_live_..." \
  -d '{
    "walletId": "8f2a1c...",
    "toChain": "BASE",
    "toToken": "USDC_BASE",
    "amount": "1000.00",
    "destinationAddress": "0xabc..."
  }'

{
  "quote": { "route": "auto", "networkFee": "0.10", "estimatedOutAmount": "999.90", "etaSeconds": 30 },
  "ourFee": { "platformFee": "1.00", "gasFee": "0.05", "totalFee": "1.05" }
}

ourFee is Puffin’s platform + gas-recovery charge on top of the quoted network fee — see Pricing for how it’s configured. When you’re ready:

curl -X POST https://api.puffinmoney.com/v1/gateway/api/bridge \
  -H "X-API-Key: mk_live_..." \
  -H "Idempotency-Key: bridge_2026-07-22_001" \
  -d '{
    "walletId": "8f2a1c...",
    "toChain": "BASE",
    "toToken": "USDC_BASE",
    "amount": "1000.00",
    "destinationAddress": "0xabc..."
  }'

This debits the source wallet immediately and returns a bridgeTransfer you can poll — or just wait for the webhook.

curl https://api.puffinmoney.com/v1/gateway/api/bridge/<id> \
  -H "X-API-Key: mk_live_..."

Status	Meaning
pending / source_sent	Debited, broadcasting the source-side transaction
attesting	Confirming the transfer before it can be delivered on the destination chain
completed	Funds delivered to destinationAddress on toChain
failed / refunded	Did not complete — see metadata for details

Webhooks

Subscribe to bridge.completed and bridge.failed — see Webhooks for the full payload shape.

Bridging is USDC/USDT-only today, matching the Wallet-as-a-Service chain/token matrix (Solana, Polygon, BSC, Base). A bridge request for an unconfigured route returns bridge_not_configured — this is an operational gate on our side while a corridor is being rolled out, not something you can work around client-side.