Active Market Holder
curl --request POST \
--url https://api.example.com/api/v1/market-holders/active \
--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/active"
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/active', 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/active",
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/active"
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/active")
.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/active")
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,
"userId": "<string>"
}
]{
"code": "<string>",
"message": "<string>"
}{
"code": "<string>",
"message": "<string>"
}{
"code": "<string>",
"message": "<string>"
}{
"code": "<string>",
"message": "<string>"
}Holders
Active Market Holder
User-level holders of currently-held (active) market positions.
POST
/
api
/
v1
/
market-holders
/
active
Active Market Holder
curl --request POST \
--url https://api.example.com/api/v1/market-holders/active \
--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/active"
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/active', 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/active",
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/active"
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/active")
.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/active")
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,
"userId": "<string>"
}
]{
"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 Active Market Holder rows
current invested value
Cost basis of the currently-held shares.
Number of distinct token outcomes
Open PnL as percentage of the held cost basis
Nested token-level position details as JSON
Show child attributes
Show child attributes
Open (unrealized) PnL of the currently-held shares
User wallet address
⌘I