curl --request POST \
--url https://api.fairground.fi/order_service.v1.OrderService/GetOrders \
--header 'Authorization: Bearer <token>' \
--header 'Connect-Protocol-Version: <connect-protocol-version>' \
--header 'Content-Type: application/json' \
--data '
{
"address": "<string>",
"market": {
"marketId": "<string>"
}
}
'import requests
url = "https://api.fairground.fi/order_service.v1.OrderService/GetOrders"
payload = {
"address": "<string>",
"market": { "marketId": "<string>" }
}
headers = {
"Connect-Protocol-Version": "<connect-protocol-version>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Connect-Protocol-Version': '<connect-protocol-version>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({address: '<string>', market: {marketId: '<string>'}})
};
fetch('https://api.fairground.fi/order_service.v1.OrderService/GetOrders', 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.fairground.fi/order_service.v1.OrderService/GetOrders",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'address' => '<string>',
'market' => [
'marketId' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Connect-Protocol-Version: <connect-protocol-version>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fairground.fi/order_service.v1.OrderService/GetOrders"
payload := strings.NewReader("{\n \"address\": \"<string>\",\n \"market\": {\n \"marketId\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Connect-Protocol-Version", "<connect-protocol-version>")
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.fairground.fi/order_service.v1.OrderService/GetOrders")
.header("Connect-Protocol-Version", "<connect-protocol-version>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"address\": \"<string>\",\n \"market\": {\n \"marketId\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fairground.fi/order_service.v1.OrderService/GetOrders")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Connect-Protocol-Version"] = '<connect-protocol-version>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"address\": \"<string>\",\n \"market\": {\n \"marketId\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"orders": [
{
"owner": "0xAbcd1234....",
"orderId": "85",
"timestamp": "2026-08-24T16:21:01.188705915Z",
"marketId": "12942289985198375563",
"market": "BTC-USD",
"type": "ORDER_TYPE_MARKET",
"side": "SIDE_LONG",
"thresholdPrice": 79716.71,
"size": 995.52015,
"leverage": 10,
"status": "ORDER_STATUS_FULLY_FILLED",
"filledSize": 995.52015,
"unfilledSize": 0,
"reduceOnly": false,
"fees": 0.311272,
"rebates": 0,
"reduceOrderType": "",
"initialNotional": 995.52015,
"stopLossPrice": 78000,
"takeProfitPrice": 80000,
"createdAt": "2026-06-18T14:32:07Z",
"updatedAt": "2026-06-18T14:32:07Z",
"averageFillPrice": 79291.69124800728,
"filledQuoteSize": 995.52015,
"margin": 99.552015,
"triggerPrice": 0
}
]
}GetOrders
Returns the latest stored state of each order associated with address,
optionally filtered to one market. Results include position-opening and
reduce-only orders across active and terminal statuses. This endpoint
does not return order lifecycle events or individual fills.
curl --request POST \
--url https://api.fairground.fi/order_service.v1.OrderService/GetOrders \
--header 'Authorization: Bearer <token>' \
--header 'Connect-Protocol-Version: <connect-protocol-version>' \
--header 'Content-Type: application/json' \
--data '
{
"address": "<string>",
"market": {
"marketId": "<string>"
}
}
'import requests
url = "https://api.fairground.fi/order_service.v1.OrderService/GetOrders"
payload = {
"address": "<string>",
"market": { "marketId": "<string>" }
}
headers = {
"Connect-Protocol-Version": "<connect-protocol-version>",
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
'Connect-Protocol-Version': '<connect-protocol-version>',
Authorization: 'Bearer <token>',
'Content-Type': 'application/json'
},
body: JSON.stringify({address: '<string>', market: {marketId: '<string>'}})
};
fetch('https://api.fairground.fi/order_service.v1.OrderService/GetOrders', 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.fairground.fi/order_service.v1.OrderService/GetOrders",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'address' => '<string>',
'market' => [
'marketId' => '<string>'
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Connect-Protocol-Version: <connect-protocol-version>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.fairground.fi/order_service.v1.OrderService/GetOrders"
payload := strings.NewReader("{\n \"address\": \"<string>\",\n \"market\": {\n \"marketId\": \"<string>\"\n }\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Connect-Protocol-Version", "<connect-protocol-version>")
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.fairground.fi/order_service.v1.OrderService/GetOrders")
.header("Connect-Protocol-Version", "<connect-protocol-version>")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"address\": \"<string>\",\n \"market\": {\n \"marketId\": \"<string>\"\n }\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.fairground.fi/order_service.v1.OrderService/GetOrders")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Connect-Protocol-Version"] = '<connect-protocol-version>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"address\": \"<string>\",\n \"market\": {\n \"marketId\": \"<string>\"\n }\n}"
response = http.request(request)
puts response.read_body{
"orders": [
{
"owner": "0xAbcd1234....",
"orderId": "85",
"timestamp": "2026-08-24T16:21:01.188705915Z",
"marketId": "12942289985198375563",
"market": "BTC-USD",
"type": "ORDER_TYPE_MARKET",
"side": "SIDE_LONG",
"thresholdPrice": 79716.71,
"size": 995.52015,
"leverage": 10,
"status": "ORDER_STATUS_FULLY_FILLED",
"filledSize": 995.52015,
"unfilledSize": 0,
"reduceOnly": false,
"fees": 0.311272,
"rebates": 0,
"reduceOrderType": "",
"initialNotional": 995.52015,
"stopLossPrice": 78000,
"takeProfitPrice": 80000,
"createdAt": "2026-06-18T14:32:07Z",
"updatedAt": "2026-06-18T14:32:07Z",
"averageFillPrice": 79291.69124800728,
"filledQuoteSize": 995.52015,
"margin": 99.552015,
"triggerPrice": 0
}
]
}Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Headers
Define the version of the Connect protocol. If omitted, use 1.
1 Define the timeout, in ms
Body
Request for listing order records owned by a wallet.
Wallet address used to filter orders. The server trims surrounding whitespace and matches addresses case-insensitively.
Optional market filter.
Omit this field to query all markets. Set a valid market_id or
market_symbol to filter by that market.
- market_id
- market_symbol
Show child attributes
Show child attributes
Response
Success
Response containing the matching order records.
Orders matching the wallet and optional market filter.
Includes active and terminal order statuses and is ordered by timestamp
descending, newest first. No pagination or result limit is applied. The
result is empty when no orders match.
Show child attributes
Show child attributes