curl -sS \
-H "Authorization: Bearer $OXINSIDER_API_KEY" \
'https://api.0xinsider.com/api/v1/trader/{address}'import requests
url = "https://api.0xinsider.com/api/v1/trader/{address}"
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/trader/{address}', 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/trader/{address}",
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/trader/{address}"
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/trader/{address}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.0xinsider.com/api/v1/trader/{address}")
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": "trader",
"data": {
"id": "trd_0xabc1230000000000000000000000000000000abc",
"address": "0xabc1230000000000000000000000000000000abc",
"username": "example_trader",
"grade": "D",
"score": 40.17,
"forecast_score": 46.2,
"forecast_evidence": 0.38,
"streak_tier": "neutral",
"pnl": {
"unrealized": 135.56,
"in_scope": {
"basis": "polymarket_sports_esports_v1",
"realized_pnl": -1204.37,
"markets": 412,
"markets_resolved": 398,
"win_rate": 0.5812,
"markets_out_of_scope": 1477,
"as_of": "2026-09-10T04:18:02.551204Z"
}
},
"stats": {
"markets_traded": 412,
"win_rate": 0.5812,
"total_volume": 48210.55,
"exact": {
"total_volume": {
"value": "48210.551203",
"unit": "USD",
"scale": 6,
"basis": "trader_trade_daily_rollups.in_scope_volume_total (sum over every stored trade day; sports and esports markets)"
}
}
},
"strategy": {
"strategy_type": "mixed",
"description": "Mixed activity across 1,802 stored markets. No single observed behavior has a clear lead. Category shares describe recorded USD cost basis; style is separate from performance."
},
"last_active": "2026-09-09T21:47:12Z",
"synced_at": "2026-09-10T02:04:30.398422Z",
"sync_status": "synced",
"data_quality": {
"status": "partial",
"as_of": "2026-09-10T02:04:30.398422Z",
"field_groups": [
{
"group": "sync",
"owner": "traders.last_synced",
"status": "fresh",
"as_of": "2026-09-10T02:04:30.398422Z",
"max_age_s": 604800
},
{
"group": "sports_record",
"owner": "trader_product_scope_records.computed_at",
"status": "fresh",
"as_of": "2026-09-10T04:18:02.551204Z"
},
{
"group": "ranking",
"owner": "trader_rankings.computed_at",
"status": "fresh",
"as_of": "2026-09-10T06:12:44.120031Z",
"max_age_s": 604800
},
{
"group": "leaderboard_rank",
"owner": "leaderboard_rank_refresh_state.completed_at",
"status": "untracked",
"reason": "only S, A and B wallets are given a leaderboard rank"
},
{
"group": "volume",
"owner": "traders.last_synced",
"status": "fresh",
"as_of": "2026-09-10T02:04:30.398422Z",
"max_age_s": 604800
},
{
"group": "positions",
"owner": "trader_position_snapshots.last_refreshed_at|traders.last_synced",
"status": "unknown",
"reason": "open-position unrealized P&L is served, but no successful position snapshot or sync clock is available"
}
]
}
},
"meta": {
"request_id": "req_example",
"cached": false,
"cost": 1
}
}{
"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>"
}
}{
"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>"
}
}Trader
Get a wallet’s grade, profit and loss, win rate, and rank, with optional detail.
curl -sS \
-H "Authorization: Bearer $OXINSIDER_API_KEY" \
'https://api.0xinsider.com/api/v1/trader/{address}'import requests
url = "https://api.0xinsider.com/api/v1/trader/{address}"
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/trader/{address}', 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/trader/{address}",
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/trader/{address}"
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/trader/{address}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.0xinsider.com/api/v1/trader/{address}")
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": "trader",
"data": {
"id": "trd_0xabc1230000000000000000000000000000000abc",
"address": "0xabc1230000000000000000000000000000000abc",
"username": "example_trader",
"grade": "D",
"score": 40.17,
"forecast_score": 46.2,
"forecast_evidence": 0.38,
"streak_tier": "neutral",
"pnl": {
"unrealized": 135.56,
"in_scope": {
"basis": "polymarket_sports_esports_v1",
"realized_pnl": -1204.37,
"markets": 412,
"markets_resolved": 398,
"win_rate": 0.5812,
"markets_out_of_scope": 1477,
"as_of": "2026-09-10T04:18:02.551204Z"
}
},
"stats": {
"markets_traded": 412,
"win_rate": 0.5812,
"total_volume": 48210.55,
"exact": {
"total_volume": {
"value": "48210.551203",
"unit": "USD",
"scale": 6,
"basis": "trader_trade_daily_rollups.in_scope_volume_total (sum over every stored trade day; sports and esports markets)"
}
}
},
"strategy": {
"strategy_type": "mixed",
"description": "Mixed activity across 1,802 stored markets. No single observed behavior has a clear lead. Category shares describe recorded USD cost basis; style is separate from performance."
},
"last_active": "2026-09-09T21:47:12Z",
"synced_at": "2026-09-10T02:04:30.398422Z",
"sync_status": "synced",
"data_quality": {
"status": "partial",
"as_of": "2026-09-10T02:04:30.398422Z",
"field_groups": [
{
"group": "sync",
"owner": "traders.last_synced",
"status": "fresh",
"as_of": "2026-09-10T02:04:30.398422Z",
"max_age_s": 604800
},
{
"group": "sports_record",
"owner": "trader_product_scope_records.computed_at",
"status": "fresh",
"as_of": "2026-09-10T04:18:02.551204Z"
},
{
"group": "ranking",
"owner": "trader_rankings.computed_at",
"status": "fresh",
"as_of": "2026-09-10T06:12:44.120031Z",
"max_age_s": 604800
},
{
"group": "leaderboard_rank",
"owner": "leaderboard_rank_refresh_state.completed_at",
"status": "untracked",
"reason": "only S, A and B wallets are given a leaderboard rank"
},
{
"group": "volume",
"owner": "traders.last_synced",
"status": "fresh",
"as_of": "2026-09-10T02:04:30.398422Z",
"max_age_s": 604800
},
{
"group": "positions",
"owner": "trader_position_snapshots.last_refreshed_at|traders.last_synced",
"status": "unknown",
"reason": "open-position unrealized P&L is served, but no successful position snapshot or sync clock is available"
}
]
}
},
"meta": {
"request_id": "req_example",
"cached": false,
"cost": 1
}
}{
"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>"
}
}{
"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>"
}
}breakdowns.
Parameters
| Parameter | Description |
|---|---|
address | The wallet to look up: a 0x... address, a Polymarket username, or a trd_ id. All three return the same profile. |
expand | Adds optional fields: strategy, categories, breakdowns, or trust. quant_metrics is still accepted and returns nothing since October 27, 2026. Repeat the parameter once per value, as in expand=strategy&expand=categories. expand[] works the same way. |
Key response fields
| Field | Meaning |
|---|---|
grade | S (best) to F. A grade ranks the wallet’s realized profit on settled sports and esports markets against other graded wallets. Win rate, forecasting edge, record length, drawdown and consistency count too, so a smaller earner with a stronger record can rank above a bigger one. A wallet needs verified positive realized profit on those markets to grade above C. The field is absent when the wallet has no grade yet. See Grades. |
streak_tier | How the wallet’s last 7 days compare with other wallets: hot, rising, neutral, cooling, or cold. It is separate from the grade. The field is absent when the wallet has no recent activity. |
pnl.in_scope | The wallet’s sports and esports record, the profit and loss the 0xinsider profile shows. realized_pnl is profit and loss on settled sports and esports markets, with maker and taker rebates and 0xinsider’s correction for misbooked neg-risk conversions included, and is null until that figure is published. markets, markets_resolved, and win_rate count the same markets, and markets_out_of_scope counts the wallet’s other Polymarket markets, which 0xinsider does not count. The object is absent until the record is computed. Absent does not mean zero. It is also absent for a wallet that traded no sports or esports market, which never gets a record; stats.markets_traded is then 0. It is absent for a wallet that trades only combos too: the record counts single markets, so such a wallet has none. |
pnl.correction_pending | Present, and true, only while 0xinsider is still checking some of the wallet’s converted neg-risk markets that have a sports or esports event. Until the check finishes, pnl.in_scope.realized_pnl can still change. Omitted otherwise. |
pnl.unrealized | The current value of the wallet’s open sports and esports positions minus what they cost: Polymarket’s cashPnl, summed over the positions still held. It is the same figure as position_summary.unrealized_mtm on Trader context. Profit from selling part of a position that is still open is realized, so it is in pnl.in_scope.realized_pnl and not here. A wallet with no sports or esports market can still count older positions of other categories until 0xinsider deletes them. Omitted when the open-position read is unavailable. |
pnl.total, pnl.net_total, pnl.realized, pnl.correction, pnl.exact | Deprecated on October 27, 2026 and never sent. They covered every Polymarket market of the wallet, and wallet figures now cover sports and esports markets only. Read pnl.in_scope.realized_pnl. |
pnl.last_7d, pnl.last_30d | Deprecated. Never sent. |
stats.markets_traded | The number of sports and esports markets the wallet traded, from the same record as pnl.in_scope. Omitted until the record is computed. 0 for a wallet that traded no sports or esports market. At its last completed sync, either Polymarket counted no market for it, or 0xinsider read its Polymarket positions and found no sports or esports market. 0xinsider stores none of its markets, and no Polymarket sports or esports board lists it. Omitted for a wallet that trades only combos, which has no record. |
stats.win_rate | The share of the wallet’s decided sports and esports markets that it won, from 0 to 1. Omitted until one of its markets is decided. |
stats.total_volume | Everything the wallet has bought and sold on sports and esports markets, in USD, over every trading day 0xinsider has stored. A synced wallet with no stored trading day reads 0. Omitted before the wallet’s first completed sync, and while a stored day has not been computed yet. |
stats.exact.total_volume | The same volume as a full-precision decimal atom. Read value with decimal-safe arithmetic; unit, scale, and basis describe its source. Omitted with stats.total_volume. |
price_edge | The wallet’s edge over the price it paid, the number on the profile’s Edge badge: markets, hit_rate, avg_price, edge and status, the same figures as price_edge on Leaderboard. edge is hit_rate minus avg_price, as a probability, so 0.012 is 1.2 percentage points. When status is ranked (30 or more settled sports or esports markets of $20 or more), shrunk_edge is the edge the badge shows and the leaderboard ranks: edge pulled toward field_average, the mean edge of ranked wallets, by how short the record is. Left out when the wallet has no such market. |
breakdowns | Returned with expand=breakdowns. The profile’s strategy measures over the wallet’s sports and esports markets, computed when you ask, so a wallet with a long history can take a few seconds. See Strategy breakdowns. |
stats.daily_win_rate | Deprecated on October 27, 2026 and never sent. It counted days over every Polymarket market of the wallet. For winning and losing sports and esports days, read stats.all.win_days and stats.all.loss_days from Trader P&L. |
quant_metrics | Retired on October 27, 2026 and never returned. It covered every market of the wallet; wallet figures now cover sports and esports markets only. Read pnl.in_scope for the wallet’s sports and esports record. |
category_records | Returned with expand=categories. One record per sports or esports category the wallet traded, including categories with too few markets to grade. A category outside sports and esports has no record. |
strategy.strategy_type | Returned with expand=strategy when classified. Describes stored activity, independently of profit or grade. unclassified means limited usable history; historical IDs can remain until reclassification. See Wallet trading styles. |
last_active | When the wallet last traded: the time of its most recent trade 0xinsider has recorded. It matches last_active on Leaderboard, which refreshes hourly. A cached response can be up to 60 seconds behind a new trade. Left out when 0xinsider has recorded no trade for the wallet. |
synced_at | When 0xinsider last finished syncing the wallet. It is not when the wallet traded; read last_active for that. |
data_quality | The age and availability of the profile’s field groups. Always sent. See Data age. |
category_strengths | Returned with expand=categories. The wallet’s rank in each sports and esports category, counted only on positions over $20, including markets the wallet bought on both sides. For the plain win-loss record per category, use Trader category records. |
category_numbers | Returned with expand=categories. Whether category_strengths and category_records include the wallet’s latest settlements. state is current, behind or unknown. behind: an update for the wallet has waited over an hour, and as_of is when the oldest waiting one was queued. unknown: 0xinsider’s check has no recent result, so treat the figures as unverified, not current. as_of is null unless state is behind. |
Strategy breakdowns
expand=breakdowns returns the measures behind the wallet profile’s Insights tab, over the wallet’s sports and esports markets. They are computed from the wallet’s whole history on each request and are not cached, so a wallet with tens of thousands of markets can take several seconds. If the read cannot finish within 30 seconds, the response is 503 with Retry-After.
| Field | Meaning |
|---|---|
hourly_performance | One entry per UTC hour (0-23) of the wallet’s first trade in each settled market: markets, wins, win_rate as a percentage from 0 to 100, total_pnl, and avg_pnl. An hour with no decided market reads a win_rate of 0, so read it with wins and markets. best_hour, worst_hour, their win rates, and spread_pp (the gap in percentage points) are null when no hour has a settled market. |
time_breakdowns.by_duration | Results by the time from the wallet’s first to its last trade in a market, in bands from < 1h to > 4w: n_markets, win_rate from 0 to 1, expectancy (average P&L per market), profit_factor (gross profit over gross loss), and total_pnl. |
time_breakdowns.by_hour_bucket | The same results by the four-hour UTC band of the wallet’s first trade in a market, 00-03 to 20-23. insights holds a one-line summary per breakdown when there is one. |
risk_metrics | Position sizes in USD (avg_position_size, median_position_size, max_position_size, position_size_stddev), total_positions, large_position_count (positions over twice the average), and concentration, the Herfindahl index of the wallet’s volume across sports and esports categories, where 1.0 is a single category. null when the wallet has no position with trades. |
entry_price_analysis | Results by the entry price of the side the wallet held, in five bands from $0.00-$0.19 to $0.80-$0.99: markets, wins, win_rate from 0 to 100, total_pnl, and avg_pnl. best_bucket and worst_bucket name the bands with the highest and lowest win rate among bands of at least 3 markets. coverage counts the settled positions the bands leave out: unbucketed gives markets and total_pnl for each reason, such as two_sided for a position that bought both outcomes, and the bands plus unbucketed add up to settled_markets. settled_pnl adds up per-market realized P&L, so it differs from pnl.in_scope.realized_pnl. |
state with value: read state first. not_computed means an input such as a position’s cost is unknown, and no value is sent rather than a zero.
Data age
Different profile fields update at different times.data_quality reports each group’s age and status, so you can decide whether the values are recent enough for your use.
data_quality.status is fresh when every group is fresh, unavailable when every group is unavailable, stale when every group is fresh or stale and at least one is stale, and partial otherwise. data_quality.as_of is the oldest supporting timestamp.
Each entry in data_quality.field_groups carries group, owner (the table and column that writes it), status, an as_of where one exists, max_age_s where its writer refreshes on a schedule, and a reason where the status is not fresh.
max_age_s is the longest gap in seconds that the writer’s schedule leaves between refreshes. A group is stale when its as_of is older than that: the writer has missed a refresh it promises. sync, ranking, volume and positions carry 604800 (7 days, the longest gap between full syncs) and leaderboard_rank carries 22620. sports_record carries none: its timestamp moves only when the record changes, so it is never stale. Neither status is an age limit for your use; compare as_of with your own.
| Group | Covers | Clock |
|---|---|---|
sync | synced_at, sync_status | When the wallet was last synced. |
sports_record | pnl.in_scope, stats.markets_traded, stats.win_rate | When the wallet’s sports and esports record was last computed. partial when none of its sports or esports markets is decided yet, so stats.win_rate is absent. For a wallet that traded no sports or esports market, partial with owner traders.last_synced, dated by the sync that found none. For a wallet that trades only combos and holds no single sports or esports market, partial with owner traders.last_synced and a reason that says so. |
ranking | grade, score, streak_tier, forecast_score, forecast_evidence | When the wallet was last ranked. This is a different job from the sync, so the two times differ. |
leaderboard_rank | rank | The completion time of the latest global rank refresh that finished for every candidate. Until the first completed refresh on this schema, a served rank remains unknown. |
volume | stats.total_volume | When the wallet was last synced. unavailable before the first completed sync, or while a stored trading day has not been computed. |
positions | pnl.unrealized | The latest successful /positions snapshot, or the last completed sync when no position snapshot exists. This dates the open-position aggregate only. |
last_active belongs to no group, because the value is itself the time of a trade.
unknown means the value is present but has no reliable timestamp. Do not use another group’s as_of to estimate its age. untracked means that group is not tracked for the wallet; for example, only S, A, and B wallets get a leaderboard rank.
data_quality uses stored timestamps for the underlying values, and a cached response is judged again when it is served. meta.cached and meta.cache_age_s describe the response cache separately.
For the per-field version of the same question, including where each number comes from and how it was reconciled, request expand=trust.
Example
curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
"https://api.0xinsider.com/api/v1/trader/swisstony?expand=strategy&expand=categories"
What it does not return
- A
404for a wallet 0xinsider does not track yet. You get a200withsync_statusset tounknown. Request it again later. strategybefore 0xinsider has classified the wallet. The field is omitted until then.- P&L for the last week or month.
pnl.last_7dandpnl.last_30dare deprecated and never sent. - Open positions. Use Trader context.
Caching
Save the response’sETag and send it in If-None-Match on your next request. If the profile 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
Include heavy fields and trust metadata. Repeatable: strategy, categories, trust, breakdowns. breakdowns adds the profile's strategy measures (Trader.breakdowns), computed on the read, and is served on this route only. quant_metrics is accepted and returns nothing since 2026-10-27.
strategy, categories, quant_metrics, trust, breakdowns Opt into a whole-response freshness ceiling in seconds. The server returns 200 only when data_quality.status is fresh or stale and data_quality.as_of is no older than this value; otherwise it returns 409 with error.reason=freshness_ceiling_unsatisfied. No refresh or alternate read is attempted.
x >= 0Was this page helpful?