概覽
Active and closed strategies for a wallet, each with a live valuation,
realized APY, fee/rebalance rollups, and a positions[] array. USDC
values are decimal dollars.
Endpoint
GET https://earn-api.quicknode.dev/functions/v1/api/v1/strategies
Authorization
Include the published apikey header. This read request is public and does not require a SIWE signature.
參數
| 參數 | Location | 類型 | Required | 說明 |
|---|---|---|---|---|
| wallet | 查詢 | 字串 | 是的 | Owner wallet address. |
Example request
curl --request GET \
--url 'https://earn-api.quicknode.dev/functions/v1/api/v1/strategies?wallet=0x1234567890abcdef1234567890abcdef12345678' \
--header 'Accept: application/json' \
--header 'apikey: <EARN_PUBLIC_API_KEY>'
回應
| 領域 | 類型 | Required | 說明 |
|---|---|---|---|
| strategies | array<object> | 是的 | Active and in-progress strategies owned by the wallet. |
| closedStrategies | array<object> | 是的 | Closed strategies owned by the wallet. |
| strategies[].id | 字串 | 是的 | Strategy UUID. |
| strategies[].wallet_address | 字串 | 是的 | Lowercased owner address. |
| strategies[].name | 字串 | 是的 | Strategy name. |
| strategies[].capital_usdc | 數字 | 是的 | Configured capital in decimal US dollars. |
| strategies[].delta_pct | 數字 | 是的 | Same-chain APY threshold in percentage points. |
| strategies[].cross_chain_delta_pct | 數字 | 不 | Cross-chain APY threshold; `0` inherits `delta_pct`. |
| strategies[].delta_confirmations | 整數 | 是的 | Required consecutive threshold confirmations. |
| strategies[].max_positions | 整數 | 是的 | Maximum vault positions. |
| strategies[].min_tvl_usd | 數字 | 是的 | Minimum vault TVL in decimal US dollars. |
| strategies[].min_liquidity_usd | 數字 | 是的 | Minimum vault liquidity in decimal US dollars. |
| strategies[].min_liquidity_entry_multiplier | 數字 | 是的 | Liquidity multiplier for new entries. |
| strategies[].chain_id | 整數 | 是的 | Legacy primary chain ID. |
| strategies[].chain_ids | string | null | 是的 | Comma-separated authoritative chain IDs. |
| strategies[].apy_smoothing_minutes | 整數 | 是的 | APY smoothing window in minutes. |
| strategies[].hidden_vault_keys | array<string> | 是的 | Vault keys hidden from the strategy. |
| strategies[].status | 字串 | 是的 | Strategy lifecycle status. |
| strategies[].active | 布林值 | 是的 | Whether the strategy is active. |
| strategies[].created_at | 字串 | 是的 | Creation timestamp. |
| strategies[].updated_at | 字串 | 是的 | Last-update timestamp. |
| strategies[].first_deposit_at | string | null | 是的 | First-deposit timestamp. |
| strategies[].deactivated_at | string | null | 是的 | Deactivation timestamp. |
| strategies[].final_value_usdc | number | null | 是的 | Final strategy value in decimal US dollars. |
| strategies[].final_realized_apy | number | null | 是的 | Final realized APY percentage. |
| strategies[].covered | 布林值 | 不 | Whether the strategy uses OpenCover coverage. |
| strategies[].coverage_activated_at | string | null | 不 | Coverage activation timestamp. |
| strategies[].total_value_usdc | 數字 | 是的 | Live position value in decimal US dollars. |
| strategies[].pending_bridge_value_usdc | 數字 | 是的 | Value in pending bridges. |
| strategies[].pending_bridges_count | 整數 | 是的 | Pending bridge count. |
| strategies[].net_value_usdc | 數字 | 是的 | Live value plus pending bridge value. |
| strategies[].realized_apy | number | null | 是的 | Annualized realized APY percentage. |
| strategies[].live_apy | number | null | 不 | Five-minute value-weighted position APY. |
| strategies[].strategy_apy | number | null | 不 | Value-weighted APY at the configured smoothing window. |
| strategies[].positions | array<object> | 是的 | Live-valued vault positions. |
| strategies[].positions[].id | 字串 | 是的 | Position identifier. |
| strategies[].positions[].strategy_id | string | null | 不 | Owning strategy UUID. Present only on list responses. |
| strategies[].positions[].vault_name | string | null | 是的 | Vault display name, or null when unavailable. |
| strategies[].positions[].vault_address | 字串 | 是的 | Vault contract address. |
| strategies[].positions[].protocol | string | null | 是的 | Vault protocol name, or null when unavailable. |
| strategies[].positions[].chain_id | 整數 | 不 | Chain where the vault is deployed. Absent on closed-strategy list positions. |
| strategies[].positions[].shares_raw | string | null | 是的 | Raw ERC-4626 share balance. |
| strategies[].positions[].usdc_value | 數字 | 是的 | Position value in decimal US dollars. |
| strategies[].positions[].entry_apy | 數字 | 是的 | APY percentage at entry. |
| strategies[].positions[].initial_usd_value | number | null | 不 | USDC deposited into the position, in decimal dollars. Absent on closed-strategy list positions. |
| strategies[].positions[].paused | 布林值 | 不 | Whether the position is paused. Absent on closed positions. |
| strategies[].rebalance_count | 整數 | 是的 | Completed rebalance count. |
| strategies[].total_fees_usdc | 數字 | 是的 | Total fees in decimal US dollars. |
Example response
This abbreviated response uses synthetic wallet and strategy data:
{
"strategies": [
{
"id": "b7c1e2d3-0000-4000-8000-000000000001",
"wallet_address": "0x1234567890abcdef1234567890abcdef12345678",
"name": "My USDC Strategy",
"capital_usdc": 1000,
"chain_ids": "8453,42161",
"status": "active",
"positions": [
{
"vault_name": "Seamless USDC Vault",
"chain_id": 8453,
"usdc_value": 600.25
}
]
}
],
"closedStrategies": [
{
"id": "c8d2f1a4-0000-4000-8000-000000000002",
"name": "Closed USDC Strategy",
"status": "closed"
}
]
}
HTTP responses
| 狀態 | 說明 |
|---|---|
| 200 | The wallet's active and closed strategies. |
| 400 | Missing or invalid `wallet` address. |
| 429 | Rate limit exceeded. `Retry-After` (seconds) tells you when to retry. Reads, feedback, and push writes are keyed per IP; create/update/delete are keyed per wallet+IP; deposit/withdraw/claim calldata is keyed per strategy+IP. |
| 500 | Internal server error. |
OpenAPI source
This page is based on operation listStrategies 在 Earn OpenAPI 3.1 specification.