Collect fees

Collect an Aave vault’s accrued performance fees to its admin wallet.

Collect an Aave vault’s accrued performance fees with the collect fees endpoint. Fees accrue in the vault contract; this action moves the available fees from the vault to the vault’s admin wallet. Fee collection is only supported for Aave vaults.

View the full API reference for the collect fees endpoint.

If your app has gas sponsorship configured, usage of the /earn/ethereum/fees/collect endpoint will be gas-sponsored by default. There is no need to specify additional parameters for sponsorship.

Usage

REST API

Make a POST request to:

https://api.privy.io/api/v1/wallets/{wallet_id}/earn/ethereum/fees/collect

The wallet_id in the path must be the vault’s admin wallet — find it in the Privy Dashboard or as admin_wallet_id in the get vault details response. A single call collects all available fees for the vault; partial collection is not supported.

Parameters

vault_id · string · required

The ID of the vault to collect fees from. Must be an Aave vault.

This endpoint accepts your app secret or a wallet signer. If the admin wallet was created automatically when the vault was deployed and has not been modified, your app secret alone authorizes the request. Admin wallets with an owner_id must provide an authorization signature as a request header.

Returns

id · string

The wallet action ID. Use this to poll status with get wallet action.

wallet_id · string

The ID of the admin wallet collecting the fees.

type · string

The action type. Always "earn_fee_collect" for this endpoint.

status · 'pending' | 'succeeded' | 'rejected' | 'failed'

The current status of the fee collection action.

caip2 · string

Chain identifier in CAIP-2 format.

vault_id · string

The ID of the vault fees were collected from.

vault_address · string

The onchain address of the vault contract.

asset_address · string

The underlying asset’s token address.

amount · string | null

The collected amount in the underlying asset, as a human-readable decimal. null while the action is pending; populated after onchain confirmation. This is your app’s share after the revenue split.

raw_amount · string | null

The collected amount in the smallest unit of the underlying asset. Populated after onchain confirmation.

created_at · string

ISO 8601 timestamp of when the action was created.

Example

curl -X POST https://api.privy.io/api/v1/wallets/{wallet_id}/earn/ethereum/fees/collect \
  -H "privy-app-id: <your-app-id>" \
  -H "Authorization: Basic <credentials>" \
  -H "Content-Type: application/json" \
  -d '{
    "vault_id": "<your-aave-vault-id>"
  }'

Example response

{
  "id": "<action-id>",
  "wallet_id": "<admin-wallet-id>",
  "type": "earn_fee_collect",
  "status": "pending",
  "caip2": "eip155:8453",
  "vault_id": "<your-aave-vault-id>",
  "vault_address": "0x1234567890123456789012345678901234567890",
  "asset_address": "0x1234567890abcdef1234567890abcdef12345678",
  "amount": null,
  "raw_amount": null,
  "created_at": "2025-04-01T12:00:00.000Z"
}

Track the collection by polling get wallet action or listening for the wallet_action.earn_fee_collect.succeeded webhook.

Next steps

Aave integration guide

Deposit, withdraw, read positions, and collect fees for Aave vaults.