> ## Documentation Index
> Fetch the complete documentation index at: https://docs.puffinmoney.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

<CardGroup cols={2}>
  <Card title="Smart routing" icon="bolt">
    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.
  </Card>

  <Card title="One endpoint, always" icon="shuffle">
    Same-asset transfers between chains and cross-asset swaps both go
    through the same call. You never choose the mechanism yourself.
  </Card>
</CardGroup>

`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

```bash theme={null}
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..."
  }'
```

```json theme={null}
{
  "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](/teams-and-plans#usage-based-pricing) for how
it's configured. When you're ready:

```bash theme={null}
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.

```bash theme={null}
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](/webhooks)
for the full payload shape.

<Note>
  Bridging is USDC/USDT-only today, matching the [Wallet-as-a-Service](/wallets)
  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.
</Note>