yieldaggregator

Deposit Vault

Initiates token deposits into yield-generating vaults with configurable gas parameters and flexible identification methods (via vaultAddress or tokenAddress and vaultNumber). The endpoint processes the deposit transaction on the designated blockchain and returns key details—such as chain ID, addresses, transaction value, gas usage, and a unique reference ID—essential for managing multiple vaults efficiently.

💡 Compute Unit Value: 25 (Fixed)

post/defi/v1/yieldaggregator/depositvault

Request

Base URL
https://svc.blockdaemon.com
URL
https://svc.blockdaemon.com/defi/v1/yieldaggregator/depositvault
Auth
API key in header X-API-Key

Request body

amountstring required

Number of tokens, specified in the token's smallest denomination (base units). Do not send human-readable decimal values. Examples: 1 WETH (18 decimals) = "1000000000000000000"; 1 USDC (6 decimals) = "1000000".

tokenAddressstring

The contract address of the token being deposited. Use this field when identifying the vault by token along with the vaultNumber (if multiple vaults exist for the same token).

fromstring required

Blockchain address of the sender. For EVM chains, use a checksummed hex address (e.g., 0xABCDEF...). This address must hold sufficient balance and will sign the transaction.

gasstring

Maximum number of gas units to allocate for the transaction, as an integer string (e.g., '200000'). If omitted, gas is estimated automatically. Note: this is gas units, not wei or gwei.

vaultNumberstring

A numeric identifier for the specific vault associated with the token. This is required when using the tokenAddress approach to distinguish between multiple vaults for the same token.

vaultAddressstring

The direct blockchain address of the yield vault. Use this field if you wish to bypass tokenAddress and vaultNumber by specifying the exact vault address.

yieldAggregatorId'5000' | '5001' | '5002' | '5003' | '5100'

The unique ID to specify the yield aggregator for queries or transactions.

gasPrioritystring

Specifies the priority level for gas fees (e.g., 'low', 'medium', or 'high'), which influences the transaction speed and cost.

enableFeeboolean

Flag to include a basis points fee transaction alongside the main transaction when set to true.

poolAddressstring

The blockchain address of the pool associated with the vault, ensuring that the deposit is routed to the correct liquidity pool for yield generation.

Example request

{
  "amount": "1000000000000000000",
  "tokenAddress": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
  "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
  "gas": "100000",
  "vaultNumber": "1",
  "vaultAddress": "0xa258C4606Ca8206D8aA700cE2143D7db854D168c",
  "yieldAggregatorId": "5000",
  "gasPriority": "low",
  "enableFee": false,
  "poolAddress": "0xfad57d2039c21811c8f2b5d5b65308aa99d31559"
}

Response

Successful response

statusinteger

msgstring

dataobject

Example response

{
  "status": 200,
  "msg": "success",
  "data": {
    "chainId": "1",
    "from": "0x63056E00436Da25BcF48A40dfBbDcc7089351006",
    "to": "0xFE09e53A81Fe2808bc493ea64319109B5bAa573e",
    "value": "0",
    "gas": "2307200",
    "data": "0xb6b55f25000000000000000000000000000000000000000000000000000000000007a120",
    "referenceId": "d33bc36f30ff49e385388ba332f67594"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.