List fills
curl --request GET \
--url https://api.numofx.com/fills \
--header 'X-Numo-Auth: <x-numo-auth>'import requests
url = "https://api.numofx.com/fills"
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/fills', 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/fills",
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/fills"
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/fills")
.header("X-Numo-Auth", "<x-numo-auth>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.numofx.com/fills")
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{
"fills": [
{
"trade_id": 123,
"order_id": "<string>",
"liquidity": "taker",
"side": "buy",
"price": "<string>",
"size": "<string>",
"asset_address": "<string>",
"sub_id": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"market": "<string>",
"display_name": "<string>",
"fee": "<string>",
"tx_hash": "<string>",
"mark_price": "<string>",
"vm_cngn": "<string>",
"vm_usdc": "<string>"
}
],
"next_before": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}Markets service
List fills
Your fills, newest first.
GET
/
fills
List fills
curl --request GET \
--url https://api.numofx.com/fills \
--header 'X-Numo-Auth: <x-numo-auth>'import requests
url = "https://api.numofx.com/fills"
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/fills', 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/fills",
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/fills"
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/fills")
.header("X-Numo-Auth", "<x-numo-auth>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.numofx.com/fills")
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{
"fills": [
{
"trade_id": 123,
"order_id": "<string>",
"liquidity": "taker",
"side": "buy",
"price": "<string>",
"size": "<string>",
"asset_address": "<string>",
"sub_id": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"market": "<string>",
"display_name": "<string>",
"fee": "<string>",
"tx_hash": "<string>",
"mark_price": "<string>",
"vm_cngn": "<string>",
"vm_usdc": "<string>"
}
],
"next_before": "<string>"
}{
"error": "<string>"
}{
"error": "<string>"
}Your fills, newest first. Use them to reconcile balances. Order history shows the same activity per order.
Send the same
X-Numo-Auth frame as order history. The owner comes from the signature.
Reading a fill
liquidityistakerif your order crossed the book,makerif it rested.side,priceandsizeare your order’s side, the price in USDC per unit of the base, and the size.feeis what you paid in USDC,0for a maker. It is absent when unknown.tx_hashis the Base transaction that settled the fill. Older fills may not have one.- A trade between two of your own subaccounts is listed once per order, with one
trade_id.
Variation margin
Futures only.mark_price is the mark when the fill’s transaction ran. vm_usdc is what settled to your account, negative when paid: your side × the size in the base × (mark_price − price). The retired USDC-cNGN-30NOV26 reports vm_cngn instead.
Retention and paging
Fills are kept indefinitely. Pages hold up tolimit fills (default 50, maximum 100). Pass next_before as before for older fills. The last page has no next_before.Headers
Query Parameters
Was this page helpful?

