All Market Holder
curl --request POST \
--url https://api.example.com/api/v1/market-holders/all \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"page": {
"limit": 2,
"offset": 1
},
"filter": [
{
"value": 123
}
],
"orderBy": [
{
"direction": "asc"
}
]
}
'import requests
url = "https://api.example.com/api/v1/market-holders/all"
payload = {
"page": {
"limit": 2,
"offset": 1
},
"filter": [{ "value": 123 }],
"orderBy": [{ "direction": "asc" }]
}
headers = {
"X-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
page: {limit: 2, offset: 1},
filter: [{value: 123}],
orderBy: [{direction: 'asc'}]
})
};
fetch('https://api.example.com/api/v1/market-holders/all', 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.example.com/api/v1/market-holders/all",
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([
'page' => [
'limit' => 2,
'offset' => 1
],
'filter' => [
[
'value' => 123
]
],
'orderBy' => [
[
'direction' => 'asc'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v1/market-holders/all"
payload := strings.NewReader("{\n \"page\": {\n \"limit\": 2,\n \"offset\": 1\n },\n \"filter\": [\n {\n \"value\": 123\n }\n ],\n \"orderBy\": [\n {\n \"direction\": \"asc\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Api-Key", "<api-key>")
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.example.com/api/v1/market-holders/all")
.header("X-Api-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"page\": {\n \"limit\": 2,\n \"offset\": 1\n },\n \"filter\": [\n {\n \"value\": 123\n }\n ],\n \"orderBy\": [\n {\n \"direction\": \"asc\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/market-holders/all")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"page\": {\n \"limit\": 2,\n \"offset\": 1\n },\n \"filter\": [\n {\n \"value\": 123\n }\n ],\n \"orderBy\": [\n {\n \"direction\": \"asc\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body[
{
"currentValue": 123,
"invested": 123,
"outcomes": 123,
"pnlPercentage": 123,
"tokenMetadata": [
{
"avgBuyingPrice": "<string>",
"invested": "<string>",
"isYesToken": "<string>",
"marketClosed": "<string>",
"marketId": "<string>",
"pnlPercentage": "<string>",
"tokenName": "<string>",
"totalPnl": "<string>",
"total_bought_shares": "<string>",
"unrealizedPnl": "<string>",
"volume": "<string>"
}
],
"totalPnl": 123,
"unrealizedPnl": 123,
"userId": "<string>",
"volume": 123
}
]{
"code": "<string>",
"message": "<string>"
}{
"code": "<string>",
"message": "<string>"
}{
"code": "<string>",
"message": "<string>"
}{
"code": "<string>",
"message": "<string>"
}Holders
All Market Holder
User-level holders across all markets, with nested token details.
POST
/
api
/
v1
/
market-holders
/
all
All Market Holder
curl --request POST \
--url https://api.example.com/api/v1/market-holders/all \
--header 'Content-Type: application/json' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"page": {
"limit": 2,
"offset": 1
},
"filter": [
{
"value": 123
}
],
"orderBy": [
{
"direction": "asc"
}
]
}
'import requests
url = "https://api.example.com/api/v1/market-holders/all"
payload = {
"page": {
"limit": 2,
"offset": 1
},
"filter": [{ "value": 123 }],
"orderBy": [{ "direction": "asc" }]
}
headers = {
"X-Api-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Api-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
page: {limit: 2, offset: 1},
filter: [{value: 123}],
orderBy: [{direction: 'asc'}]
})
};
fetch('https://api.example.com/api/v1/market-holders/all', 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.example.com/api/v1/market-holders/all",
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([
'page' => [
'limit' => 2,
'offset' => 1
],
'filter' => [
[
'value' => 123
]
],
'orderBy' => [
[
'direction' => 'asc'
]
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"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"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v1/market-holders/all"
payload := strings.NewReader("{\n \"page\": {\n \"limit\": 2,\n \"offset\": 1\n },\n \"filter\": [\n {\n \"value\": 123\n }\n ],\n \"orderBy\": [\n {\n \"direction\": \"asc\"\n }\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Api-Key", "<api-key>")
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.example.com/api/v1/market-holders/all")
.header("X-Api-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"page\": {\n \"limit\": 2,\n \"offset\": 1\n },\n \"filter\": [\n {\n \"value\": 123\n }\n ],\n \"orderBy\": [\n {\n \"direction\": \"asc\"\n }\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/market-holders/all")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Api-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"page\": {\n \"limit\": 2,\n \"offset\": 1\n },\n \"filter\": [\n {\n \"value\": 123\n }\n ],\n \"orderBy\": [\n {\n \"direction\": \"asc\"\n }\n ]\n}"
response = http.request(request)
puts response.read_body[
{
"currentValue": 123,
"invested": 123,
"outcomes": 123,
"pnlPercentage": 123,
"tokenMetadata": [
{
"avgBuyingPrice": "<string>",
"invested": "<string>",
"isYesToken": "<string>",
"marketClosed": "<string>",
"marketId": "<string>",
"pnlPercentage": "<string>",
"tokenName": "<string>",
"totalPnl": "<string>",
"total_bought_shares": "<string>",
"unrealizedPnl": "<string>",
"volume": "<string>"
}
],
"totalPnl": 123,
"unrealizedPnl": 123,
"userId": "<string>",
"volume": 123
}
]{
"code": "<string>",
"message": "<string>"
}{
"code": "<string>",
"message": "<string>"
}{
"code": "<string>",
"message": "<string>"
}{
"code": "<string>",
"message": "<string>"
}Authorizations
ApiKeyAuthBearerAuth
API key issued for programmatic access.
Body
application/json
Show child attributes
Show child attributes
Filters to apply, combined with AND. Use a group for OR.
Minimum array length:
1A single condition, or a group combining conditions with AND/OR.
- Option 1
- Option 2
- Option 3
- Option 4
Show child attributes
Show child attributes
Sort keys in priority order; the first is the primary sort. Defaults to the table's configured ranking when omitted.
Show child attributes
Show child attributes
Response
List of All Market Holder rows
current invested value
Total invested
Number of distinct token outcomes
Total PnL as percentage of invested
Nested token-level position details as JSON
Show child attributes
Show child attributes
Total PNL
Total unrealized PnL
User wallet address
Total trading volume
⌘I