curl -sS \
  -H 'Authorization: Bearer $OXI_SK' \
  'https://api.0xinsider.com/api/v1/market/{condition_id}/holders?limit=100'

{
  "object": "list",
  "data": [
    {
      "id": "<string>",
      "trader_id": "<string>",
      "address": "<string>",
      "name": "<string>",
      "side": "YES",
      "token_id": "<string>",
      "grade": "S",
      "shares": 123,
      "current_value_usd": 123,
      "last_traded_at": "2023-11-07T05:31:56Z",
      "category_win_rate_status": "measured",
      "other_outcome_shares": 123,
      "category_win_rate": 0.5,
      "category_win_record": {
        "wins": 1,
        "decided": 1
      },
      "category_win_rate_game": "<string>",
      "category_evidence": {
        "status": "live",
        "canonical_category": "<string>",
        "skill": {
          "status": "live",
          "model_version": "<string>",
          "taxonomy_version": "<string>",
          "platform": "polymarket",
          "scope": "observed_goldsky_primary_taker_fill",
          "source_coverage": "partial_whale_threshold_fills",
          "canonical_category": "<string>",
          "as_of": "2023-11-07T05:31:56Z",
          "source_last_success_at": "2023-11-07T05:31:56Z",
          "observation_started_at": "2023-11-07T05:31:56Z",
          "latest_observation_at": "2023-11-07T05:31:56Z",
          "independent_event_count": 1,
          "resolved_condition_count": 1,
          "unresolved_observation_count": 1,
          "edge_mean": 123,
          "edge_sd": 123,
          "edge_se": 123,
          "edge_lower_95": 123,
          "brier_event_avg": 123
        }
      },
      "wallet_age_days": 123,
      "is_new_wallet": true,
      "markets_traded": 123,
      "is_bot": true,
      "x_username": "<string>"
    }
  ],
  "has_more": true,
  "total": 123,
  "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",
    "slug": "<string>",
    "event_slug": "<string>",
    "end_date": "2023-11-07T05:31:56Z"
  },
  "scan": {
    "source": "cached",
    "complete": true,
    "fetched_at": "2023-11-07T05:31:56Z",
    "wallet_count": 123
  },
  "totals": {
    "graded_count": 123,
    "yes_count": 123,
    "no_count": 123,
    "yes_shares": 123,
    "no_shares": 123,
    "yes_usd": 123,
    "no_usd": 123,
    "yes_grades": {
      "s": 123,
      "a": 123,
      "b": 123
    },
    "no_grades": {
      "s": 123,
      "a": 123,
      "b": 123
    }
  },
  "meta": {
    "request_id": "<string>",
    "cached": true,
    "cost": 123,
    "cache_age_s": 123,
    "ranking_generation": 123,
    "ranking_as_of": "2023-11-07T05:31:56Z",
    "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>"
  },
  "next_cursor": "<string>"
}

{
  "object": "error",
  "error": {
    "code": "bad_request",
    "message": "<string>",
    "doc_url": "<string>",
    "param": "<string>",
    "retry_at": "2023-11-07T05:31:56Z",
    "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",
    "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",
    "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",
    "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",
    "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",
    "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",
    "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",
    "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",
    "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",
    "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",
    "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",
    "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",
    "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",
    "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>"
  }
}

Markets

List a Market's Graded Holders

The graded holder roster of one market, the list a Pick of the Day shows for its market, for any Polymarket market: every S/A/B wallet with open shares on either outcome, from a complete provider holder scan, each with its shares, Polymarket’s own currentValue for the leg, its grade, its win record in the market’s category, and its badges. Both outcomes are listed; a wallet holding both is listed once on its net side. Ordered by current_value_usd DESC, then shares DESC, then address. The roster is computed at most once a minute per market and shared by every caller; a page is cut from that roster, so paging is cheap and total is exact. The route never widens past the graded cohort: scan.wallet_count reports every wallet the walk saw, graded or not. An incomplete, unstable or failed scan is a 503 with Retry-After, never a shorter list.

GET

api

market

{condition_id}

holders

curl -sS \
  -H 'Authorization: Bearer $OXI_SK' \
  'https://api.0xinsider.com/api/v1/market/{condition_id}/holders?limit=100'

{
  "object": "list",
  "data": [
    {
      "id": "<string>",
      "trader_id": "<string>",
      "address": "<string>",
      "name": "<string>",
      "side": "YES",
      "token_id": "<string>",
      "grade": "S",
      "shares": 123,
      "current_value_usd": 123,
      "last_traded_at": "2023-11-07T05:31:56Z",
      "category_win_rate_status": "measured",
      "other_outcome_shares": 123,
      "category_win_rate": 0.5,
      "category_win_record": {
        "wins": 1,
        "decided": 1
      },
      "category_win_rate_game": "<string>",
      "category_evidence": {
        "status": "live",
        "canonical_category": "<string>",
        "skill": {
          "status": "live",
          "model_version": "<string>",
          "taxonomy_version": "<string>",
          "platform": "polymarket",
          "scope": "observed_goldsky_primary_taker_fill",
          "source_coverage": "partial_whale_threshold_fills",
          "canonical_category": "<string>",
          "as_of": "2023-11-07T05:31:56Z",
          "source_last_success_at": "2023-11-07T05:31:56Z",
          "observation_started_at": "2023-11-07T05:31:56Z",
          "latest_observation_at": "2023-11-07T05:31:56Z",
          "independent_event_count": 1,
          "resolved_condition_count": 1,
          "unresolved_observation_count": 1,
          "edge_mean": 123,
          "edge_sd": 123,
          "edge_se": 123,
          "edge_lower_95": 123,
          "brier_event_avg": 123
        }
      },
      "wallet_age_days": 123,
      "is_new_wallet": true,
      "markets_traded": 123,
      "is_bot": true,
      "x_username": "<string>"
    }
  ],
  "has_more": true,
  "total": 123,
  "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",
    "slug": "<string>",
    "event_slug": "<string>",
    "end_date": "2023-11-07T05:31:56Z"
  },
  "scan": {
    "source": "cached",
    "complete": true,
    "fetched_at": "2023-11-07T05:31:56Z",
    "wallet_count": 123
  },
  "totals": {
    "graded_count": 123,
    "yes_count": 123,
    "no_count": 123,
    "yes_shares": 123,
    "no_shares": 123,
    "yes_usd": 123,
    "no_usd": 123,
    "yes_grades": {
      "s": 123,
      "a": 123,
      "b": 123
    },
    "no_grades": {
      "s": 123,
      "a": 123,
      "b": 123
    }
  },
  "meta": {
    "request_id": "<string>",
    "cached": true,
    "cost": 123,
    "cache_age_s": 123,
    "ranking_generation": 123,
    "ranking_as_of": "2023-11-07T05:31:56Z",
    "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>"
  },
  "next_cursor": "<string>"
}

{
  "object": "error",
  "error": {
    "code": "bad_request",
    "message": "<string>",
    "doc_url": "<string>",
    "param": "<string>",
    "retry_at": "2023-11-07T05:31:56Z",
    "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",
    "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",
    "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",
    "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",
    "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",
    "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",
    "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",
    "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",
    "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",
    "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",
    "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",
    "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",
    "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",
    "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>"
  }
}

The graded holder roster of any Polymarket market, the same list a Pick of the Day shows for its market: every S/A/B wallet with open shares on either outcome, from a complete provider holder scan, each with its shares, Polymarket’s own current value for the leg, its grade, its win record in the market’s category, and its badges. Use it to see who is positioned on a market before you read the trade feed.

Fields on the roster

Both outcomes are listed; a wallet holding both is listed once on its net side.
Rows are ordered by current_value_usd descending, then shares descending, then address.
scan.wallet_count reports every wallet the provider walk saw, graded or not. The route never widens past the graded cohort to fill a page.
scan.complete and scan.fetched_at describe the underlying provider walk. The roster is computed at most once a minute per market and shared by every caller, so paging is cheap and total is exact.
totals breaks the roster down by outcome and grade: yes_count, no_count, yes_usd, no_usd, yes_grades, and no_grades.

Filters

outcome keeps holders netting one side: yes, no, or all (default, both).
min_grade narrows within the graded cohort: S keeps S, A keeps S and A, B (default) keeps S, A, and B. C, D, and F are rejected with 400; the route never lists below B.
limit accepts 1 to 100 and defaults to 20. cursor pages through the shared roster and stays valid across its minute-by-minute refresh.

This route does not return ungraded wallets, even at a lower min_grade; scan.wallet_count is the only count that includes them.

curl -H "Authorization: Bearer $OXINSIDER_API_KEY" \
  "https://api.0xinsider.com/api/v1/market/0x123.../holders?outcome=yes&min_grade=A"

The 503

An incomplete, unstable, or failed provider scan returns 503 with Retry-After and error.reason: "read_model_warming", never a shorter list served in its place. Get Market Snapshot returns the market card this roster belongs to.

Authorizations

Authorization

string

header

required

API key or OAuth 2.1 access token in the Authorization header as Bearer oxi_sk_live_... or Bearer oxi_at_.... 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).

Headers

If-None-Match

string

Conditional GET validator from a previous ETag. Matching values return 304 Not Modified with an empty body.

Path Parameters

condition_id

string

required

Market condition ID. Accepts the raw provider-backed condition_id returned by /api/v1/markets/search or the mkt_-prefixed market.id emitted by V1 responses.

Query Parameters

outcome

enum<string>

default:all

Keep holders netting one side. all (default) lists both.

Available options:

yes,

no,

all

min_grade

enum<string>

default:B

Narrow within the graded cohort: S keeps S, A keeps S and A, B (default) keeps S, A and B. C, D and F are rejected with 400: the route lists the S/A/B cohort only.

Available options:

S,

A,

B

limit

integer

default:20

Maximum holders per page.

Required range: 1 <= x <= 100

cursor

string

Pagination cursor from the previous response's next_cursor (prefix mh_). Pages are cut from one shared roster, so a cursor stays valid across the roster's refresh.

Response

One page of the market's graded holder roster.

object

string

required

Allowed value: "list"

data

object[]

required

Show child attributes

has_more

boolean

required

total

integer

required

Holders matching the request's outcome and min_grade filters across every page.

market

object

required

Show child attributes

scan

object

required

Show child attributes

totals

object

required

Roster totals BEFORE any outcome or min_grade filter, so a page always knows the whole market it was cut from.

Show child attributes

Overview

Objects

Discovery

Traders

Positions

Markets

Content

Pick of the Day

Whale Trades

Insider Radar

Events

Streaming

Usage

Webhooks

Reports

System

List a Market's Graded Holders

Fields on the roster

Filters

The 503

Authorizations

Headers

Path Parameters

Query Parameters

Response

​Fields on the roster

​Filters

​The 503

​Related

Authorizations

Headers

Path Parameters

Query Parameters

Response

Fields on the roster

Filters

The 503

Related