Get swap status

Get the status of swap or bridge transactions. Accepts on-chain transaction hashes (txHashes), ERC-4337 userOperation hashes (userOpHashes), or both. At least one of the two must contain at least one item.

Authorization

x-api-keystringrequiredheader

Playground key

You're using a shared playground keyCreate a free account and get your own API keys from the dashboard.

Get your keys

Headers

x-agent-infostring

Optional attribution hint for AI-agent traffic; send it if an AI agent built or operates your integration. The value is a JSON object with up to three fields: decision_origin (required, exactly autonomous or human_mediated, case-sensitive), integration_name (optional string naming your integration, e.g. my-trading-bot), and version (optional string identifying your integration's version). Any other key is dropped, never rejected. The raw value must be at most 1024 bytes of printable US-ASCII (0x20-0x7E), so send non-ASCII text as JSON \u escapes; integration_name and version are each limited to 256 UTF-16 code units and may not contain control characters, U+2028, U+2029, or U+FFFD. Send the header once: repeated header lines are joined with , and the joined string is what gets parsed, so two complete objects fail as invalid JSON while a single object split across two lines still parses. The header is analytics-only and never affects the request: omitting it, sending it, or sending a value that fails these rules never changes the response status, body, or swap behavior. A value that fails to parse is dropped and reported by the x-agent-info-status response header. Never put a user ID, wallet address, email, session token, or API key in these fields.

Query Parameters

txHashesstring[]

On-chain transaction hashes. At least one of txHashes or userOpHashes must be provided.

userOpHashesstring[]

ERC-4337 UserOperation hashes. At least one of txHashes or userOpHashes must be provided.

chainIdenumdefault:1

1105613013714319632448018684217432646635042845310143421614222043114570735914481457777777713018453211155111

Response

Get swap successful.

requestIdstringrequired

A unique ID for the request.

swapsobject[]

GET/swaps

Request

curl --request GET \
  --url 'https://trade-api.gateway.uniswap.org/v1/swaps' \
  --header 'x-api-key: <api-key>'

Response

200

{  "requestId": "<string>",  "swaps": [    {      "swapType": "<string>",      "status": "<string>",      "txHash": "<string>",      "swapId": "<string>",      "userOpHash": "<string>",      "hashType": "<string>",      "paymaster": "<string>"    }  ]}