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. The examples below use Brazil’s Pix rail, the only rail 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 / offramp	Pix BRL ↔ Morpho hyperUSDCa (Monad)	`monad`	Shown in `feeBreakdown` on the quote

Choose the pair with tokenOut / tokenIn (USDC contract vs BRLA contract). Pods will not route a Pix→USDC request to the BRLA rail, or the reverse.

Integrate with GET /v2/swap/quote only. Pass destinationAddress on onramps (Pix QR in the response) or originAddress + pixKey on offramps (transactionData 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	Base (`8453`)	`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`
USDC	Monad (`143`)	`0x754704Bc059F8C67012fEd69BC8A327a5aafb603`
BRLA	Polygon (`137`)	`0xE6A537a407488807F0bbeb0038B79004f19DDDFb`
BRS (Nora)	Solana (`0`)	`BRSxQRUaGswjLs7ewcH7uXj3r7SgmfKSSLLXyCKHZtUo`
hyperUSDCa (Morpho)	Monad (`143`)	`0x78999cc96d2Ba0341588C60CcB0E91c6C33CF371`

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 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

Token addresses

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 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

​Token addresses

​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 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

Token addresses

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 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