Following the orders

Tracking the Status of a Gasless Order

To monitor the status of a gasless order and provide updates to the user, use the following endpoint:

Endpoint:

/v1/gasless/status/{orderId}

---

Description

This endpoint allows you to query the status of an order created via the gasless trading flow. It provides real-time information about the order's current state, enabling you to keep the user informed.

---

How to Use

1. Call the Endpoint: Replace {orderId} with the unique identifier of the order you want to track:

   GET /v1/gasless/status/12345

2. Response: The endpoint returns the current status of the order. Example response:

   
   {
       "response": {
           "id": "561e1e2f-c32b-48c7-bb85-b9bc599d4d91",
           "address": "0x2472d3EF4bF71af00c3dE490a5a53A99CbAC0791",
           "chainFrom": 42161,
           "tokenFrom": "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",
           "chainTo": 0,
           "tokenTo": "0x0000000000000000000000000000000000000000",
           "amount": "6623429",
           "fee": "19898",
           "amountOutMin": "1972679740777741",
           "swapCall": "{\"order\":{\"user\":\"0x2472d3...6bacb2526197387b9e41c\"}",
           "status": "completed", // Possible values: "pending", "processing", "completed", "cancelled", "faile
           "createdAt": "2024-12-23T13:51:34.188129Z",
           "deadLineAt": "2024-12-23T14:21:30Z",
           "canceledAt": null,
           "completedAt": "2024-12-23T13:51:38.019587Z",
           "failedAt": null,
           "signatureCreated": "0x2728c5bd1d666623533d899f6f60d4a49a0d597d4ba1fc7e24079e1cea8d9db26f8b9b63f927f9614060fcafaef60f0ca769a7a77f2af6bacb2526197387b9e41c",
           "signatureCancel": null,
           "failureMsg": null,
           "txCompleted": "0x49fdec98eac1fd27...9361b375", // tx hash when the order is created 
           "apiKey": 17,
           "amountDeducted": "19898",
           "gasPrice": "20000000",
           "estimatedGas": "1304999",
           "gasUsed": "1117733",
           "nativeUsdPrice": "3312.41"
       }
   }

---

Possible Status Values

Status	Description
pending	The order has been created and is awaiting processing.
processing	The order is currently being executed by the system.
completed	The order has been successfully processed and finalized.
cancelled	The order was cancelled before it could be executed.
failed	The order could not be processed due to an error.

---

Key Notes

• Real-Time Updates: Poll this endpoint to get real-time updates about the order status.

• Order Information: Use the orderId provided when the order was created to query its status.

• User Feedback: Use the returned status and message to display appropriate feedback to the user.

This endpoint ensures transparency and allows you to keep users informed about the progress of their gasless trades. 🚀