List order history
curl --request GET \
--url https://api.numofx.com/orders \
--header 'X-Numo-Auth: <x-numo-auth>'import requests
url = "https://api.numofx.com/orders"
headers = {"X-Numo-Auth": "<x-numo-auth>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Numo-Auth': '<x-numo-auth>'}};
fetch('https://api.numofx.com/orders', 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.numofx.com/orders",
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-Numo-Auth: <x-numo-auth>"
],
]);
$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.numofx.com/orders"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Numo-Auth", "<x-numo-auth>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.numofx.com/orders")
.header("X-Numo-Auth", "<x-numo-auth>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.numofx.com/orders")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Numo-Auth"] = '<x-numo-auth>'
response = http.request(request)
puts response.read_body{
"orders": [
{
"order_id": "<string>",
"owner_address": "<string>",
"signer_address": "<string>",
"subaccount_id": "<string>",
"recipient_id": "<string>",
"nonce": "<string>",
"side": "buy",
"asset_address": "<string>",
"sub_id": "<string>",
"desired_amount": "<string>",
"filled_amount": "<string>",
"limit_price": "<string>",
"worst_fee": "<string>",
"expiry": 123,
"action_json": "<unknown>",
"signature": "<string>",
"status": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"market": "<string>",
"contract_type": "<string>",
"settlement_type": "<string>",
"base_asset_symbol": "<string>",
"quote_asset_symbol": "<string>",
"display_name": "<string>",
"display_label": "<string>",
"tick_size": "<string>",
"price_semantics": "<string>",
"display_semantics": "<string>",
"cancel_reason": "<string>",
"cancelled_at": "2023-11-07T05:31:56Z",
"filled_quote": "<string>"
}
],
"next_before": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}Markets service
List order history
Your orders in every status, newest first.
GET
/
orders
List order history
curl --request GET \
--url https://api.numofx.com/orders \
--header 'X-Numo-Auth: <x-numo-auth>'import requests
url = "https://api.numofx.com/orders"
headers = {"X-Numo-Auth": "<x-numo-auth>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-Numo-Auth': '<x-numo-auth>'}};
fetch('https://api.numofx.com/orders', 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.numofx.com/orders",
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-Numo-Auth: <x-numo-auth>"
],
]);
$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.numofx.com/orders"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-Numo-Auth", "<x-numo-auth>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.numofx.com/orders")
.header("X-Numo-Auth", "<x-numo-auth>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.numofx.com/orders")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-Numo-Auth"] = '<x-numo-auth>'
response = http.request(request)
puts response.read_body{
"orders": [
{
"order_id": "<string>",
"owner_address": "<string>",
"signer_address": "<string>",
"subaccount_id": "<string>",
"recipient_id": "<string>",
"nonce": "<string>",
"side": "buy",
"asset_address": "<string>",
"sub_id": "<string>",
"desired_amount": "<string>",
"filled_amount": "<string>",
"limit_price": "<string>",
"worst_fee": "<string>",
"expiry": 123,
"action_json": "<unknown>",
"signature": "<string>",
"status": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"market": "<string>",
"contract_type": "<string>",
"settlement_type": "<string>",
"base_asset_symbol": "<string>",
"quote_asset_symbol": "<string>",
"display_name": "<string>",
"display_label": "<string>",
"tick_size": "<string>",
"price_semantics": "<string>",
"display_semantics": "<string>",
"cancel_reason": "<string>",
"cancelled_at": "2023-11-07T05:31:56Z",
"filled_quote": "<string>"
}
],
"next_before": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}Your orders in every status, newest first:
Send
active, matching, filled, cancelled and expired.
Authentication
Sign this exact message withpersonal_sign, using unix seconds and no trailing newline:
<domain> wants you to view your Numo order history.
Address: <address>
Nonce: <nonce>
Issued At: <issued_at>
Expiration Time: <expiry>
address, signature, nonce, issued_at and expiry as base64url-encoded JSON in the X-Numo-Auth header. A frame can be reused until it expires, up to 24 hours. WebSocket frames are not accepted here.
What traded
filled_quote is the USDC that actually changed hands. Use it to reconcile, not the order’s amount × limit price, which overstates a marketable order. It is absent when nothing filled.
Retention and paging
Orders that traded are kept indefinitely. Cancelled and expired orders with no fills are pruned after 30 days. Pages hold up tolimit orders (default 50, maximum 100). Pass next_before as before for older orders. The last page has no next_before.Headers
Query Parameters
Was this page helpful?

