curl --request GET \
--url https://perps-api.vooi.io/exchange/order \
--header 'Authorization: Bearer <token>'import requests
url = "https://perps-api.vooi.io/exchange/order"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://perps-api.vooi.io/exchange/order', 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://perps-api.vooi.io/exchange/order",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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://perps-api.vooi.io/exchange/order"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://perps-api.vooi.io/exchange/order")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://perps-api.vooi.io/exchange/order")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"baseSymbol": "ETH",
"clientOrderId": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"exchange": "aster",
"filledSize": "0.0005",
"orderId": "<string>",
"positionSide": "both",
"price": "1800.00",
"quoteSymbol": "USDC",
"reduceOnly": true,
"side": "buy",
"size": "0.001",
"status": "canceled",
"timeInForce": "gtc",
"triggerPrice": "1800.00",
"type": "limit",
"updatedAt": "2023-11-07T05:31:56Z"
}{
"message": "Invalid order id: 123",
"statusCode": 503
}{
"message": "Invalid order id: 123",
"statusCode": 503
}Get a single order by its exchange order ID or your client order ID
curl --request GET \
--url https://perps-api.vooi.io/exchange/order \
--header 'Authorization: Bearer <token>'import requests
url = "https://perps-api.vooi.io/exchange/order"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://perps-api.vooi.io/exchange/order', 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://perps-api.vooi.io/exchange/order",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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://perps-api.vooi.io/exchange/order"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://perps-api.vooi.io/exchange/order")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://perps-api.vooi.io/exchange/order")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"baseSymbol": "ETH",
"clientOrderId": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"exchange": "aster",
"filledSize": "0.0005",
"orderId": "<string>",
"positionSide": "both",
"price": "1800.00",
"quoteSymbol": "USDC",
"reduceOnly": true,
"side": "buy",
"size": "0.001",
"status": "canceled",
"timeInForce": "gtc",
"triggerPrice": "1800.00",
"type": "limit",
"updatedAt": "2023-11-07T05:31:56Z"
}{
"message": "Invalid order id: 123",
"statusCode": 503
}{
"message": "Invalid order id: 123",
"statusCode": 503
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
Market the order is on — required for Aster, Binance, Bybit, Lighter and Robinhood, and for MEXC when looking up by clientOrderId; not used otherwise.
1"ETH"
Your custom order identifier, the one you passed when creating the order.
1Supported perpetual exchange
aster, binance, bybit, extended, gate, hyperliquid, lighter, mexc, ondo, robinhood Order identifier assigned by the exchange.
1Response
"ETH"
Order identifier, as returned by the exchange.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$Perpetual exchange
aster, binance, bybit, extended, gate, hyperliquid, lighter, mexc, ondo, robinhood Size already executed, in base asset units. Null when the exchange does not report it, or for orders placed before the field existed.
"0.0005"
both, long, short Limit price in quote currency, or null for market orders.
"1800.00"
"USDC"
Whether the order only reduces an existing position
buy, sell "0.001"
canceled, created, error, executed, partiallyFilled Time in force policy of the order. gtc — Good-Till-Cancel, ioc — Immediate-Or-Cancel, fok — Fill-Or-Kill, alo — Add Liquidity Only. Null for market, trigger, or liquidation orders where TIF is not applicable.
gtc, ioc, fok, alo "gtc"
"1800.00"
limit, liquidation, market, other, stopLoss, stopLossLimit, takeProfit, takeProfitLimit ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$