Get Order Status - Tide API Documentation

Retrieve the latest status for any order placed through the aggregator. The service normalizes venue-specific payloads from Lighter, Aster, Hyperliquid, and Avantis so you can reconcile execution states with a single integration.

Request

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

Path Parameters

Name	Type	Required	Description
`exchange`	string	✅	Target venue (`lighter`, `aster`, `hyperliquid`, or `avantis`)
`orderId`	string	✅	Identifier of the order to inspect

Query Parameters

Name	Type	Required	Description
`symbol`	string	❌	Optional trading pair hint (e.g. `BTC`) to speed up the lookup

Example

curl -X GET "https://api.tide.ag/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

Status	Description
`OPEN`	Order is active and waiting to fill
`PARTIALLY_FILLED`	Order has partial fills
`FILLED`	Order fully executed
`CANCELED`	Order was canceled before completion
`REJECTED`	Exchange rejected the order
`UNKNOWN`	The 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

Parameter	Type	Required	Description
`walletId`	string	Yes	Wallet ID (UUID)

Headers

Header	Value	Required
`x-wallet-id`	Wallet ID (UUID)	Yes

Example Request

curl -X GET https://api.tide.ag/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

Field	Type	Description
`success`	boolean	Operation status
`data`	array	Array of historical orders
`data[].orderId`	string	Unique order identifier
`data[].symbol`	string	Asset symbol (e.g., “BTC”, “HYPE”)
`data[].side`	string	Order side (“BUY” or “SELL”)
`data[].type`	string	Order type (“Limit” or “Market”)
`data[].price`	string	Order price
`data[].quantity`	string	Order quantity
`data[].timestamp`	number	Unix timestamp in milliseconds
`count`	number	Total number of historical orders

Avantis - Get Open Limit Orders

Retrieve all open limit orders for a wallet on Avantis.

Endpoint

GET /api/trading/avantis/orders

Headers

Header	Value	Required
`x-wallet-id`	Wallet address	Yes

Example Request

curl -X GET https://api.tide.ag/api/trading/avantis/orders \
  -H "x-wallet-id: 0xabc123..."

Success Response

{
  "success": true,
  "data": {
    "exchange": "avantis",
    "orders": [
      {
        "orderId": "avantis-0-3",
        "symbol": "ETH",
        "side": "Long",
        "type": "Limit",
        "status": "OPEN",
        "price": "3200.00",
        "quantity": "0.05",
        "filledQuantity": "0",
        "timestamp": 12345678,
        "exchange": "avantis"
      }
    ],
    "count": 1
  }
}

Response Fields

Field	Type	Description
`orderId`	string	Format: `avantis-<pairIndex>-<index>`
`symbol`	string	Asset symbol (e.g., “ETH”, “BTC”)
`side`	string	`"Long"` or `"Short"`
`type`	string	Always `"Limit"` for open orders
`status`	string	Always `"OPEN"`
`price`	string	Limit price in USD
`quantity`	string	Token amount
`filledQuantity`	string	Always `"0"` for open orders
`timestamp`	number	Block number when the order was placed
`exchange`	string	Always `"avantis"`

Avantis - Trade History (Closed Trades)

Retrieve closed trade history for a wallet on Avantis.

Endpoint

GET /api/trading/avantis/history/trades

Headers

Header	Value	Required
`x-wallet-id`	Wallet address	Yes

Example Request

curl -X GET https://api.tide.ag/api/trading/avantis/history/trades \
  -H "x-wallet-id: 0xabc123..."

Success Response

{
  "success": true,
  "data": [
    {
      "id": "trade_001",
      "symbol": "ETH",
      "exchange": "avantis",
      "price": "3500.00",
      "size": "0.032416",
      "side": "Long",
      "timestamp": 1698840000000
    }
  ]
}

Response Fields

Field	Type	Description
`id`	string	Unique trade identifier
`symbol`	string	Asset symbol
`exchange`	string	Always `"avantis"`
`price`	string	Close price in USD
`size`	string	Token amount
`side`	string	`"Long"` or `"Short"`
`timestamp`	number	Closed-at timestamp in milliseconds

Avantis - Historical Orders (Limit Order History)

Retrieve historical limit orders for a wallet on Avantis.

Endpoint

GET /api/trading/avantis/history/orders

Headers

Header	Value	Required
`x-wallet-id`	Wallet address	Yes

Example Request

curl -X GET https://api.tide.ag/api/trading/avantis/history/orders \
  -H "x-wallet-id: 0xabc123..."

Success Response

Same shape as the open limit orders response above, but includes orders in all statuses (filled, cancelled, expired).

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, hyperliquid, or avantis)

Available options:

lighter,

aster,

hyperliquid,

avantis

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

Show child attributes

​Request

​Path Parameters

​Query Parameters

​Example

​Response

​Status Values

​Errors

​Hyperliquid - Get Historical Orders

​Endpoint

​Path Parameters

​Headers

​Example Request

​Success Response

​Response Fields

​Avantis - Get Open Limit Orders

​Endpoint

​Headers

​Example Request

​Success Response

​Response Fields

​Avantis - Trade History (Closed Trades)

​Endpoint

​Headers

​Example Request

​Success Response

​Response Fields

​Avantis - Historical Orders (Limit Order History)

​Endpoint

​Headers

​Example Request

​Success Response

Authorizations

Path Parameters

Query Parameters

Response

Request

Path Parameters

Query Parameters

Example

Response

Status Values

Errors

Hyperliquid - Get Historical Orders

Endpoint

Path Parameters

Headers

Example Request

Success Response

Response Fields

Avantis - Get Open Limit Orders

Endpoint

Headers

Example Request

Success Response

Response Fields

Avantis - Trade History (Closed Trades)

Endpoint

Headers

Example Request

Success Response

Response Fields

Avantis - Historical Orders (Limit Order History)

Endpoint

Headers

Example Request

Success Response