Platform
Deployment config, platform-wide stats, and native gas-token USD prices.
/v1/statsPlatform-wide aggregate stats
Total USDC under management, active strategy count, and total
rebalances executed. total_usdc is a best-effort live figure and may
fall back to the last-known aggregate.
Auth: apikey header
Responses
| Status | Type | Description |
|---|---|---|
200 | PlatformStatsResponse | Platform aggregate stats. |
429 | ApiError | 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. |
/v1/pricesNative gas-token USD prices
Latest USD price for each supported native gas token (ETH, POL, MON),
updated hourly. chains maps each supported chain id to the USD price
of that chain's native gas token.
Auth: apikey header
Responses
| Status | Type | Description |
|---|---|---|
200 | PricesResponse | Latest native gas-token prices. |
429 | ApiError | 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. |
503 | ApiError | Price data temporarily unavailable. |
/v1/configPublic deployment config
The Earn contract address (the same on every chain) and per-chain
display names and minimum strategy sizes. A chain missing from
chains is not currently served. minStrategyUsdc is enforced by
POST /v1/strategies for every chain in chain_ids (since v1.13.0). banner is the
first-party announcement strip the Earn app renders above its nav, and
is null whenever none is active. coveredStrategiesEnabled is the
operator kill switch for covered strategies (see the schema); it is
cached with the rest of the response, while POST /v1/strategies
re-checks it live. partialActionsEnabled is the partial deposit and
withdraw rollout flag, re-checked live by the calldata routes.
Responses carry Cache-Control: public, max-age=300.
Auth: apikey header
Responses
| Status | Type | Description |
|---|---|---|
200 | ConfigResponse | The deployment config. |
429 | ApiError | 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 | ApiError | Deployment config unavailable. |