अवलोकन

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.

पैरामीटर

Parameter	Location	Type	Required	विवरण
wallet	query	डोरी	हाँ	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>'

प्रतिक्रिया

Field	Type	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 in the Earn OpenAPI 3.1 specification.