Skip to main content
GET
/
api
/
trading
/
{exchange}
/
orders
/
{orderId}
/
status
Get Order Status
curl --request GET \
  --url https://api.dexaggregatorbeta.xyz/api/trading/{exchange}/orders/{orderId}/status \
  --header 'X-API-KEY: <api-key>'
{
  "success": true,
  "data": {
    "orderId": "<string>",
    "symbol": "<string>",
    "side": "BUY",
    "type": "LIMIT",
    "status": "OPEN",
    "price": "<string>",
    "quantity": "<string>",
    "filledQuantity": "<string>",
    "timestamp": 123
  }
}
Retrieve the latest status for any order placed through the aggregator. The service normalizes venue-specific payloads from Lighter, Aster, and Hyperliquid so you can reconcile execution states with a single integration.

​
Request

  • Method: GET
  • Endpoint: /api/trading/{exchange}/orders/{orderId}/status
  • Authentication: Required

​
Path Parameters

NameTypeRequiredDescription
exchangestring✅Target venue (lighter, aster, or hyperliquid)
orderIdstring✅Identifier of the order to inspect

​
Query Parameters

NameTypeRequiredDescription
symbolstring❌Optional trading pair hint (e.g. BTC) to speed up the lookup

​
Example

curl -X GET "https://api.dexaggregatorbeta.xyz/api/trading/lighter/orders/12345/status?symbol=BTC"

​
Response

The API returns a normalized order record including identifiers, execution side, order type, fill progress, and the latest venue timestamp. 
{
  "success": true,
  "data": {
    "orderId": "12345",
    "symbol": "BTC",
    "side": "BUY",
    "type": "LIMIT",
    "status": "PARTIALLY_FILLED",
    "price": "49850.00",
    "quantity": "1.0",
    "filledQuantity": "0.6",
    "timestamp": 1730869356000
  }
}

​
Status Values

StatusDescription
OPENOrder is active and waiting to fill
PARTIALLY_FILLEDOrder has partial fills
FILLEDOrder fully executed
CANCELEDOrder was canceled before completion
REJECTEDExchange rejected the order
UNKNOWNThe adapter could not determine the current state

​
Errors

  • 404 – { "success": false, "error": "Order 12345 not found in any market" }
  • 401 – { "success": false, "error": "Missing or invalid credentials for Aster" }
  • 500 – { "success": false, "error": "Failed to fetch order status: timeout" }
Provide per-request credentials for the venues you want to query. Adapters read the payload, fetch live data, and immediately discard the supplied keys.

​
Hyperliquid - Get Historical Orders

Retrieve all previously placed orders for a wallet on Hyperliquid.

​
Endpoint

GET /api/hyperliquid/:walletId/orders/historical

​
Path Parameters

ParameterTypeRequiredDescription
walletIdstringYesWallet ID (UUID)

​
Headers

HeaderValueRequired
x-wallet-idWallet ID (UUID)Yes

​
Example Request

curl -X GET https://api.dexaggregatorbeta.xyz/api/hyperliquid/a1e82339-29f8-41a6-a468-ce8d268a3261/orders/historical \
  -H "x-wallet-id: a1e82339-29f8-41a6-a468-ce8d268a3261"

​
Success Response

{
  "success": true,
  "data": [
    {
      "orderId": "255641266600",
      "symbol": "BTC",
      "side": "BUY",
      "type": "Limit",
      "price": "88287.0",
      "quantity": "0.0",
      "timestamp": 1764682699221
    },
    {
      "orderId": "255638423999",
      "symbol": "BTC",
      "side": "SELL",
      "type": "Limit",
      "price": "87131.0",
      "quantity": "0.00831",
      "timestamp": 1764682498119
    },
    {
      "orderId": "255608992308",
      "symbol": "HYPE",
      "side": "BUY",
      "type": "Limit",
      "price": "31.9",
      "quantity": "1.0",
      "timestamp": 1764680449095
    }
  ],
  "count": 46
}

​
Response Fields

FieldTypeDescription
successbooleanOperation status
dataarrayArray of historical orders
data[].orderIdstringUnique order identifier
data[].symbolstringAsset symbol (e.g., “BTC”, “HYPE”)
data[].sidestringOrder side (“BUY” or “SELL”)
data[].typestringOrder type (“Limit” or “Market”)
data[].pricestringOrder price
data[].quantitystringOrder quantity
data[].timestampnumberUnix timestamp in milliseconds
countnumberTotal number of historical orders

Authorizations

​
X-API-KEY
string
header
required

API key for authentication. Also requires X-API-SECRET, X-API-TIMESTAMP, and X-API-SIGNATURE headers for private endpoints.

Path Parameters

​
exchange
enum<string>
required

Target venue (lighter, aster, or hyperliquid)

Available options:
lighter,
aster,
hyperliquid
​
orderId
string
required

Identifier of the order to inspect

Query Parameters

​
symbol
string

Optional trading pair hint (e.g. BTC) to speed up the lookup

Example:

"BTC"

Response

Order status payload

​
success
boolean
​
data
object