Move Money with Pods Ramp

Money movement routes are available only after Ramp status is approved. See Set up Pods Ramp to get a user to that state, and Track Pods Ramp status to poll both KYC approval and quote status. Pods Ramp uses the same Swap v2 quote routes across every supported country: originChain/destinationChain of fiat select the local payment rail, and tokenIn/tokenOut select the fiat currency or on-chain asset. Brazil Pix and foreign USD (WIRE/ACH) are live today; Mexico, Colombia, and Argentina will use their own local rail and currency through the same routes once live. Send all requests from your backend with x-api-key; never expose PODS_API_KEY to a browser or mobile client.

Supported Brazil Pix routes

Direction	Public pair	Chains (v1)	Fees
Onramp	Pix BRL → USDC	`base`, `monad`	Pix rail + Pods/customer swap fees (when configured) + bridge/slippage as shown in `feeBreakdown`
Offramp	USDC → Pix BRL	`base`, `monad`	Same commercial model as USDC onramp
Onramp	Pix BRL → BRLA	`polygon` only	No Pods/customer markup — amounts pass through Avenia; optional Avenia Pix fee as `paymentRail`
Offramp	BRLA → Pix BRL	`polygon` only	No Pods/customer markup — amounts pass through Avenia; optional Avenia Pix fee as `paymentRail`
Onramp	Pix BRL → BRS	`solana`	No Pods/customer markup — 1:1 BRLA inventory after decimal scale; optional Avenia Pix fee as `paymentRail`
Offramp	BRS → Pix BRL	`solana`	No Pods/customer markup — 1:1 BRLA inventory after decimal scale; optional Avenia Pix fee as `paymentRail`
Onramp	Pix BRL → BRZ	`polygon`	No Pods/customer markup — 1:1 BRLA inventory (both 18 decimals); optional Avenia Pix fee as `paymentRail`
Offramp	BRZ → Pix BRL	`polygon`	No Pods/customer markup — 1:1 BRLA inventory (both 18 decimals); optional Avenia Pix fee as `paymentRail`
Onramp / offramp	Pix BRL ↔ Morpho hyperUSDCa (Monad)	`monad`	Shown in `feeBreakdown` on the quote

Supported USD routes (foreign KYC)

Direction	Public pair	Chains	Fees
Onramp	USD WIRE/ACH → USDC	`ethereum`, `base`, `polygon`	Avenia mints USDC directly to the user wallet; no Pods/customer swap markup; ACH/WIRE In Fee is USD and appears as `paymentRail`
Offramp	USDC → USD WIRE/ACH	same EVM chains	Pass-through; bank fields on quote resolve-or-create the Avenia beneficiary. Out Fee is USDC (live ACH ~1.01 USDC, WIRE ~10.04 USDC) and appears as `kind: paymentRail` on `tokenIn`

See Foreign USD KYC and ramps for KYC, currency unlock, and quote patterns. Choose the pair with tokenOut / tokenIn (USDC, BRLA, BRS, or BRZ). Pods will not route a Pix→USDC or Pix→BRZ request to the BRLA mint-to-user rail, or the reverse.

Integrate with GET /v2/swap/quote only. Pass destinationAddress on onramps (Pix QR or ACH/WIRE deposit instructions in the response). On offramps pass originAddress plus pixKey (Pix) or the USD bank fields (ACH/WIRE) so transactionData is ready to sign. New integrations should not call POST /v2/swap/bytecode.The quote response top-level id is the Action id (use with GET /actions/{id}). Track money-movement progress with GET /v2/swap/status/{quoteId} using quote.quoteId — these are different identifiers.

Token addresses

Asset	Network	Address
USDC	Ethereum (`1`)	`0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48`
USDC	Base (`8453`)	`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`
USDC	Polygon (`137`)	`0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359`
USDC	Monad (`143`)	`0x754704Bc059F8C67012fEd69BC8A327a5aafb603`
BRLA	Polygon (`137`)	`0xE6A537a407488807F0bbeb0038B79004f19DDDFb`
BRS (Nora)	Solana (`0`)	`BRSxQRUaGswjLs7ewcH7uXj3r7SgmfKSSLLXyCKHZtUo`
BRZ (Transfero)	Polygon (`137`)	`0x4eD141110F6EeeAbA9A1df36d8c26f684d2475Dc`
hyperUSDCa (Morpho)	Monad (`143`)	`0x78999cc96d2Ba0341588C60CcB0E91c6C33CF371`

Onramp: USD ACH/WIRE to USDC

Use this when a foreign user (see Foreign USD KYC and ramps) pays USD via ACH or WIRE and receives USDC on ethereum, base, or polygon. The KYC profile for destinationAddress must have usdEnabled: true. With destinationAddress, the quote response includes bank deposit instructions — no EVM transaction to sign.

GET /v2/swap/quote

Pass exactly one of amountIn (USD cents to send) or amountOut (USDC raw to receive). Both are supported.

Query parameter	Required	Value
`originChain`	Yes	`fiat`
`destinationChain`	Yes	`ethereum`, `base`, or `polygon`
`tokenIn`	Yes	`USD`
`tokenOut`	Yes	USDC contract on the destination chain
`amountIn` or `amountOut`	Yes (exactly one)	`amountIn`: USD cents (`500` = USD 5.00). `amountOut`: USDC raw (`4000000` = 4 USDC).
`destinationAddress`	Yes	Wallet that receives USDC (unlocked USD KYC).
`usdPaymentMethod`	No	`WIRE` (default) or `ACH`

`amountIn` — exact USD send

curl -sS -G \
  -H "x-api-key: $PODS_API_KEY" \
  --data-urlencode "originChain=fiat" \
  --data-urlencode "destinationChain=polygon" \
  --data-urlencode "tokenIn=USD" \
  --data-urlencode "tokenOut=0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359" \
  --data-urlencode "amountIn=500" \
  --data-urlencode "destinationAddress=0xb0b6234dCbB885409eF23fD5FD5E63eE33b1377f" \
  --data-urlencode "usdPaymentMethod=ACH" \
  "$PODS_API_BASE_URL/v2/swap/quote"

Live capture: send USD 5.00 → receive ~3.983876 USDC (ACH fee ~USD 1.02 deducted from the input).

{
  "quote": {
    "quoteId": "06c35a13-aa53-4de0-ae5b-f81c13f10cc8",
    "originChain": "fiat",
    "destinationChain": "polygon",
    "tokenIn": { "symbol": "USD", "decimals": 2, "amount": "500", "amountInUSD": 5 },
    "tokenOut": {
      "contract": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
      "symbol": "USDC",
      "decimals": 6,
      "amount": "3983876",
      "expectedAmountOut": "3983876",
      "minAmountOut": "3983876"
    },
    "provider": "deframe",
    "feeBreakdown": {
      "charges": [
        {
          "kind": "paymentRail",
          "label": "ACH fee",
          "amountRaw": "102",
          "decimals": 2,
          "symbol": "USD",
          "asset": "tokenIn",
          "amountInUSD": 1.02
        }
      ]
    },
    "chainIdOut": 137
  },
  "paymentInstructions": {
    "method": "ACH",
    "amount": { "currency": "USD", "amountRaw": "500", "decimals": 2 },
    "usd": {
      "bankRoutingNumber": "101019644",
      "bankAccountNumber": "218939188578",
      "depositMessage": "BRGEGVRDDCX4JE6ZKEBK",
      "paymentRail": "ACH"
    }
  },
  "chainId": null,
  "transactionData": [],
  "id": "6a9215c94649656acd52ea13"
}

`amountOut` — exact USDC receive

curl -sS -G \
  -H "x-api-key: $PODS_API_KEY" \
  --data-urlencode "originChain=fiat" \
  --data-urlencode "destinationChain=polygon" \
  --data-urlencode "tokenIn=USD" \
  --data-urlencode "tokenOut=0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359" \
  --data-urlencode "amountOut=4000000" \
  --data-urlencode "destinationAddress=0xb0b6234dCbB885409eF23fD5FD5E63eE33b1377f" \
  --data-urlencode "usdPaymentMethod=ACH" \
  "$PODS_API_BASE_URL/v2/swap/quote"

Live capture: receive exactly 4 USDC → send USD 5.02 (paymentInstructions.amount.amountRaw=502). Same call with usdPaymentMethod=WIRE kept tokenOut.amount=4000000 and returned ~USD 14.04 to send (WIRE fee ~USD 10).

{
  "quote": {
    "quoteId": "afb84845-5347-4d26-9546-4b22eed465f1",
    "originChain": "fiat",
    "destinationChain": "polygon",
    "tokenIn": { "symbol": "USD", "decimals": 2, "amount": "502", "amountInUSD": 5.02 },
    "tokenOut": {
      "contract": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
      "symbol": "USDC",
      "decimals": 6,
      "amount": "4000000",
      "expectedAmountOut": "4000000",
      "minAmountOut": "4000000"
    },
    "provider": "deframe",
    "feeBreakdown": {
      "charges": [
        {
          "kind": "paymentRail",
          "label": "ACH fee",
          "amountRaw": "102",
          "decimals": 2,
          "symbol": "USD",
          "asset": "tokenIn",
          "amountInUSD": 1.02
        }
      ]
    },
    "chainIdOut": 137
  },
  "paymentInstructions": {
    "method": "ACH",
    "amount": { "currency": "USD", "amountRaw": "502", "decimals": 2 },
    "usd": {
      "bankRoutingNumber": "101019644",
      "bankAccountNumber": "218939188578",
      "depositMessage": "BRGZEPGAWBJTUEWYMBMG",
      "paymentRail": "ACH"
    }
  },
  "chainId": null,
  "transactionData": [],
  "id": "6a932e6e8e3c3ec415c10819"
}

Show paymentInstructions.usd to the user (routing, account, deposit message / memo, amount, expiry). ACH/WIRE rail fees appear as kind: paymentRail in feeBreakdown — there is no Pods/customer platform markup on this rail. Prefer amountOut when the product promise is “receive N USDC”. Poll GET /v2/swap/status/{quote.quoteId} until fulfilled. Full walkthrough: Foreign USD KYC and ramps.

Offramp: USDC to USD ACH/WIRE

Use this when a foreign user (see Foreign USD KYC and ramps) sends USDC on ethereum, base, or polygon and receives USD via ACH or WIRE. The KYC profile for originAddress must have usdEnabled: true. Pass originAddress plus the USD bank fields — Pods resolve-or-creates the Avenia beneficiary (account number + routing match reuses the existing id; otherwise it registers one). The id stays internal on rawQuote; do not send beneficiaryUsdBankAccountId. With those fields present, the quote response includes transactionData ready to sign.

GET /v2/swap/quote

Pass exactly one of amountIn (USDC raw to send) or amountOut (USD cents to receive). Both are supported — this is the onramp pair inverted.

Query parameter	Required	Value
`originChain`	Yes	`ethereum`, `base`, or `polygon`
`destinationChain`	Yes	`fiat`
`tokenIn`	Yes	USDC contract on the origin chain
`tokenOut`	Yes	`USD`
`amountIn` or `amountOut`	Yes (exactly one)	`amountIn`: USDC raw (`5000000` = 5 USDC). `amountOut`: USD cents (`400` = USD 4.00).
`originAddress`	Yes	Wallet that sends USDC (unlocked USD KYC).
`usdPaymentMethod`	No	`WIRE` (default) or `ACH`
`bankAccountNumber`	Yes	Destination account number
`bankRoutingNumber`	Yes	ABA routing
`bankBeneficiaryName`	Yes	Legal name on the account. ASCII only — Avenia rejects accents (`ã`, `é`, …) with `bankBeneficiaryName is invalid` → `QUOTE_GENERATION_FAILED`.
`bankName`	Yes	Bank name
`beneficiaryStreetLine1`	Yes	Address line 1
`beneficiaryCity` / `beneficiaryState` / `beneficiaryPostalCode` / `beneficiaryCountry`	Yes	Address (`beneficiaryCountry` e.g. `USA`)
`alias`	No	Defaults to `bankBeneficiaryName`
`beneficiaryStreetLine2` / `description`	No	Extra address line / Avenia note

Avenia prices the offramp rail as an Out Fee in USDC (live ACH ~1.0125 USDC, WIRE ~10.035 USDC). The fee is already in the spread between tokenIn.amount and tokenOut.amount, and also appears as kind: paymentRail on tokenIn (USDC). There is no Pods/customer swap markup.With amountIn, USD out is net of that USDC Out Fee. With amountOut, Pods asks Avenia once (outputAmount); tokenIn.amount is the USDC the wallet must transfer (fee included).WIRE Out Fee is ~~10 USDC — a 5 USDC amountIn covers ACH (~~$3.98 out) but not WIRE. Prefer amountOut (or a larger amountIn) for WIRE.

`amountIn` — exact USDC send

curl -sS -G \
  -H "x-api-key: $PODS_API_KEY" \
  --data-urlencode "originChain=polygon" \
  --data-urlencode "destinationChain=fiat" \
  --data-urlencode "tokenIn=0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359" \
  --data-urlencode "tokenOut=USD" \
  --data-urlencode "amountIn=5000000" \
  --data-urlencode "originAddress=0xb0b6234dCbB885409eF23fD5FD5E63eE33b1377f" \
  --data-urlencode "usdPaymentMethod=ACH" \
  --data-urlencode "bankAccountNumber=581984177591" \
  --data-urlencode "bankRoutingNumber=721738952" \
  --data-urlencode "bankBeneficiaryName=John Smith" \
  --data-urlencode "bankName=JPMorgan Chase Bank N.A." \
  --data-urlencode "beneficiaryStreetLine1=123 Main Street" \
  --data-urlencode "beneficiaryCity=New York" \
  --data-urlencode "beneficiaryState=NY" \
  --data-urlencode "beneficiaryPostalCode=10001" \
  --data-urlencode "beneficiaryCountry=USA" \
  "$PODS_API_BASE_URL/v2/swap/quote"

Live capture (2026-09-10, local API, Picnic usdEnabled wallet): send 5 USDC → receive USD 3.98 (tokenOut.amount=398). Avenia Out Fee ~1.0125 USDC. After the route fix, that fee is a paymentRail charge on tokenIn and tokenIn.chainId / top-level chainId are 137.

{
  "quote": {
    "quoteId": "7a6c2c6c-96b3-4fe0-866a-8ab32d076a22",
    "originChain": "polygon",
    "destinationChain": "fiat",
    "tokenIn": {
      "contract": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
      "symbol": "USDC",
      "decimals": 6,
      "amount": "5000000",
      "chainId": 137
    },
    "tokenOut": {
      "symbol": "USD",
      "decimals": 2,
      "amount": "398",
      "expectedAmountOut": "398",
      "minAmountOut": "398",
      "chainId": 0
    },
    "provider": "deframe",
    "feeBreakdown": {
      "charges": [
        {
          "kind": "paymentRail",
          "label": "ACH fee",
          "amountRaw": "1012500",
          "decimals": 6,
          "symbol": "USDC",
          "asset": "tokenIn"
        }
      ]
    }
  },
  "chainId": 137,
  "depositAddress": "0x…",
  "transactionData": [
    {
      "chainId": "137",
      "to": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
      "data": "0x...",
      "value": "0"
    },
    {
      "chainId": "137",
      "to": "0x...",
      "data": "0x...",
      "value": "0"
    }
  ]
}

`amountOut` — exact USD receive

curl -sS -G \
  -H "x-api-key: $PODS_API_KEY" \
  --data-urlencode "originChain=polygon" \
  --data-urlencode "destinationChain=fiat" \
  --data-urlencode "tokenIn=0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359" \
  --data-urlencode "tokenOut=USD" \
  --data-urlencode "amountOut=400" \
  --data-urlencode "originAddress=0xb0b6234dCbB885409eF23fD5FD5E63eE33b1377f" \
  --data-urlencode "usdPaymentMethod=ACH" \
  --data-urlencode "bankAccountNumber=581984177591" \
  --data-urlencode "bankRoutingNumber=721738952" \
  --data-urlencode "bankBeneficiaryName=John Smith" \
  --data-urlencode "bankName=JPMorgan Chase Bank N.A." \
  --data-urlencode "beneficiaryStreetLine1=123 Main Street" \
  --data-urlencode "beneficiaryCity=New York" \
  --data-urlencode "beneficiaryState=NY" \
  --data-urlencode "beneficiaryPostalCode=10001" \
  --data-urlencode "beneficiaryCountry=USA" \
  "$PODS_API_BASE_URL/v2/swap/quote"

Live capture: receive exactly USD 4.00 → send 5.012532 USDC (tokenIn.amount=5012532, quote 77fef6a2-358e-462a-8396-b9e2469f03d0). Same call with usdPaymentMethod=WIRE kept tokenOut.amount=400 and asked for 14.035088 USDC (d14a8e40-8689-4505-9f5e-7da67e329cc8, Out Fee ~10.035 USDC).

{
  "quote": {
    "quoteId": "77fef6a2-358e-462a-8396-b9e2469f03d0",
    "originChain": "polygon",
    "destinationChain": "fiat",
    "tokenIn": {
      "contract": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
      "symbol": "USDC",
      "decimals": 6,
      "amount": "5012532",
      "chainId": 137
    },
    "tokenOut": {
      "symbol": "USD",
      "decimals": 2,
      "amount": "400",
      "expectedAmountOut": "400",
      "minAmountOut": "400",
      "chainId": 0
    },
    "provider": "deframe",
    "feeBreakdown": {
      "charges": [
        {
          "kind": "paymentRail",
          "label": "ACH fee",
          "amountRaw": "1012532",
          "decimals": 6,
          "symbol": "USDC",
          "asset": "tokenIn"
        }
      ]
    }
  },
  "chainId": 137,
  "depositAddress": "0x…",
  "transactionData": [
    {
      "chainId": "137",
      "to": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
      "data": "0x...",
      "value": "0"
    },
    {
      "chainId": "137",
      "to": "0x...",
      "data": "0x...",
      "value": "0"
    }
  ],
  "id": "6aa322f8fd43d7a2324e0c48"
}

There is no paymentInstructions block on offramp — the user pays on-chain. Execute every transaction in transactionData, in order, from originAddress. Sign using each item’s chainId (polygon → 137, base → 8453, ethereum → 1; see Execute a swap). Top-level chainId and quote.tokenIn.chainId match the origin after the route bind fix. The first transaction transfers USDC to depositAddress; the next records the transfer for tracking. After Pods detects the USDC, Avenia pays ACH/WIRE to the resolved bank account. Prefer amountOut when the product promise is “receive $N”. Poll GET /v2/swap/status/{quote.quoteId} until fulfilled. KYC unlock and beneficiary field notes: Foreign USD KYC and ramps.

Onramp: Pix BRL to USDC

Use this when a verified user pays Pix and receives USDC on Base or Monad. When you include destinationAddress, the quote response includes payment instructions directly.

GET /v2/swap/quote

Example (Brazil, Pix BRL to USDC on Base):

curl -sS \
  -H "x-api-key: $PODS_API_KEY" \
  "$PODS_API_BASE_URL/v2/swap/quote?originChain=fiat&destinationChain=base&tokenIn=BRL&tokenOut=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&amountIn=1000&destinationAddress=0x0000000000000000000000000000000000000001"

For Monad, change destinationChain to monad and tokenOut to Monad USDC from the table above.

Query parameter	Required	Value
`originChain`	Yes	`fiat`
`destinationChain`	Yes	`base` or `monad`
`tokenIn`	Yes	`BRL`
`tokenOut`	Yes	USDC contract on the destination chain
`amountIn`	Yes	Fiat amount in the currency’s smallest unit. Example: `1000` is BRL 10.00.
`destinationAddress`	Yes	User wallet address that will receive USDC. Must match an `approved` Ramp KYC profile for that wallet.

Successful response:

{
  "quote": {
    "quoteId": "9be08433-3338-4881-9517-31faa22489c9",
    "originChain": "fiat",
    "destinationChain": "base",
    "tokenIn": {
      "symbol": "BRL",
      "decimals": 2,
      "amount": "1000"
    },
    "tokenOut": {
      "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "symbol": "USDC",
      "decimals": 6,
      "expectedAmountOut": "1769602",
      "chainId": 8453
    },
    "status": "pending",
    "deadlineDate": "2026-06-25T15:38:38.670Z",
    "feeBreakdown": {
      "charges": [
        {
          "kind": "paymentRail",
          "label": "Pix fee",
          "amountRaw": "77",
          "decimals": 2,
          "symbol": "BRL",
          "asset": "tokenIn"
        },
        {
          "kind": "bridgeAndSlippage",
          "label": "Bridge fee + slippage",
          "amountRaw": "8848",
          "decimals": 6,
          "symbol": "USDC",
          "asset": "tokenOut"
        }
      ]
    }
  },
  "paymentInstructions": {
    "method": "PIX",
    "amount": {
      "currency": "BRL",
      "amountRaw": "1000",
      "decimals": 2
    },
    "expiresAt": "2026-06-25T15:43:39.433Z",
    "pix": {
      "copyPaste": "000201010212..."
    }
  },
  "chainId": null,
  "transactionData": [],
  "id": "65f1a2b3c4d5e6f789012345"
}

Show paymentInstructions to the user in the shape of the local rail — for Pix, paymentInstructions.pix.copyPaste is the copy-paste code. Use quote.feeBreakdown to display payment-rail, Pods/customer, and bridge or slippage charges. There is no EVM transaction to sign on onramp (transactionData is empty; chainId is null). Poll GET /v2/swap/status/{quote.quoteId} until fulfilled.

Offramp: USDC to Pix BRL

Use this when a verified user sends USDC on-chain and receives Pix. The user must have an approved Ramp profile for the same originAddress, and that wallet must belong to your customer on Pods. Pass originAddress and pixKey on the quote — the response includes transactionData ready to sign. Sign on the selected origin chain (base → 8453, monad → 143).

GET /v2/swap/quote

Example (Brazil, USDC on Base to Pix BRL):

curl -sS \
  -H "x-api-key: $PODS_API_KEY" \
  "$PODS_API_BASE_URL/v2/swap/quote?originChain=base&destinationChain=fiat&tokenIn=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&tokenOut=BRL&amountIn=1000000&originAddress=0x0000000000000000000000000000000000000001&[email protected]"

Query parameter	Required	Value
`originChain`	Yes	`base` or `monad`
`destinationChain`	Yes	`fiat`
`tokenIn`	Yes	USDC contract on the origin chain
`tokenOut`	Yes	`BRL`
`amountIn`	Yes	USDC amount in smallest units. Example: `1000000` is 1.00 USDC.
`originAddress`	Yes	Approved wallet address that will send USDC.
`pixKey`	Yes	Pix key that will receive the BRL payout.

Successful response:

{
  "quote": {
    "quoteId": "1ed3ff63-58b8-4eb4-9152-723bbdfec724",
    "originChain": "base",
    "destinationChain": "fiat",
    "tokenIn": {
      "contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "symbol": "USDC",
      "decimals": 6,
      "amount": "1000000",
      "chainId": 8453
    },
    "tokenOut": {
      "contract": "BRL",
      "symbol": "BRL",
      "decimals": 2,
      "amount": "520",
      "expectedAmountOut": "520",
      "chainId": 0
    },
    "provider": "deframe",
    "status": "pending",
    "deadlineDate": "2026-06-29T22:21:12.230Z",
    "feeBreakdown": {
      "charges": [
        {
          "kind": "paymentRail",
          "label": "Pix fee",
          "amountRaw": "20",
          "decimals": 2,
          "symbol": "BRL",
          "asset": "tokenOut"
        }
      ]
    }
  },
  "chainId": 8453,
  "depositAddress": "0x4444444444444444444444444444444444444444",
  "transactionData": [
    {
      "chainId": "8453",
      "to": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "data": "0x...",
      "value": "0"
    },
    {
      "chainId": "8453",
      "to": "0x...",
      "data": "0x...",
      "value": "0"
    }
  ],
  "id": "65f1a2b3c4d5e6f789012345"
}

Execute every transaction in transactionData, in order, from originAddress on the selected origin chain (batch same-chain legs into one atomic tx when your wallet stack supports it — see Execute a swap). The first transaction transfers USDC to the returned depositAddress; the next transaction records the transfer for tracking. After Pods detects and collects the USDC payment, Pods creates the local-rail payout to pixKey. Track with GET /v2/swap/status/{quote.quoteId}.

Onramp: Pix BRL to BRLA (Polygon)

Use this when a verified user pays Pix and receives BRLA on Polygon directly in their wallet. Avenia mints BRLA to destinationAddress — there is no Deframe inventory hop and no Pods/customer swap markup. Quote amounts mirror Avenia’s fixed-rate response (Avenia rail fees may still appear as paymentRail in feeBreakdown).

Prefer this rail when the product needs BRLA itself. Prefer Pix→USDC when the product needs USDC on Base or Monad. Do not call Avenia’s APIs directly for either public pair — use GET /v2/swap/quote.

GET /v2/swap/quote

Example (Brazil, Pix BRL to BRLA on Polygon):

curl -sS \
  -H "x-api-key: $PODS_API_KEY" \
  "$PODS_API_BASE_URL/v2/swap/quote?originChain=fiat&destinationChain=polygon&tokenIn=BRL&tokenOut=0xE6A537a407488807F0bbeb0038B79004f19DDDFb&amountIn=10000&destinationAddress=0x0000000000000000000000000000000000000001"

Query parameter	Required	Value
`originChain`	Yes	`fiat`
`destinationChain`	Yes	`polygon` (v1)
`tokenIn`	Yes	`BRL`
`tokenOut`	Yes	Polygon BRLA: `0xE6A537a407488807F0bbeb0038B79004f19DDDFb`
`amountIn`	Yes	Fiat amount in smallest units. Example: `10000` is BRL 100.00.
`destinationAddress`	Yes	User wallet that will receive BRLA on Polygon. Must match an `approved` Ramp KYC profile for that wallet.

Successful response shape matches other onramps: paymentInstructions.pix.copyPaste for the user to pay, quote.tokenOut with BRLA (decimals 18, chainId 137), feeBreakdown without Pods/customer platform charges, empty transactionData, and chainId: null. After Pix settles, Avenia mints BRLA to destinationAddress. Track with GET /v2/swap/status/{quote.quoteId}.

Offramp: BRLA (Polygon) to Pix BRL

Use this when a verified user sends BRLA on Polygon and receives Pix. Amounts pass through Avenia with no Pods/customer markup. Pass originAddress and pixKey on the quote; the response includes transactionData (BRLA transfer + track) for Polygon (chainId 137).

GET /v2/swap/quote

Example:

curl -sS \
  -H "x-api-key: $PODS_API_KEY" \
  "$PODS_API_BASE_URL/v2/swap/quote?originChain=polygon&destinationChain=fiat&tokenIn=0xE6A537a407488807F0bbeb0038B79004f19DDDFb&tokenOut=BRL&amountIn=98500000000000000000&originAddress=0x0000000000000000000000000000000000000001&[email protected]"

Query parameter	Required	Value
`originChain`	Yes	`polygon` (v1)
`destinationChain`	Yes	`fiat`
`tokenIn`	Yes	Polygon BRLA: `0xE6A537a407488807F0bbeb0038B79004f19DDDFb`
`tokenOut`	Yes	`BRL`
`amountIn`	Yes	BRLA amount in smallest units (18 decimals).
`originAddress`	Yes	Approved wallet that will send BRLA on Polygon.
`pixKey`	Yes	Pix key that will receive the BRL payout.

Execute transactionData from originAddress on Polygon (chainId 137). After Pods validates the transfer, Avenia pays Pix to pixKey. Track with GET /v2/swap/status/{quote.quoteId}.

Onramp: Pix BRL to BRS (Solana)

Use this when a verified user pays Pix and receives BRS on Solana. Pricing is 1:1 after decimal scale (BRLA 18 decimals ↔ BRS 6 decimals). There is no Pods/customer swap markup. The user never holds or sends BRLA — Pods settles that inventory internally. The Ramp KYC walletAddress for this pair must be the user’s Solana public key, and destinationAddress must match it.

GET /v2/swap/quote

Example:

curl -sS \
  -H "x-api-key: $PODS_API_KEY" \
  "$PODS_API_BASE_URL/v2/swap/quote?originChain=fiat&destinationChain=solana&tokenIn=BRL&tokenOut=BRSxQRUaGswjLs7ewcH7uXj3r7SgmfKSSLLXyCKHZtUo&amountIn=10000&destinationAddress=EXYhCNamLPFfSMekSn7Lzc2cP32aZpRa7ok5gErdJzcj"

Query parameter	Required	Value
`originChain`	Yes	`fiat`
`destinationChain`	Yes	`solana`
`tokenIn`	Yes	`BRL`
`tokenOut`	Yes	Solana BRS mint: `BRSxQRUaGswjLs7ewcH7uXj3r7SgmfKSSLLXyCKHZtUo`
`amountIn`	Yes	Fiat amount in smallest units. Example: `10000` is BRL 100.00.
`destinationAddress`	Yes	User Solana wallet that will receive BRS. Must match an `approved` Ramp KYC profile for that wallet.

Successful response shape matches other Pix onramps: paymentInstructions.pix.copyPaste for the user to pay, quote.tokenOut with BRS (decimals 6, chainId 0), feeBreakdown without Pods/customer platform charges, empty transactionData, and chainId: null. After Pix settles, Pods sends BRS to destinationAddress. Track with GET /v2/swap/status/{quote.quoteId}.

Offramp: BRS (Solana) to Pix BRL

Use this when a verified user sends BRS on Solana and receives Pix. Amounts pass through 1:1 inventory with no Pods/customer markup. Pass originAddress (the approved Solana wallet) and pixKey on the quote. The origin payload is Solana, not an EVM transaction array. Default output=bytecode returns type: intra-chain-solana with transactionData.rawTransaction (base64). That transaction transfers BRS to the Pods inventory ATA and includes Memo V1 { version: 1, actionId } where actionId is the quote UUID (quote.quoteId), not the Action ObjectId. Sign and submit that transaction from originAddress. Solana wallets that assemble instructions themselves can request output=instructions (Solana-origin only). EVM and fiat origins reject instructions with OUTPUT_NOT_SUPPORTED.

GET /v2/swap/quote

Example:

curl -sS \
  -H "x-api-key: $PODS_API_KEY" \
  "$PODS_API_BASE_URL/v2/swap/quote?originChain=solana&destinationChain=fiat&tokenIn=BRSxQRUaGswjLs7ewcH7uXj3r7SgmfKSSLLXyCKHZtUo&tokenOut=BRL&amountIn=98500000&originAddress=EXYhCNamLPFfSMekSn7Lzc2cP32aZpRa7ok5gErdJzcj&[email protected]"

Query parameter	Required	Value
`originChain`	Yes	`solana`
`destinationChain`	Yes	`fiat`
`tokenIn`	Yes	Solana BRS mint: `BRSxQRUaGswjLs7ewcH7uXj3r7SgmfKSSLLXyCKHZtUo`
`tokenOut`	Yes	`BRL`
`amountIn`	Yes	BRS amount in smallest units (6 decimals). Example: `98500000` is 98.50 BRS.
`originAddress`	Yes	Approved Solana wallet that will send BRS.
`pixKey`	Yes	Pix key that will receive the BRL payout.
`output`	No	`bytecode` (default, base64 `rawTransaction`) or `instructions` (Solana-origin only).

Sign transactionData.rawTransaction from originAddress on Solana. After Pods confirms the inbound BRS transfer (Memo V1 quoteId), Avenia pays Pix to pixKey. Track with GET /v2/swap/status/{quote.quoteId}.

Onramp: Pix BRL to BRZ (Polygon)

Use this when a verified user pays Pix and receives BRZ on Polygon. Pricing is 1:1 (BRLA 18 decimals ↔ BRZ 18 decimals). There is no Pods/customer swap markup. The user never holds or sends BRLA — Pods settles that inventory internally. The Ramp KYC walletAddress for this pair must be the user’s Polygon address, and destinationAddress must match it.

GET /v2/swap/quote

Example:

curl -sS \
  -H "x-api-key: $PODS_API_KEY" \
  "$PODS_API_BASE_URL/v2/swap/quote?originChain=fiat&destinationChain=polygon&tokenIn=BRL&tokenOut=0x4eD141110F6EeeAbA9A1df36d8c26f684d2475Dc&amountIn=10000&destinationAddress=0x0000000000000000000000000000000000000001"

Query parameter	Required	Value
`originChain`	Yes	`fiat`
`destinationChain`	Yes	`polygon`
`tokenIn`	Yes	`BRL`
`tokenOut`	Yes	Polygon BRZ: `0x4eD141110F6EeeAbA9A1df36d8c26f684d2475Dc`
`amountIn`	Yes	Fiat amount in smallest units. Example: `10000` is BRL 100.00.
`destinationAddress`	Yes	User Polygon wallet that will receive BRZ. Must match an `approved` Ramp KYC profile for that wallet.

Successful response shape matches other Pix onramps: paymentInstructions.pix.copyPaste for the user to pay, quote.tokenOut with BRZ (decimals 18, chainId 137), feeBreakdown without Pods/customer platform charges, empty transactionData, and chainId: null. After Pix settles, Pods sends BRZ to destinationAddress. Track with GET /v2/swap/status/{quote.quoteId}.

Offramp: BRZ (Polygon) to Pix BRL

Use this when a verified user sends BRZ on Polygon and receives Pix. Amounts pass through 1:1 inventory with no Pods/customer markup. Pass originAddress (the approved Polygon wallet) and pixKey on the quote. BRZ has no EIP-2612 permit. The origin payload is an EVM transaction array: an ERC-20 transfer of BRZ to the Pods bridge address plus a Deframe Track event whose extra data is version 0, action 2, and quote.quoteId. A transfer to the bridge without that matching Track does not confirm the quote.

GET /v2/swap/quote

Example:

curl -sS \
  -H "x-api-key: $PODS_API_KEY" \
  "$PODS_API_BASE_URL/v2/swap/quote?originChain=polygon&destinationChain=fiat&tokenIn=0x4eD141110F6EeeAbA9A1df36d8c26f684d2475Dc&tokenOut=BRL&amountIn=98500000000000000000&originAddress=0x0000000000000000000000000000000000000001&[email protected]"

Query parameter	Required	Value
`originChain`	Yes	`polygon`
`destinationChain`	Yes	`fiat`
`tokenIn`	Yes	Polygon BRZ: `0x4eD141110F6EeeAbA9A1df36d8c26f684d2475Dc`
`tokenOut`	Yes	`BRL`
`amountIn`	Yes	BRZ amount in smallest units (18 decimals). Example: `98500000000000000000` is 98.50 BRZ.
`originAddress`	Yes	Approved Polygon wallet that will send BRZ.
`pixKey`	Yes	Pix key that will receive the BRL payout.

Execute transactionData from originAddress on Polygon (chainId 137). After Pods confirms the inbound BRZ transfer plus matching Track, Avenia pays Pix to pixKey. Track with GET /v2/swap/status/{quote.quoteId}.

Onramp to yield: Pix BRL to Morpho hyperUSDCa (Monad)

Deposit Pix BRL directly into Morpho Hyperithm USDC Apex on Monad. The flow matches the plain USDC onramp — only tokenOut is the vault share token (hyperUSDCa) instead of USDC.

GET /v2/swap/quote

Example:

curl -sS \
  -H "x-api-key: $PODS_API_KEY" \
  "$PODS_API_BASE_URL/v2/swap/quote?originChain=fiat&destinationChain=monad&tokenIn=BRL&tokenOut=0x78999cc96d2Ba0341588C60CcB0E91c6C33CF371&amountIn=1000&destinationAddress=0x0000000000000000000000000000000000000001"

Query parameter	Required	Value
`originChain`	Yes	`fiat`
`destinationChain`	Yes	`monad`
`tokenIn`	Yes	`BRL`
`tokenOut`	Yes	Morpho hyperUSDCa on Monad: `0x78999cc96d2Ba0341588C60CcB0E91c6C33CF371`
`amountIn`	Yes	Fiat amount in the currency’s smallest unit.
`destinationAddress`	Yes	User wallet that will receive hyperUSDCa shares.

Successful response:

{
  "quote": {
    "quoteId": "9be08433-3338-4881-9517-31faa22489c9",
    "originChain": "fiat",
    "destinationChain": "monad",
    "tokenIn": {
      "symbol": "BRL",
      "decimals": 2,
      "amount": "1000"
    },
    "tokenOut": {
      "contract": "0x78999cc96d2Ba0341588C60CcB0E91c6C33CF371",
      "symbol": "hyperUSDCa",
      "decimals": 18,
      "expectedAmountOut": "...",
      "chainId": 143
    },
    "status": "pending",
    "deadlineDate": "2026-06-25T15:38:38.670Z",
    "feeBreakdown": {
      "charges": []
    }
  },
  "paymentInstructions": {
    "method": "PIX",
    "amount": {
      "currency": "BRL",
      "amountRaw": "1000",
      "decimals": 2
    },
    "expiresAt": "2026-06-25T15:43:39.433Z",
    "pix": {
      "copyPaste": "000201010212..."
    }
  },
  "id": "9be08433-3338-4881-9517-31faa22489c9"
}

quote.tokenOut.decimals is the vault share decimals (18). expectedAmountOut is a raw share amount of hyperUSDCa, not USDC. Store it so you can redeem the exact deposited shares later on the offramp. There is no on-chain transaction for the user to sign on this side. After Pix settles, Pods converts to USDC on Monad, mints hyperUSDCa, and sends the shares to destinationAddress.

Offramp from yield: Morpho hyperUSDCa (Monad) to Pix BRL

Redeem Morpho hyperUSDCa shares and receive Pix. amountIn must be a raw share amount of hyperUSDCa — not a USDC amount and not a principal / currentPosition value from the wallet endpoint (see Check yield position and profit below).

Do not pass a USDC- or BRL-denominated position value as amountIn. Use the wallet’s on-chain hyperUSDCa share balance, or the share amount stored from the onramp quote above.

GET /v2/swap/quote

Example:

curl -sS \
  -H "x-api-key: $PODS_API_KEY" \
  "$PODS_API_BASE_URL/v2/swap/quote?originChain=monad&destinationChain=fiat&tokenIn=0x78999cc96d2Ba0341588C60CcB0E91c6C33CF371&tokenOut=BRL&amountIn=1000000000000000000&originAddress=0x0000000000000000000000000000000000000001&[email protected]"

Query parameter	Required	Value
`originChain`	Yes	`monad`
`destinationChain`	Yes	`fiat`
`tokenIn`	Yes	Morpho hyperUSDCa on Monad: `0x78999cc96d2Ba0341588C60CcB0E91c6C33CF371`
`tokenOut`	Yes	`BRL`
`amountIn`	Yes	Raw hyperUSDCa share amount to redeem.
`originAddress`	Yes	Approved wallet that holds the hyperUSDCa position.
`pixKey`	Yes	Pix key that will receive the BRL payout.

Successful response includes quote plus transactionData / chainId / id (same shape as the USDC offramp). Execute every transaction in transactionData, in order, from originAddress on Monad (chainId 143). The first transaction redeems hyperUSDCa to USDC and sends USDC to depositAddress; the next records the transfer for tracking. Pods validates the redeem before creating the Pix payout to pixKey.

Check yield position and profit

For Morpho hyperUSDCa positions, use GET /v2/wallets/{wallet} and find the entry where strategy matches Morpho Hyperithm on Monad. spotPosition.currentPosition, principal, profit, and cumulativeProfit are reported in USDC terms, even though the wallet holds hyperUSDCa shares on-chain. Do not use those values as amountIn for a yield-to-Pix quote — use the on-chain share balance or the share amount stored from the onramp quote. If the user wants to exit into USDC on Monad without Pix, use that strategy’s withdraw bytecode endpoint (underlying-token amount) — see the yield strategy guides.

Offramp to a third party

Use this when a verified user wants to convert USDC (base or monad) into a fiat payment sent to someone else, instead of paying themselves back. This is the same offramp flow as above, with two differences: set thirdParty=true on the quote, and pass the recipient’s pixKey (normal offramp assumes the Pix key belongs to the same person as originAddress; third-party offramp does not).

GET /v2/swap/quote

Example:

curl -sS \
  -H "x-api-key: $PODS_API_KEY" \
  "$PODS_API_BASE_URL/v2/swap/quote?originChain=base&destinationChain=fiat&tokenIn=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913&tokenOut=BRL&amountIn=1000000&originAddress=0x0000000000000000000000000000000000000001&[email protected]&thirdParty=true"

Query parameter	Required	Value
`originChain`	Yes	`base` or `monad`
`destinationChain`	Yes	`fiat`
`tokenIn`	Yes	USDC contract on the origin chain
`tokenOut`	Yes	Local fiat currency, e.g. `BRL`
`amountIn`	Yes	USDC amount in smallest units.
`originAddress`	Yes	Approved wallet address that will send USDC on the selected origin chain.
`pixKey`	Yes	Pix key of the recipient receiving the payment — not the origin wallet owner’s own key.
`thirdParty`	Yes	`true`. Marks this offramp as paying a key that does not belong to `originAddress`’s own Ramp profile.

The response includes transactionData like a normal offramp. Execute and track status the same way; only the recipient of the resulting payout differs. Reference:

Overview

Guides

Integrations

Agents

Move Money with Pods Ramp

Supported Brazil Pix routes

Supported USD routes (foreign KYC)

Token addresses

Onramp: USD ACH/WIRE to USDC

`amountIn` — exact USD send

`amountOut` — exact USDC receive

Offramp: USDC to USD ACH/WIRE

`amountIn` — exact USDC send

`amountOut` — exact USD receive

Onramp: Pix BRL to USDC

Offramp: USDC to Pix BRL

Onramp: Pix BRL to BRLA (Polygon)

Offramp: BRLA (Polygon) to Pix BRL

Onramp: Pix BRL to BRS (Solana)

Offramp: BRS (Solana) to Pix BRL

Onramp: Pix BRL to BRZ (Polygon)

Offramp: BRZ (Polygon) to Pix BRL

Onramp to yield: Pix BRL to Morpho hyperUSDCa (Monad)

Offramp from yield: Morpho hyperUSDCa (Monad) to Pix BRL

Check yield position and profit

Offramp to a third party

​Supported Brazil Pix routes

​Supported USD routes (foreign KYC)

​Token addresses

​Onramp: USD ACH/WIRE to USDC

​amountIn — exact USD send

​amountOut — exact USDC receive

​Offramp: USDC to USD ACH/WIRE

​amountIn — exact USDC send

​amountOut — exact USD receive

​Onramp: Pix BRL to USDC

​Offramp: USDC to Pix BRL

​Onramp: Pix BRL to BRLA (Polygon)

​Offramp: BRLA (Polygon) to Pix BRL

​Onramp: Pix BRL to BRS (Solana)

​Offramp: BRS (Solana) to Pix BRL

​Onramp: Pix BRL to BRZ (Polygon)

​Offramp: BRZ (Polygon) to Pix BRL

​Onramp to yield: Pix BRL to Morpho hyperUSDCa (Monad)

​Offramp from yield: Morpho hyperUSDCa (Monad) to Pix BRL

​Check yield position and profit

​Offramp to a third party

Supported Brazil Pix routes

Supported USD routes (foreign KYC)

Token addresses

Onramp: USD ACH/WIRE to USDC

`amountIn` — exact USD send

`amountOut` — exact USDC receive

Offramp: USDC to USD ACH/WIRE

`amountIn` — exact USDC send

`amountOut` — exact USD receive

Onramp: Pix BRL to USDC

Offramp: USDC to Pix BRL

Onramp: Pix BRL to BRLA (Polygon)

Offramp: BRLA (Polygon) to Pix BRL

Onramp: Pix BRL to BRS (Solana)

Offramp: BRS (Solana) to Pix BRL

Onramp: Pix BRL to BRZ (Polygon)

Offramp: BRZ (Polygon) to Pix BRL

Onramp to yield: Pix BRL to Morpho hyperUSDCa (Monad)

Offramp from yield: Morpho hyperUSDCa (Monad) to Pix BRL

Check yield position and profit

Offramp to a third party