curl -sS \
-H "Authorization: Bearer $OXINSIDER_API_KEY" \
'https://api.0xinsider.com/api/v1/market/{condition_id}/top-holders?limit=100'import requests
url = "https://api.0xinsider.com/api/v1/market/{condition_id}/top-holders"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.0xinsider.com/api/v1/market/{condition_id}/top-holders', 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.0xinsider.com/api/v1/market/{condition_id}/top-holders",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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.0xinsider.com/api/v1/market/{condition_id}/top-holders"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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.0xinsider.com/api/v1/market/{condition_id}/top-holders")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.0xinsider.com/api/v1/market/{condition_id}/top-holders")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"object": "market_top_holders",
"data": {
"market": {
"id": "<string>",
"condition_id": "<string>",
"title": "<string>",
"category": "<string>",
"outcome_yes": "<string>",
"outcome_no": "<string>",
"token_id_yes": "<string>",
"token_id_no": "<string>",
"status": "open",
"protocol_version": "v1",
"slug": "<string>",
"event_slug": "<string>",
"end_date": "2023-11-07T05:31:56Z"
},
"yes": [
{
"rank": 2,
"trader_id": "<string>",
"address": "<string>",
"name": "<string>",
"grade": "S",
"shares": 123,
"current_value_usd": 123,
"avg_entry_price": 0.5,
"position_realized_pnl": 123,
"position_unrealized_pnl": 123,
"position_total_pnl": 123,
"in_scope_realized_pnl": 123,
"in_scope_volume": 123,
"strategy_type": "<string>",
"last_traded_at": "2023-11-07T05:31:56Z",
"other_outcome_shares": 123,
"category_win_rate": 0.5,
"category_win_record": {
"wins": 1,
"decided": 1
},
"category_avg_price": 0.5,
"category_win_rate_game": "<string>",
"category_win_rate_status": "measured",
"category_price_edge": {
"markets": 123,
"hit_rate": 123,
"avg_price": 123,
"edge": 123,
"every_size": true
},
"category_scope_price_edge": {
"markets": 123,
"hit_rate": 123,
"avg_price": 123,
"edge": 123,
"every_size": true
},
"category_price_edge_hold": {
"hold": "category_loss",
"record": {
"markets": 123,
"hit_rate": 123,
"avg_price": 123,
"edge": 123,
"every_size": true
}
},
"category_scope_price_edge_hold": {
"hold": "category_loss",
"record": {
"markets": 123,
"hit_rate": 123,
"avg_price": 123,
"edge": 123,
"every_size": true
}
},
"wallet_age_days": 123,
"is_new_wallet": true,
"markets_traded": 123,
"is_bot": true,
"x_username": "<string>",
"category_records_as_of": "2023-11-07T05:31:56Z"
}
],
"no": [
{
"rank": 2,
"trader_id": "<string>",
"address": "<string>",
"name": "<string>",
"grade": "S",
"shares": 123,
"current_value_usd": 123,
"avg_entry_price": 0.5,
"position_realized_pnl": 123,
"position_unrealized_pnl": 123,
"position_total_pnl": 123,
"in_scope_realized_pnl": 123,
"in_scope_volume": 123,
"strategy_type": "<string>",
"last_traded_at": "2023-11-07T05:31:56Z",
"other_outcome_shares": 123,
"category_win_rate": 0.5,
"category_win_record": {
"wins": 1,
"decided": 1
},
"category_avg_price": 0.5,
"category_win_rate_game": "<string>",
"category_win_rate_status": "measured",
"category_price_edge": {
"markets": 123,
"hit_rate": 123,
"avg_price": 123,
"edge": 123,
"every_size": true
},
"category_scope_price_edge": {
"markets": 123,
"hit_rate": 123,
"avg_price": 123,
"edge": 123,
"every_size": true
},
"category_price_edge_hold": {
"hold": "category_loss",
"record": {
"markets": 123,
"hit_rate": 123,
"avg_price": 123,
"edge": 123,
"every_size": true
}
},
"category_scope_price_edge_hold": {
"hold": "category_loss",
"record": {
"markets": 123,
"hit_rate": 123,
"avg_price": 123,
"edge": 123,
"every_size": true
}
},
"wallet_age_days": 123,
"is_new_wallet": true,
"markets_traded": 123,
"is_bot": true,
"x_username": "<string>",
"category_records_as_of": "2023-11-07T05:31:56Z"
}
],
"totals": {
"yes_count": 1,
"no_count": 1,
"yes_shares": 123,
"no_shares": 123,
"sample_cap": 1
},
"profiles_status": "available",
"source_stale": true,
"category_records_as_of": "2023-11-07T05:31:56Z",
"computed_at": "2023-11-07T05:31:56Z",
"positions_as_of": "2023-11-07T05:31:56Z"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"continued_from_generation": 123,
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"billing_url": "<string>",
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"continued_from_generation": 123,
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"billing_url": "<string>",
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"continued_from_generation": 123,
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"billing_url": "<string>",
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"continued_from_generation": 123,
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"billing_url": "<string>",
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"continued_from_generation": 123,
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"billing_url": "<string>",
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"continued_from_generation": 123,
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"billing_url": "<string>",
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"continued_from_generation": 123,
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"billing_url": "<string>",
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"continued_from_generation": 123,
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"billing_url": "<string>",
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"continued_from_generation": 123,
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"billing_url": "<string>",
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"continued_from_generation": 123,
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}Market top holders
List the largest holders on each side of a market, every grade and ungraded wallets included.
curl -sS \
-H "Authorization: Bearer $OXINSIDER_API_KEY" \
'https://api.0xinsider.com/api/v1/market/{condition_id}/top-holders?limit=100'import requests
url = "https://api.0xinsider.com/api/v1/market/{condition_id}/top-holders"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.0xinsider.com/api/v1/market/{condition_id}/top-holders', 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.0xinsider.com/api/v1/market/{condition_id}/top-holders",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$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.0xinsider.com/api/v1/market/{condition_id}/top-holders"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
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.0xinsider.com/api/v1/market/{condition_id}/top-holders")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.0xinsider.com/api/v1/market/{condition_id}/top-holders")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"object": "market_top_holders",
"data": {
"market": {
"id": "<string>",
"condition_id": "<string>",
"title": "<string>",
"category": "<string>",
"outcome_yes": "<string>",
"outcome_no": "<string>",
"token_id_yes": "<string>",
"token_id_no": "<string>",
"status": "open",
"protocol_version": "v1",
"slug": "<string>",
"event_slug": "<string>",
"end_date": "2023-11-07T05:31:56Z"
},
"yes": [
{
"rank": 2,
"trader_id": "<string>",
"address": "<string>",
"name": "<string>",
"grade": "S",
"shares": 123,
"current_value_usd": 123,
"avg_entry_price": 0.5,
"position_realized_pnl": 123,
"position_unrealized_pnl": 123,
"position_total_pnl": 123,
"in_scope_realized_pnl": 123,
"in_scope_volume": 123,
"strategy_type": "<string>",
"last_traded_at": "2023-11-07T05:31:56Z",
"other_outcome_shares": 123,
"category_win_rate": 0.5,
"category_win_record": {
"wins": 1,
"decided": 1
},
"category_avg_price": 0.5,
"category_win_rate_game": "<string>",
"category_win_rate_status": "measured",
"category_price_edge": {
"markets": 123,
"hit_rate": 123,
"avg_price": 123,
"edge": 123,
"every_size": true
},
"category_scope_price_edge": {
"markets": 123,
"hit_rate": 123,
"avg_price": 123,
"edge": 123,
"every_size": true
},
"category_price_edge_hold": {
"hold": "category_loss",
"record": {
"markets": 123,
"hit_rate": 123,
"avg_price": 123,
"edge": 123,
"every_size": true
}
},
"category_scope_price_edge_hold": {
"hold": "category_loss",
"record": {
"markets": 123,
"hit_rate": 123,
"avg_price": 123,
"edge": 123,
"every_size": true
}
},
"wallet_age_days": 123,
"is_new_wallet": true,
"markets_traded": 123,
"is_bot": true,
"x_username": "<string>",
"category_records_as_of": "2023-11-07T05:31:56Z"
}
],
"no": [
{
"rank": 2,
"trader_id": "<string>",
"address": "<string>",
"name": "<string>",
"grade": "S",
"shares": 123,
"current_value_usd": 123,
"avg_entry_price": 0.5,
"position_realized_pnl": 123,
"position_unrealized_pnl": 123,
"position_total_pnl": 123,
"in_scope_realized_pnl": 123,
"in_scope_volume": 123,
"strategy_type": "<string>",
"last_traded_at": "2023-11-07T05:31:56Z",
"other_outcome_shares": 123,
"category_win_rate": 0.5,
"category_win_record": {
"wins": 1,
"decided": 1
},
"category_avg_price": 0.5,
"category_win_rate_game": "<string>",
"category_win_rate_status": "measured",
"category_price_edge": {
"markets": 123,
"hit_rate": 123,
"avg_price": 123,
"edge": 123,
"every_size": true
},
"category_scope_price_edge": {
"markets": 123,
"hit_rate": 123,
"avg_price": 123,
"edge": 123,
"every_size": true
},
"category_price_edge_hold": {
"hold": "category_loss",
"record": {
"markets": 123,
"hit_rate": 123,
"avg_price": 123,
"edge": 123,
"every_size": true
}
},
"category_scope_price_edge_hold": {
"hold": "category_loss",
"record": {
"markets": 123,
"hit_rate": 123,
"avg_price": 123,
"edge": 123,
"every_size": true
}
},
"wallet_age_days": 123,
"is_new_wallet": true,
"markets_traded": 123,
"is_bot": true,
"x_username": "<string>",
"category_records_as_of": "2023-11-07T05:31:56Z"
}
],
"totals": {
"yes_count": 1,
"no_count": 1,
"yes_shares": 123,
"no_shares": 123,
"sample_cap": 1
},
"profiles_status": "available",
"source_stale": true,
"category_records_as_of": "2023-11-07T05:31:56Z",
"computed_at": "2023-11-07T05:31:56Z",
"positions_as_of": "2023-11-07T05:31:56Z"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"continued_from_generation": 123,
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"billing_url": "<string>",
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"continued_from_generation": 123,
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"billing_url": "<string>",
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"continued_from_generation": 123,
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"billing_url": "<string>",
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"continued_from_generation": 123,
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"billing_url": "<string>",
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"continued_from_generation": 123,
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"billing_url": "<string>",
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"continued_from_generation": 123,
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"billing_url": "<string>",
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"continued_from_generation": 123,
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"billing_url": "<string>",
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"continued_from_generation": 123,
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"billing_url": "<string>",
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"continued_from_generation": 123,
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}{
"object": "error",
"error": {
"code": "bad_request",
"message": "<string>",
"doc_url": "<string>",
"param": "<string>",
"retry_at": "2023-11-07T05:31:56Z",
"freshness": {
"max_age_s": 1,
"data_quality_status": "fresh",
"actual_age_s": 1,
"as_of": "2023-11-07T05:31:56Z"
},
"billing_url": "<string>",
"reason": "cursor_expired"
},
"meta": {
"request_id": "<string>",
"cached": true,
"cost": 123,
"cache_age_s": 123,
"ranking_generation": 123,
"ranking_as_of": "2023-11-07T05:31:56Z",
"continued_from_generation": 123,
"directional_source": "live",
"ranking_source": "live",
"category_skill_source": "live",
"category_skill_model_version": "<string>",
"category_skill_taxonomy_version": "<string>",
"category_skill_platform": "polymarket",
"category_skill_scope": "observed_goldsky_primary_taker_fill",
"category_skill_source_coverage": "partial_whale_threshold_fills",
"category_skill_observation_started_at": "2023-11-07T05:31:56Z",
"category_skill_model_operationally_degraded": true,
"category_skill_status_counts": {
"live": 1,
"insufficient": 1,
"stale": 1,
"unknown": 1,
"degraded": 1
},
"category_skill_base_payload_hash": "<string>",
"category_skill_enriched_base_payload_hash": "<string>"
}
}shares first, the same table the market’s event page shows under Top holders.
For every S, A, and B wallet holding the market, from a complete Polymarket scan with exact counts, use Market holders.
Parameters
| Parameter | Description |
|---|---|
condition_id | Polymarket’s own id for the market, or the market’s mkt_ id. |
limit | How many holders per side, from 1 to 100. The default is 20, and a value outside the range is clamped rather than refused. totals covers every holder in the sample whatever the limit. |
Key response fields
| Field | Meaning |
|---|---|
data.yes, data.no | The largest holders on each side, by shares. A wallet holding both sides is listed on each, with other_outcome_shares set. |
rank | The holder’s position on its side, from 1. |
grade | The wallet’s grade, S to F. It is null for a wallet 0xinsider has not graded. |
current_value_usd | What Polymarket says this position is worth right now, in USD. |
avg_entry_price | The average price paid for the shares still held, from 0 to 1 (0.62 is 62 cents). |
position_realized_pnl, position_unrealized_pnl, position_total_pnl | Polymarket’s P&L for this position, in USD. On a resolved market the unrealized figure is marked at the settlement price. |
in_scope_realized_pnl, in_scope_volume | The wallet’s realized P&L and volume on sports and esports markets, the figures on its 0xinsider profile. They are null until 0xinsider has computed the wallet’s record, never 0 in its place. |
category_win_rate, category_win_record, category_avg_price, category_win_rate_game | The wallet’s record in market.category, the same fields Market holders returns. They are present only when category_win_rate_status is measured. |
category_price_edge, category_scope_price_edge, category_price_edge_hold, category_scope_price_edge_hold | The wallet’s edge over the price it paid, in the category and in the game or league, or why the game page shows none. They are the same fields, from the same read, that Market holders returns, so a wallet on both carries the same figures. |
category_win_rate_status | measured when the rate is present. not_enough_data when 0xinsider has the wallet on file and it has fewer than 5 decided markets in the category. untracked when 0xinsider has no record of the wallet, so nothing was measured: grade, in_scope_realized_pnl and in_scope_volume are null too. unavailable when a read failed; retry later. Absent when the market has no category. |
totals | yes_count, no_count, yes_shares and no_shares over the whole sample, and sample_cap, the most holders the sample keeps per side (100). A count equal to sample_cap means that many or more. |
market.protocol_version | The Polymarket protocol the market trades on: v1 (CTF) or v2 (Protocol V2), read from the market’s condition id, the same value GET /api/v1/markets/settled serves. On a v2 market token_id_yes and token_id_no are Protocol V2 position ids. |
profiles_status | unavailable when 0xinsider could not read the wallets’ records for this sample. in_scope_realized_pnl, in_scope_volume and strategy_type are then null on every row because they were not read. |
computed_at | When the sample was built. meta.cache_age_s says how old it is. It is absent when profiles_status is unavailable: that sample is built for your request and not kept. |
positions_as_of | When 0xinsider last fetched Polymarket’s holder board, the source of every row’s position. It is up to 120 seconds before computed_at on an open market. It is absent on a resolved market, whose sample reads no live board, and when the fetch time could not be read. |
source_stale | true when this is the market’s last sample, sent after its 30 seconds were up while a new one builds. positions_as_of is then at most 300 seconds old. It is always false on a resolved market. |
Freshness
The sample is shared with the event page and every caller. On an open market it is rebuilt at most every 30 seconds from Polymarket’s holder board, which 0xinsider re-reads at most every 120 seconds, so a position is usually up to about 150 seconds old.positions_as_of says when the board was fetched, computed_at when the sample was built, and meta.cache_age_s how old the response is. On a resolved market the sample is at most 300 seconds old and carries no positions_as_of.
When a request arrives after the 30 seconds are up, you get the market’s last sample with source_stale: true right away, and 0xinsider starts building a new one. That happens only while the sample’s holder board is at most 300 seconds old. Request again a few seconds later for the new sample. Otherwise, for example on a market nobody has requested in the last few minutes, the request waits for the build, which can take a second or two.
Example
curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
"https://api.0xinsider.com/api/v1/market/0x123.../top-holders?limit=100"
What it does not return
- Every holder. Each side stops at 100 wallets, so a market with more holders shows its largest 100.
- Exact grade counts or USD by grade. Market holders has them for S, A, and B.
- An empty list in place of an error. When the holder data is busy or Polymarket’s holder read fails, the route returns
503witherror.reasonread_model_warmingand aRetry-After. - A market 0xinsider has no record of. That id returns
404, and a market outside sports and esports is refused. - Paging. There is no cursor: raise
limitto 100 for the whole sample.
Caching
Save the response’sETag and send it in If-None-Match on your next request. If the sample has not changed, the server returns 304 Not Modified with no body.Authorizations
Legacy default or named integration API key, or OAuth 2.1 access token, in the Authorization header as Bearer oxi_sk_live_... or Bearer oxi_at_.... Default keys retain full access; integration keys are limited to their approved read, webhooks, export and usage scopes and expire within 90 days. All credentials share the owner's account limits. Data calls require an active Pro subscription and return live data. A 401 carries WWW-Authenticate: Bearer resource_metadata="https://api.0xinsider.com/.well-known/oauth-protected-resource" (RFC 6750 section 3, RFC 9728).
Scopes
Headers
Opt into strict query-name validation. The default is compatible: unknown names are ignored and reported in X-Query-Ignored. With strict, an unknown name returns 400 bad_request with error.reason unknown_query_parameter before the handler runs, including when its percent escape is incomplete.
strict Path Parameters
Query Parameters
Was this page helpful?