Overview

Up to 100 events (deposits, rebalances, withdrawals, cross-chain bridge-backs), newest-first. forced marks a liquidity- or hide-driven exit from a higher-APY vault.

?format=entries merges the same events with the strategy's CCTP transfers (limit 50) into one entry per action, each with per-chain phases.

Endpoint

GET https://earn-api.quicknode.dev/functions/v1/api/v1/strategies/{id}/history

Authorization

Include the published apikey header. This read request is public and does not require a SIWE signature.

Parameters

Parameter	Location	Type	Required	Description
id	path	string	Yes	Strategy UUID.
format	query	string (events | entries)	No	Response shape. `events` (default) is the flat event log (`HistoryResponse`); `entries` is the aggregated accordion view (`HistoryEntriesResponse`).

Example request

curl --request GET \
  --url 'https://earn-api.quicknode.dev/functions/v1/api/v1/strategies/b7c1e2d3-0000-4000-8000-000000000001/history' \
  --header 'Accept: application/json' \
  --header 'apikey: <EARN_PUBLIC_API_KEY>'

Response

The default events format returns the flat event log. Use format=entries for aggregated actions with per-chain phases.

Field	Type	Required	Description
events	array<object>	Yes	Up to 100 strategy events, newest first.
events[].id	string	Yes	Event identifier.
events[].strategy_id	string	Yes	Strategy UUID.
events[].wallet_address	string | null	Yes	Wallet associated with the event.
events[].event_type	string	Yes	Legacy event label.
events[].kind	string	Yes	`deposit`, `crosschain_deposit`, `rebalance`, `crosschain_rebalance`, `withdrawal`, or `crosschain_withdrawal`.
events[].from_vault	string | null	Yes	Source vault address, when applicable.
events[].from_vault_name	string | null	Yes	Source vault name.
events[].from_apy	number | null	Yes	Source APY percentage.
events[].to_vault	string | null	Yes	Destination vault address, when applicable.
events[].to_vault_name	string | null	Yes	Destination vault name.
events[].to_apy	number | null	Yes	Destination APY percentage.
events[].usdc_amount	number | null	Yes	Event amount in decimal US dollars.
events[].fee_usdc	number | null	Yes	Fee in decimal US dollars.
events[].gas_cost_usdc	number | null	Yes	Gas cost in decimal US dollars.
events[].tx_hash	string | null	Yes	Primary transaction hash.
events[].burn_tx_hash	string | null	Yes	CCTP burn transaction hash.
events[].timestamp	string	Yes	Event timestamp in ISO 8601 format.
events[].chain_id	integer	Yes	Chain where the event occurred.
events[].log_index	integer | null	Yes	Event log index, when available.
events[].forced	boolean	Yes	Whether the rebalance exited a higher-APY vault because of liquidity or hiding rules.
entries	array<object>	Yes for `format=entries`	Aggregated actions returned instead of `events` when `format=entries`.
truncated	boolean	Yes for `format=entries`	True when internal read limits were reached and older activity may be missing.
entries[].id	string	Yes	Stable aggregated-entry identifier.
entries[].category	string	Yes	Action category such as `strategy_enter`, `strategy_exit`, or a rebalance category.
entries[].timestamp	string	Yes	Top-level action timestamp.
entries[].amountUsdc	number	Yes	Total action amount in decimal US dollars.
entries[].feeUsdc	number | null	Yes	Total action fee in decimal US dollars.
entries[].phases	array<object>	Yes	Per-chain steps for the action.
entries[].pending	boolean	No	True when at least one phase has not confirmed.

Example response

{
	"events": [
		{
			"id": "8453-0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa-131",
			"strategy_id": "b7c1e2d3-0000-4000-8000-000000000001",
			"wallet_address": "0x1234567890abcdef1234567890abcdef12345678",
			"event_type": "rebalance",
			"kind": "rebalance",
			"from_vault": "0x616a4e1db48e22028f6bbf20444cd3b8e3273738",
			"from_vault_name": "Seamless USDC Vault",
			"from_apy": 4.85,
			"to_vault": "0x1a996cb54bb95462040408c06122d45d6cdb6096",
			"to_vault_name": "Gauntlet USDC Core",
			"to_apy": 6.42,
			"usdc_amount": 500,
			"fee_usdc": 0.12,
			"gas_cost_usdc": 0.03,
			"tx_hash": "0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
			"burn_tx_hash": null,
			"timestamp": "2026-07-07T18:00:00.000Z",
			"chain_id": 8453,
			"log_index": 131,
			"forced": false
		}
	]
}

HTTP responses

Status	Description
200	The flat event log (default) or the aggregated entries view (`format=entries`). Branch on the `format` you requested.
400	Invalid strategy id (a UUID is required) or unknown `format`.
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 getStrategyHistory in the Earn OpenAPI 3.1 specification.