Get intent status – Earn API

概要

Poll the lifecycle of an intent returned by the calldata endpoints.

ステータス is derived:

failed: a failure reason was recorded (including pre-transaction failures); fulfilled_tx_hash is always null.
fulfilled: fulfilled_at is set and the intent did not fail.
expired: unfulfilled and past expires_at.
pending: everything else.

404 intent_not_found covers both a missing intent and an intent belonging to another strategy. Raw calldata is never returned.

Endpoint

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

Authorization

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

パラメータ

Parameter	場所	種類	Required	説明
id	path	文字列	はい	Strategy UUID.
intentId	path	文字列	はい	Intent id, returned as `intentId` by the calldata endpoints.

Example request

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

回答

Field	種類	Required	説明
id	文字列	はい	Intent UUID.
strategy_id	文字列	はい	UUID of the strategy that owns the intent.
chain_id	整数	はい	Chain on which the intent transaction is executed.
kind	文字列	はい	One of `deposit`, `close`, `emergency_claim` (from the calldata endpoints), or system-written `rebalance`, `withdraw_bridge`, `relay_deposit`.
created_at	文字列	はい	ISO 8601 timestamp when the intent was created.
expires_at	文字列	はい	The intent attribution TTL (30 days for user kinds), NOT the calldata plan-freshness bound.
ステータス	string (pending \| fulfilled \| failed \| expired)	はい	Derived, not a stored column. `failed`: a failure reason was recorded (including pre-transaction failures; failed wins over fulfilled). `fulfilled`: `fulfilled_at` set and not failed. `expired`: unfulfilled and past `expires_at`. `pending`: everything else.
fulfilled_at	string \| null	はい	When the intent was closed. Also set on some FAILED intents, so branch on `status`, never this field alone.
fulfilled_tx_hash	string \| null	はい	The fulfilling transaction hash; always null on a failed intent.
submitted_tx_hash	string \| null	はい	Broadcast-time hash set on rebalance intents before fulfillment, when known.
failure_reason	string \| null	はい	Human-readable failure detail when `status` is `failed`. Sanitized: URLs are redacted and the text is capped at 200 characters.

Example response

{
	"id": "7f3a1c2b-0000-4000-8000-000000000abc",
	"strategy_id": "b7c1e2d3-0000-4000-8000-000000000001",
	"chain_id": 10,
	"kind": "close",
	"created_at": "2026-07-07T18:00:00.000Z",
	"expires_at": "2026-08-06T18:00:00.000Z",
	"status": "pending",
	"fulfilled_at": null,
	"fulfilled_tx_hash": null,
	"submitted_tx_hash": null,
	"failure_reason": null
}

HTTP responses

ステータス	説明
200	The intent row with its derived status.
400	The strategy id or intent id is not a UUID (`invalid_request`).
404	No such intent for THIS strategy (`intent_not_found`; also returned when the intent belongs to another strategy).
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 getIntentStatus in the Earn OpenAPI 3.1 specification.

Get intent status – Earn API

概要​

Endpoint​

Authorization​

パラメータ​

Example request​

回答​

Example response​

HTTP responses​

概要