Deposit to Yield

In this section, you’ll learn how to request ready-to-use transaction data (bytecode) for depositing into a yield position.

Prerequisites:

How to get available protocols

Request Transaction Data

Fetch ready-to-use transaction data using:

GET /strategies/:id/bytecode

Required Parameters:

Parameter	Description	Example
action	Type of operation	`lend` or `request-lend`
amount	Amount in token’s smallest unit	`10000000`
wallet	Wallet that will own the position	`0xUserWalletAddress`

The request-lend action is only for Ondo Global Markets strategies (tokenized stocks & ETFs), whose orders settle asynchronously. For every other yield strategy, use lend.

slippage is not accepted on these yield strategies. Passing it returns 400 SLIPPAGE_NOT_SUPPORTED. Only Ondo stock strategies on BSC and Ethereum accept it — see Order slippage.

Preview quotes without a connected wallet. wallet also accepts the zero address (0x000…0) or a well-known burn address (e.g. 0x000…dEaD, 0x111…, 0x222…). The response is priced exactly like a real request but includes previewOnly: true and omits id, bytecode, userOperation, singleUseAddress, and orderUid — no Action is created, and the address is never persisted or synced to Moralis/Helius.

A previewOnly response has no bytecode to sign. Use the user’s real, owned wallet address for any request you intend to execute.

Pick the section that matches how the user is funding the deposit. Each shows the extra parameters, an example request, and the response you get back.

Simple deposit

Deposit the strategy’s underlying token directly on the strategy’s chain — no swap or bridge. Only the required parameters above are needed, and crossChain.isCrossChain stays false. Example Request:

GET /strategies/aave-usdc-polygon/bytecode?action=lend&amount=10000000&wallet=0xUserWalletAddress

Example Response:

{
  "feeCharged": "0",
  "chainIdIn": 137,
  "chainIdOut": 137,
  "id": "65f3a1c8e9b2d4f8a7c1d2e3",
  "crossChain": {
    "isCrossChain": false,
    "chainIdIn": 137,
    "chainIdOut": 137
  },
  "quote": null,
  "bytecode": [
    {
      "to": "0x794a61358D6845594F94dc1DB02A252b5b4814aD",
      "value": "0",
      "data": "0xe8eda9df...",
      "chainId": "137"
    }
  ]
}

Same-chain swap deposit

When strategy routing is enabled, supported Aave and Morpho investments accept same-chain swaps and cross-chain bridge/swaps through this endpoint. Select the investment using its strategy ID and pass the source token, source chain and amount in that source token’s smallest unit. Use settlementMode=direct (the default for composed routes) to receive the initial wallet transaction. Use settlementMode=depositAddress to receive an address and funding instructions instead. After the source transaction is confirmed, the service completes the strategy deposit and delivers the receipt asset to destinationAddress ?? wallet. Track the returned Action ID; the customer does not submit a second transaction for the strategy deposit. Route availability depends on the selected provider, source asset, chain and strategy. A provider that cannot deliver verified proceeds to the settlement address is not eligible. The accepted final minimum is retained if the quote expires or market conditions change. Entry fees apply once to the actual strategy input; these investment routes do not add a platform swap fee. Exact-underlying Aave depositAddress requests continue using their existing funding-instruction response. Ordinary wallet deposits and integrations without strategy routing retain the behavior described below. Hold a different token on the strategy’s chain? Pass fromTokenAddress (with a fromChainId/chainIdIn matching the strategy chain) to swap into the underlying asset before depositing. The response prepends the swap transaction(s) before the deposit bytecode, and crossChain.isCrossChain stays false. Additional Parameters:

Parameter	Description	Example
fromChainId or chainIdIn	Source chain ID. Use the strategy chain for same-chain swaps. Required when `fromTokenAddress` is provided.	`137` (Polygon)
fromTokenAddress	Token address to swap from before depositing (same-chain). When provided, the response includes swap transaction(s) before the deposit bytecode.	`0x7ceB2...f619` (WETH)

When fromTokenAddress is provided with a fromChainId matching the strategy chain, the API automatically prepends a same-chain swap from fromTokenAddress to the strategy’s underlying asset. The amount parameter refers to the amount of fromTokenAddress to swap, and crossChain.isCrossChain remains false.

Example Request: If you hold WETH but want to deposit into a USDC strategy, pass fromTokenAddress to swap first:

GET /strategies/aave-usdc-polygon/bytecode?action=lend&amount=1000000000000000000&wallet=0xUserWalletAddress&fromChainId=137&fromTokenAddress=0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619

Example Response:

{
  "feeCharged": "0",
  "chainIdIn": 137,
  "chainIdOut": 137,
  "id": "65f3a1c8e9b2d4f8a7c1d2e3",
  "crossChain": {
    "isCrossChain": false,
    "chainIdIn": 137,
    "chainIdOut": 137
  },
  "quote": null,
  "bytecode": [
    {
      "to": "0xDEF171Fe48CF0115B1d80b88dc8eAB59176FEe57",
      "value": "0",
      "data": "0x54e3f31b...",
      "chainId": "137"
    },
    {
      "to": "0x794a61358D6845594F94dc1DB02A252b5b4814aD",
      "value": "0",
      "data": "0xe8eda9df...",
      "chainId": "137"
    }
  ]
}

Cross-chain swap deposit

Funding from another chain? Pass a fromChainId/chainIdIn that differs from the strategy’s chain. The response adds a quote object describing the bridge selection, the resolved tokens, and the expected/minimum output amount, and sets crossChain.isCrossChain to true. Additional Parameters:

Parameter	Description	Example
fromChainId or chainIdIn	Source chain ID for the funds being bridged before deposit	`8453` (Base)
fromTokenAddress	Source token address. Required when `fromChainId` or `chainIdIn` is provided. Must be a valid ERC-20 token on the source chain; returns `FROM_TOKEN_NOT_SUPPORTED` (400) if the address is not a valid ERC-20 contract on the specified chain.	`0x833589...2913` (USDC on Base)

Example Request: To bridge USDC on Base into a USDC yield strategy on Arbitrum, pass the Base fromChainId and fromTokenAddress:

GET /strategies/KPK-podsUSDCy-arbitrum/bytecode?action=lend&amount=1000000&wallet=0xUserWalletAddress&fromChainId=8453&fromTokenAddress=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Example Response:

{
  "feeCharged": "0",
  "chainIdIn": 8453,
  "chainIdOut": 42161,
  "id": "6a04f2f75bf7233c6220b3ca",
  "crossChain": {
    "isCrossChain": true,
    "chainIdIn": 8453,
    "chainIdOut": 42161
  },
  "quote": {
    "bridge": "CCTP",
    "sender": "0x49A54d4d925868475Eb8d2cb2c784481ca755e8A",
    "fromChainId": 8453,
    "fromTokenAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "toChainId": 42161,
    "toTokenAddress": "0x4F38e7a76b9C32Ab68FBf500E4d52806B15AB93b",
    "inputAmount": {
      "value": "1000000",
      "decimals": 6,
      "humanized": "1.0",
      "symbol": "USDC"
    },
    "outputAmount": {
      "value": "999870",
      "decimals": 18,
      "humanized": "0.00000000000099987",
      "symbol": "KPK-podsUSDCy"
    },
    "minimumOutputAmount": {
      "value": "999870",
      "decimals": 18,
      "humanized": "0.00000000000099987",
      "symbol": "KPK-podsUSDCy"
    },
    "chainIdIn": 8453,
    "chainIdOut": 42161
  },
  "bytecode": [
    {
      "to": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "value": "0",
      "data": "0x095ea7b3...",
      "chainId": "8453"
    },
    {
      "to": "0x28b5a0e9C621a5BadaA536219b3a228C8168cf5d",
      "value": "0",
      "data": "0x8e0250ee...",
      "chainId": "8453"
    }
  ]
}

The top-level id is used for execution tracking — store it and pass it to GET /actions/:id to track the cross-chain deposit through completion (see Checking Cross-Chain Deposit Status below).The quote object describes which bridge was selected (bridge), the expected outputAmount, and the worst-case minimumOutputAmount (slippage floor). Display these to the user before they sign.

Output format options

By default the endpoint returns raw bytecode. These optional parameters change the response format and apply to any of the deposit types above.

Parameter	Description	Example
output	Response format: `bytecode` (default), `userOperation`, `fireblocks`, or `instructions` (Solana)	`fireblocks`
accountId	Fireblocks vault account ID. Required when `output=fireblocks`	`12`
webhookURL	Optional per-action webhook endpoint (URI). When set, action update webhooks for this deposit go to this URL instead of the customer default.	`https://example.com/webhooks/strategy-action`

Example Request (Fireblocks output): If you are using Fireblocks custody, set output=fireblocks and pass your vault accountId. The wallet parameter must be a smart wallet previously provisioned via POST /fireblocks-smart-account (see Fireblocks Integration).

GET /strategies/aave-usdc-polygon/bytecode?action=lend&amount=10000000&wallet=0xSafeAddress&output=fireblocks&accountId=YOUR_VAULT_ACCOUNT_ID

Example Response:

{
  "feeCharged": "0",
  "chainIdIn": 137,
  "chainIdOut": 137,
  "id": "65f3a1c8e9b2d4f8a7c1d2e3",
  "crossChain": {
    "isCrossChain": false,
    "chainIdIn": 137,
    "chainIdOut": 137
  },
  "quote": null,
  "transactionData": {
    "transactionRequest": {
      "operation": "CONTRACT_CALL",
      "assetId": "MATIC_POLYGON",
      "source": {
        "type": "VAULT_ACCOUNT",
        "id": "YOUR_VAULT_ACCOUNT_ID"
      },
      "destination": {
        "type": "ONE_TIME_ADDRESS",
        "oneTimeAddress": {
          "address": "0xSafeAddress"
        }
      },
      "amount": "0",
      "extraParameters": {
        "contractCallData": "0x6a761202..."
      },
      "note": "lend aave-usdc-polygon",
      "failOnLowFee": true
    }
  }
}

The transactionData.transactionRequest payload can be submitted directly to the Fireblocks Transactions API (POST /v1/transactions) — no further encoding required. The Earn Owner vault must be configured as the signer (see Fireblocks Integration).

Use GET /strategies to list available protocols, then pass the chosen strategy ID into the bytecode endpoint above.

Executing the Transaction

Batch all bytecode legs on the same chainId into one atomic transaction. Do not loop sendTransaction per leg. See Executing Bytecode.

Wallet stack	Approach
EOA	EIP-7702 `executeBatch`
Smart account	`output=userOperation` → Smart Account Deposit
Fireblocks	`output=fireblocks` → Fireblocks Integration

// EOA — batch result.bytecode into ONE tx (see strategy-deposit-eip7702.js)
const { data: result } = await pods.get('/strategies/aave-usdc-polygon/bytecode', {
  params: { action: 'lend', amount: '10000000', wallet: walletAddress }
})

// Do not: for (const tx of result.bytecode) { await signer.sendTransaction(...) }
console.log('Legs to batch atomically:', result.bytecode.length)

Checking Cross-Chain Deposit Status

Cross-chain deposits are asynchronous: the source-chain bridge transaction is signed first, then the bridged funds are delivered and deposited on the destination chain. To track progress to completion, use the id returned in the bytecode response:

GET /actions/:id

Path Parameters:

Parameter	Description	Example
id	The `id` returned by `GET /strategies/:id/bytecode`	`6a04f2f75bf7233c6220b3ca`

Example Request:

GET /actions/6a04f2f75bf7233c6220b3ca

Example Response (deposit in flight):

{
  "id": "6a04f2f75bf7233c6220b3ca",
  "type": "CROSSCHAIN_INVESTMENT_DEPOSIT",
  "status": "PENDING",
  "strategyId": "65a1b2c3d4e5f6a7b8c9d0e1",
  "strategySlug": "aave-usdc-polygon",
  "initialDate": "2026-05-19T14:30:15Z",
  "createdAt": "2026-05-19T14:30:00Z",
  "originAddress": "0x49A54d4d925868475Eb8d2cb2c784481ca755e8A",
  "receiverAddress": "0x49A54d4d925868475Eb8d2cb2c784481ca755e8A",
  "amounts": {
    "assetIn": {
      "token": {
        "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "symbol": "USDC",
        "decimals": 6
      },
      "chain": { "id": 8453, "name": "base" },
      "amountRaw": "1000000",
      "amountHumanized": "1.0",
      "amountInUSD": "1.00"
    },
    "assetOut": {
      "token": {
        "address": "0x4F38e7a76b9C32Ab68FBf500E4d52806B15AB93b",
        "symbol": "KPK-podsUSDCy",
        "decimals": 18
      },
      "chain": { "id": 42161, "name": "arbitrum" },
      "amountRaw": "999870",
      "amountHumanized": "0.00000000000099987",
      "amountInUSD": "1.00"
    }
  },
  "transactions": [
    {
      "chain": "base",
      "txHash": "0xabc...",
      "blockNumber": 19234567,
      "timestamp": "2026-05-19T14:30:15Z",
      "status": "SUCCESS",
      "underlyingAssetFeeValue": "0"
    },
    {
      "chain": "arbitrum",
      "txHash": null,
      "blockNumber": null,
      "timestamp": null,
      "status": "PENDING",
      "underlyingAssetFeeValue": null
    }
  ],
  "finishedAt": null,
  "underlyingAssetFeeValue": "0"
}

Status values:

Status	Meaning
`INITIAL`	Created, awaiting on-chain execution
`PENDING`	At least one transaction broadcast; awaiting confirmations
`SUCCESS`	All steps completed; funds are deposited
`FAILED`	A step failed
`REFUND_REQUIRED`	Bridged funds arrived but the deposit step failed; refund is needed
`REFUNDED`	Refund completed
`EXPIRED`	Quote expired before execution

Poll this endpoint until status reaches a terminal value (SUCCESS, FAILED, REFUNDED, or EXPIRED). The transactions array lists each on-chain hash as it is confirmed, so you can surface progress to the user as the bridge and the destination-chain deposit complete in sequence.

Same-chain deposits do not need this polling — the deposit completes inline with the user’s signed transaction. The id is still returned for record-keeping and can be queried the same way.

Webhook notifications

Pods can push action updates for this deposit to your server. data matches GET /actions/:id. Pass webhookURL on the bytecode request to override the customer default for this deposit. Registration, the signature headers, and delivery rules are in Webhooks. EXPIRED is visible on GET /actions/:id and is not pushed.

Overview

Guides

Integrations

Agents

Request Transaction Data

Simple deposit

Same-chain swap deposit

Cross-chain swap deposit

Output format options

Executing the Transaction

Checking Cross-Chain Deposit Status

Webhook notifications

Next Steps

Check Positions

Withdraw