Get deposit status

Retrieves the current status and details of a deposit transaction using its unique tracking ID.

This endpoint allows you to monitor the progress of a deposit from initiation to completion. The tracking ID is returned when you create a deposit in UUID format.

Please be aware that if you see failed state, it can be also due to high gas fees, max allowed is 1 USD in gas fees, otherwise it will fail.

Status Values (returned in status):

• PROCESSING: Deposit is queued or being handled on the source chain.
• BRIDGING (cross-chain only): Source-side funds movement succeeded and is bridging to the destination chain. Same-chain deposits go straight to final SUCCESS or FAILED status.
• SUCCESS: Deposit has been successfully completed and funds are in the protocol.
• FAILED: Deposit transaction has failed (e.g., insufficient gas, transaction reverted).
• EMERGENCY_WITHDRAW: Destination-side deposit could not complete; funds were recovered via emergency withdrawal.

The API only exposes the five values above. Any other internal persistence state is mapped to PROCESSING for this response until the flow resolves.

Response Details: When successful, the response includes:

• Current deposit status ("SUCCESS")
• Target protocol name (e.g., "Aave", "Morpho", "Euler") where funds were deposited
• Pool/vault contract address receiving the funds
• Blockchain network where the deposit occurred

Use Cases:

• Poll this endpoint to track deposit progress after creation
• Verify successful completion before proceeding with other operations
• Display real-time status updates to users in your application

Note: If you receive a error code, the tracking ID is probably invalid or no deposit exists for that ID.

Rate limiting: 1 request per 3 seconds per client IP. Excess requests receive HTTP 429 with Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset headers (see RateLimitExceeded response).

{
  "protocol": "Aave",
  "pool": "0xabcdefabcdefabcdefabcdefabcdefabcdefabcd",
  "chain": "linea"
}