Get Order Status - Tide API Documentation

Get Order Status

curl --request GET \
  --url https://api.tide.ag/api/trading/{exchange}/orders/{orderId}/status \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://api.tide.ag/api/trading/{exchange}/orders/{orderId}/status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tide.ag/api/trading/{exchange}/orders/{orderId}/status",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tide.ag/api/trading/{exchange}/orders/{orderId}/status"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.tide.ag/api/trading/{exchange}/orders/{orderId}/status")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "orderId": "<string>",
    "symbol": "<string>",
    "side": "BUY",
    "type": "LIMIT",
    "status": "OPEN",
    "price": "<string>",
    "quantity": "<string>",
    "filledQuantity": "<string>",
    "timestamp": 123
  }
}

{
  "success": false,
  "error": "Missing or invalid credentials for Aster"
}

{
  "success": false,
  "error": "Order 12345 not found in any market"
}

{
  "success": false,
  "error": "Failed to fetch order status: timeout"
}

GET

api

trading

{exchange}

orders

{orderId}

status

Get Order Status

curl --request GET \
  --url https://api.tide.ag/api/trading/{exchange}/orders/{orderId}/status \
  --header 'X-API-KEY: <api-key>'

const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};

fetch('https://api.tide.ag/api/trading/{exchange}/orders/{orderId}/status', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.tide.ag/api/trading/{exchange}/orders/{orderId}/status",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "X-API-KEY: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.tide.ag/api/trading/{exchange}/orders/{orderId}/status"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-KEY", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.tide.ag/api/trading/{exchange}/orders/{orderId}/status")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "orderId": "<string>",
    "symbol": "<string>",
    "side": "BUY",
    "type": "LIMIT",
    "status": "OPEN",
    "price": "<string>",
    "quantity": "<string>",
    "filledQuantity": "<string>",
    "timestamp": 123
  }
}

{
  "success": false,
  "error": "Missing or invalid credentials for Aster"
}

{
  "success": false,
  "error": "Order 12345 not found in any market"
}

{
  "success": false,
  "error": "Failed to fetch order status: timeout"
}

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