POST /v1/intents/search

The GET /v1/intents/search endpoint allows you to retrieve a list of intents filtered by wallet addresses and statuses. This is particularly useful for displaying pending, successful, or expired intents for customer dashboards. The list is ordered by creation date of intents (newest first).

---

Request

Endpoint

POST https://snipe.merkle.io/v1/intents/search

Body

The request body specifies the wallet addresses and optionally the statuses to filter the intents.

{
  "addresses": [
    "0x1234567890abcdef1234567890abcdef12345678",
    "0xabcdef1234567890abcdef1234567890abcdef12"
  ],
  "status": [
    "pending",
    "completed",
    "expired",
    "cancelled",
    "error"
  ]
}

Field	Type	Required	Description
addresses	string[]	Yes	A list of wallet addresses to search for intents.
status	string[]	No	List of statuses to filter intents (default is ["pending"]).

Status Options

• pending: Intents waiting for token launch.

• completed: Intents successfully executed.

• expired: Intents that have expired.

• failed: Intents that have failed

• cancelled: Intents canceled by the user.

• error: Intents in an error state.

---

Response

A list of intents, same schema as POST /v1/intent.