MCP Radar
MCP Server

0xinsider

io.github.0xinsider/mcp
Data & Analytics Finance & Investing Public & reachable MCP 2025-11-25

What this MCP does

Provides read-only Polymarket intelligence including market exploration, trader grades and P&L, whale trades, positions, smart-money flows, reports, and prediction-market analytics.

Capabilities

Tools

48 tools
batch_get_market_flow
Batch market flow
Read-only batch lookup of market flow for 1-25 raw provider condition_id values. Results preserve request order and duplicate inputs return duplicate rows. Uses the same V1 batch item quota as POST /api/v1/markets/flow/batch. Args: - condition_ids (string[], required): Raw provider condition IDs - timeframe (string, optional): "1h", "4h", "24h", or "7d" (default "24h") Returns: Ordered batch market-flow results with per-item success or error details.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['condition_ids'], 'properties': {'timeframe': {'enum': ['1h', '4h', '24h', '7d'], 'type': 'string', 'default': '24h', 'description': 'Shared lookback window'}, 'condition_ids': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 25, 'minItems': 1, 'description': 'Raw provider condition_id values'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'MarketFlow': {'type': 'object', 'required': ['market', 'sharp_money', 'smart_money', 'timeframe'], 'properties': {'market': {'type': 'object', 'required': ['id', 'condition_id', 'title', 'slug', 'category', 'platform'], 'properties': {'id': {'type': 'string'}, 'slug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'platform': {'anyOf': [{'enum': ['polymarket'], 'type': 'string'}, {'type': 'null'}]}, 'condition_id': {'type': 'string'}}}, 'timeframe': {'type': 'string'}, 'sharp_money': {'type': 'object', 'required': ['net_flow_usd', 'direction', 'token_id', 'whale_trade_count', 'buy_volume_usd', 'sell_volume_usd', 'top_positions', 'oldest_snapshot_as_of'], 'properties': {'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'direction': {'enum': ['YES', 'NO'], 'type': 'string'}, 'net_flow_usd': {'type': 'number'}, 'top_positions': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'address', 'username', 'grade', 'side', 'token_id', 'size_usd'], 'properties': {'id': {'type': 'string'}, 'side': {'enum': ['YES', 'NO'], 'type': 'string'}, 'grade': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'size_usd': {'type': 'number'}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'username': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}}}, 'buy_volume_usd': {'type': 'number'}, 'sell_volume_usd': {'type': 'number'}, 'large_trade_count': {'type': 'integer'}, 'whale_trade_count': {'type': 'integer'}, 'oldest_snapshot_as_of': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}}}, 'smart_money': {'type': 'object', 'required': ['net_flow_usd', 'direction', 'token_id', 'whale_trade_count', 'buy_volume_usd', 'sell_volume_usd', 'top_positions', 'oldest_snapshot_as_of'], 'deprecated': True, 'properties': {'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'direction': {'enum': ['YES', 'NO'], 'type': 'string'}, 'net_flow_usd': {'type': 'number'}, 'top_positions': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'address', 'username', 'grade', 'side', 'token_id', 'size_usd'], 'properties': {'id': {'type': 'string'}, 'side': {'enum': ['YES', 'NO'], 'type': 'string'}, 'grade': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'size_usd': {'type': 'number'}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'username': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}}}, 'buy_volume_usd': {'type': 'number'}, 'sell_volume_usd': {'type': 'number'}, 'large_trade_count': {'type': 'integer'}, 'whale_trade_count': {'type': 'integer'}, 'oldest_snapshot_as_of': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}}}}}, 'ApiErrorBody': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'enum': ['bad_request', 'invalid_api_key', 'subscription_required', 'forbidden', 'insufficient_scope', 'not_found', 'account_locked', 'rate_limited', 'rate_limit_unavailable', 'internal_error', 'request_timeout'], 'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'enum': ['cursor_expired', 'unknown_endpoint', 'pick_not_released', 'trader_not_tracked', 'read_model_warming', 'database_unavailable', 'request_accounting_unavailable', 'idempotency_in_progress', 'webhook_delivery_in_progress', 'webhook_secret_rotation_not_prepared', 'webhook_secret_rotation_overlap_active', 'sandbox_api_key', 'api_key_in_query', 'subscription_inactive', 'monthly_quota_exceeded', 'invalid_query', 'unknown_query_parameter', 'invalid_path', 'invalid_body', 'unsupported_media_type', 'payload_too_large', 'method_not_allowed', 'ip_rate_limited', 'ip_throttled', 'export_expired', 'freshness_ceiling_unsatisfied'], 'type': 'string'}, 'doc_url': {'type': 'string'}, 'message': {'type': 'string'}, 'retry_at': {'type': 'string', 'format': 'date-time'}, 'freshness': {'$ref': '#/$defs/FreshnessFailure'}}}, 'FreshnessFailure': {'type': 'object', 'required': ['max_age_s', 'data_quality_status'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'max_age_s': {'type': 'integer', 'format': 'int64', 'minimum': 0}, 'actual_age_s': {'type': 'integer', 'format': 'int64', 'minimum': 0}, 'data_quality_status': {'enum': ['fresh', 'partial', 'unknown', 'untracked', 'unavailable'], 'type': 'string'}}}, 'BatchResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'total_items', 'successful_items', 'failed_items', 'request_cost', 'rate_limit'], 'properties': {'cached': {'type': 'boolean'}, 'rate_limit': {'$ref': '#/$defs/BatchRateLimitMeta'}, 'request_id': {'type': 'string'}, 'total_items': {'type': 'integer'}, 'failed_items': {'type': 'integer'}, 'request_cost': {'type': 'integer'}, 'successful_items': {'type': 'integer'}}}, 'BatchRateLimitMeta': {'type': 'object', 'required': ['basis', 'limit', 'remaining', 'reset'], 'properties': {'basis': {'type': 'string', 'const': 'batch_items_per_minute'}, 'limit': {'type': 'integer'}, 'reset': {'type': 'integer'}, 'remaining': {'type': 'integer'}}}, 'BatchMarketFlowItem': {'type': 'object', 'required': ['index', 'input', 'status'], 'properties': {'data': {'$ref': '#/$defs/MarketFlow'}, 'error': {'$ref': '#/$defs/ApiErrorBody'}, 'index': {'type': 'integer'}, 'input': {'type': 'string'}, 'status': {'enum': ['ok', 'error'], 'type': 'string'}}}}, 'anyOf': [{'type': 'object', 'required': ['object', 'data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/BatchMarketFlowItem'}}, 'meta': {'$ref': '#/$defs/BatchResponseMeta'}, 'object': {'type': 'string', 'const': 'market_flow_batch'}}}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
batch_get_market_intel
Batch Market Intelligence
Deprecated alias of batch_get_market_flow (#16312), kept live; it calls the deprecated POST /api/v1/markets/intel/batch path, whose envelope keeps object: market_intel_batch. Read-only batch lookup for 1-25 raw provider condition_id values. Results preserve request order and duplicate inputs return duplicate rows. Uses the same V1 batch item quota as POST /api/v1/markets/intel/batch. Args: - condition_ids (string[], required): Raw provider condition IDs - timeframe (string, optional): "1h", "4h", "24h", or "7d" (default "24h") Returns: Ordered batch market-intelligence results with per-item success or error details.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['condition_ids'], 'properties': {'timeframe': {'enum': ['1h', '4h', '24h', '7d'], 'type': 'string', 'default': '24h', 'description': 'Shared lookback window'}, 'condition_ids': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 25, 'minItems': 1, 'description': 'Raw provider condition_id values'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'MarketFlow': {'type': 'object', 'required': ['market', 'sharp_money', 'smart_money', 'timeframe'], 'properties': {'market': {'type': 'object', 'required': ['id', 'condition_id', 'title', 'slug', 'category', 'platform'], 'properties': {'id': {'type': 'string'}, 'slug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'platform': {'anyOf': [{'enum': ['polymarket'], 'type': 'string'}, {'type': 'null'}]}, 'condition_id': {'type': 'string'}}}, 'timeframe': {'type': 'string'}, 'sharp_money': {'type': 'object', 'required': ['net_flow_usd', 'direction', 'token_id', 'whale_trade_count', 'buy_volume_usd', 'sell_volume_usd', 'top_positions', 'oldest_snapshot_as_of'], 'properties': {'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'direction': {'enum': ['YES', 'NO'], 'type': 'string'}, 'net_flow_usd': {'type': 'number'}, 'top_positions': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'address', 'username', 'grade', 'side', 'token_id', 'size_usd'], 'properties': {'id': {'type': 'string'}, 'side': {'enum': ['YES', 'NO'], 'type': 'string'}, 'grade': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'size_usd': {'type': 'number'}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'username': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}}}, 'buy_volume_usd': {'type': 'number'}, 'sell_volume_usd': {'type': 'number'}, 'large_trade_count': {'type': 'integer'}, 'whale_trade_count': {'type': 'integer'}, 'oldest_snapshot_as_of': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}}}, 'smart_money': {'type': 'object', 'required': ['net_flow_usd', 'direction', 'token_id', 'whale_trade_count', 'buy_volume_usd', 'sell_volume_usd', 'top_positions', 'oldest_snapshot_as_of'], 'deprecated': True, 'properties': {'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'direction': {'enum': ['YES', 'NO'], 'type': 'string'}, 'net_flow_usd': {'type': 'number'}, 'top_positions': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'address', 'username', 'grade', 'side', 'token_id', 'size_usd'], 'properties': {'id': {'type': 'string'}, 'side': {'enum': ['YES', 'NO'], 'type': 'string'}, 'grade': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'size_usd': {'type': 'number'}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'username': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}}}, 'buy_volume_usd': {'type': 'number'}, 'sell_volume_usd': {'type': 'number'}, 'large_trade_count': {'type': 'integer'}, 'whale_trade_count': {'type': 'integer'}, 'oldest_snapshot_as_of': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}}}}}, 'ApiErrorBody': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'enum': ['bad_request', 'invalid_api_key', 'subscription_required', 'forbidden', 'insufficient_scope', 'not_found', 'account_locked', 'rate_limited', 'rate_limit_unavailable', 'internal_error', 'request_timeout'], 'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'enum': ['cursor_expired', 'unknown_endpoint', 'pick_not_released', 'trader_not_tracked', 'read_model_warming', 'database_unavailable', 'request_accounting_unavailable', 'idempotency_in_progress', 'webhook_delivery_in_progress', 'webhook_secret_rotation_not_prepared', 'webhook_secret_rotation_overlap_active', 'sandbox_api_key', 'api_key_in_query', 'subscription_inactive', 'monthly_quota_exceeded', 'invalid_query', 'unknown_query_parameter', 'invalid_path', 'invalid_body', 'unsupported_media_type', 'payload_too_large', 'method_not_allowed', 'ip_rate_limited', 'ip_throttled', 'export_expired', 'freshness_ceiling_unsatisfied'], 'type': 'string'}, 'doc_url': {'type': 'string'}, 'message': {'type': 'string'}, 'retry_at': {'type': 'string', 'format': 'date-time'}, 'freshness': {'$ref': '#/$defs/FreshnessFailure'}}}, 'FreshnessFailure': {'type': 'object', 'required': ['max_age_s', 'data_quality_status'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'max_age_s': {'type': 'integer', 'format': 'int64', 'minimum': 0}, 'actual_age_s': {'type': 'integer', 'format': 'int64', 'minimum': 0}, 'data_quality_status': {'enum': ['fresh', 'partial', 'unknown', 'untracked', 'unavailable'], 'type': 'string'}}}, 'BatchResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'total_items', 'successful_items', 'failed_items', 'request_cost', 'rate_limit'], 'properties': {'cached': {'type': 'boolean'}, 'rate_limit': {'$ref': '#/$defs/BatchRateLimitMeta'}, 'request_id': {'type': 'string'}, 'total_items': {'type': 'integer'}, 'failed_items': {'type': 'integer'}, 'request_cost': {'type': 'integer'}, 'successful_items': {'type': 'integer'}}}, 'BatchRateLimitMeta': {'type': 'object', 'required': ['basis', 'limit', 'remaining', 'reset'], 'properties': {'basis': {'type': 'string', 'const': 'batch_items_per_minute'}, 'limit': {'type': 'integer'}, 'reset': {'type': 'integer'}, 'remaining': {'type': 'integer'}}}, 'BatchMarketFlowItem': {'type': 'object', 'required': ['index', 'input', 'status'], 'properties': {'data': {'$ref': '#/$defs/MarketFlow'}, 'error': {'$ref': '#/$defs/ApiErrorBody'}, 'index': {'type': 'integer'}, 'input': {'type': 'string'}, 'status': {'enum': ['ok', 'error'], 'type': 'string'}}}}, 'anyOf': [{'type': 'object', 'required': ['object', 'data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/BatchMarketFlowItem'}}, 'meta': {'$ref': '#/$defs/BatchResponseMeta'}, 'object': {'type': 'string', 'const': 'market_intel_batch'}}}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
batch_get_traders
Batch traders
Read-only batch lookup for 1-25 trader wallet addresses or known usernames. Results preserve request order and duplicate inputs return duplicate rows. Uses the same V1 batch item quota as POST /api/v1/traders/batch. Args: - traders (string[], required): Wallet addresses or known usernames - expand (string[], optional): Heavy fields to include for every trader: "strategy", "categories", "quant_metrics", "trust" (per-item quant_metrics is omitted unless its computed row is strictly under six hours old; trust is per-field provenance for grade, P&L, and stats) Returns: Ordered batch trader results with per-item success or error details. Each successful item's trader carries data_quality: status, as_of and field_groups; fresh means tracked and clocked, not current, and unknown means undatable, never recent.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['traders'], 'properties': {'expand': {'type': 'array', 'items': {'enum': ['strategy', 'categories', 'quant_metrics', 'trust'], 'type': 'string'}, 'description': 'Shared heavy fields to include for every trader item; trust adds per-field provenance for grade, P&L, and stats'}, 'traders': {'type': 'array', 'items': {'type': 'string', 'minLength': 1}, 'maxItems': 25, 'minItems': 1, 'description': 'Wallet addresses or known usernames'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'Trader': {'type': 'object', 'required': ['id', 'address', 'pnl', 'stats', 'data_quality'], 'properties': {'id': {'type': 'string'}, 'pnl': {'type': 'object', 'properties': {'exact': {'$ref': '#/$defs/TraderPnlExact'}, 'total': {'type': 'number'}, 'last_7d': {'type': 'number'}, 'last_30d': {'type': 'number'}, 'realized': {'type': 'number'}, 'unrealized': {'type': 'number'}}}, 'rank': {'type': 'integer'}, 'grade': {'enum': ['S', 'A', 'B', 'C', 'D', 'F'], 'type': 'string'}, 'score': {'type': 'number'}, 'stats': {'type': 'object', 'properties': {'exact': {'$ref': '#/$defs/TraderStatsExact'}, 'win_rate': {'type': 'number'}, 'total_volume': {'type': 'number'}, 'daily_win_rate': {'type': 'number'}, 'markets_traded': {'type': 'integer'}}}, 'trust': {'$ref': '#/$defs/TraderTrust'}, 'address': {'type': 'string'}, 'strategy': {'type': 'object', 'properties': {'confidence': {'type': 'number'}, 'description': {'type': 'string'}, 'strategy_type': {'type': 'string'}}}, 'username': {'type': 'string'}, 'synced_at': {'type': 'string', 'format': 'date-time'}, 'last_active': {'type': 'string', 'format': 'date-time'}, 'streak_tier': {'enum': ['hot', 'rising', 'neutral', 'cooling', 'cold'], 'type': 'string'}, 'sync_status': {'type': 'string'}, 'data_quality': {'$ref': '#/$defs/DataQuality'}, 'quant_metrics': {'type': 'object', 'required': ['smart_score', 'copy_score', 'sharpe_30d', 'sharpe_7d', 'profit_factor', 'edge_consistency', 'sharpe_percentile', 'pf_percentile', 'consistency_percentile'], 'properties': {'sharpe_7d': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'copy_score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'sharpe_30d': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'smart_score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'pf_percentile': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'profit_factor': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'edge_consistency': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'sharpe_percentile': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'consistency_percentile': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'forecast_score': {'type': 'number'}, 'category_records': {'type': 'array', 'items': {'$ref': '#/$defs/CategorySkillV2'}}, 'forecast_evidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'category_strengths': {'type': 'object', 'additionalProperties': True}, 'category_skill_model': {'$ref': '#/$defs/CategorySkillModelReadiness'}}}, 'DataQuality': {'type': 'object', 'required': ['status', 'field_groups'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'status': {'enum': ['fresh', 'partial', 'unknown', 'untracked', 'unavailable'], 'type': 'string'}, 'field_groups': {'type': 'array', 'items': {'$ref': '#/$defs/DataQualityGroup'}}}}, 'TraderTrust': {'type': 'object', 'required': ['total_pnl', 'realized_pnl', 'unrealized_pnl', 'markets_traded', 'win_rate', 'daily_win_rate', 'total_volume', 'grade', 'score', 'forecast_score', 'forecast_evidence', 'rank', 'streak_tier', 'strategy', 'category_strengths', 'quant_metrics', 'last_active', 'synced_at', 'sync_status', 'category_records', 'category_skill_model'], 'properties': {'rank': {'$ref': '#/$defs/TrustMetadata'}, 'grade': {'$ref': '#/$defs/TrustMetadata'}, 'score': {'$ref': '#/$defs/TrustMetadata'}, 'strategy': {'$ref': '#/$defs/TrustMetadata'}, 'win_rate': {'$ref': '#/$defs/TrustMetadata'}, 'synced_at': {'$ref': '#/$defs/TrustMetadata'}, 'total_pnl': {'$ref': '#/$defs/TrustMetadata'}, 'last_active': {'$ref': '#/$defs/TrustMetadata'}, 'streak_tier': {'$ref': '#/$defs/TrustMetadata'}, 'sync_status': {'$ref': '#/$defs/TrustMetadata'}, 'realized_pnl': {'$ref': '#/$defs/TrustMetadata'}, 'total_volume': {'$ref': '#/$defs/TrustMetadata'}, 'quant_metrics': {'$ref': '#/$defs/TrustMetadata'}, 'daily_win_rate': {'$ref': '#/$defs/TrustMetadata'}, 'forecast_score': {'$ref': '#/$defs/TrustMetadata'}, 'markets_traded': {'$ref': '#/$defs/TrustMetadata'}, 'unrealized_pnl': {'$ref': '#/$defs/TrustMetadata'}, 'category_records': {'$ref': '#/$defs/TrustMetadata'}, 'forecast_evidence': {'$ref': '#/$defs/TrustMetadata'}, 'category_strengths': {'$ref': '#/$defs/TrustMetadata'}, 'category_skill_model': {'$ref': '#/$defs/TrustMetadata'}}}, 'TrustSource': {'type': 'object', 'required': ['kind', 'owner'], 'properties': {'kind': {'enum': ['provider', 'database', 'cache', 'computed', 'client_input', 'unavailable'], 'type': 'string'}, 'field': {'type': 'string'}, 'owner': {'type': 'string'}}}, 'ApiErrorBody': {'type': 'object', 'required': ['code', 'message'], 'properties': {'code': {'enum': ['bad_request', 'invalid_api_key', 'subscription_required', 'forbidden', 'insufficient_scope', 'not_found', 'account_locked', 'rate_limited', 'rate_limit_unavailable', 'internal_error', 'request_timeout'], 'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'enum': ['cursor_expired', 'unknown_endpoint', 'pick_not_released', 'trader_not_tracked', 'read_model_warming', 'database_unavailable', 'request_accounting_unavailable', 'idempotency_in_progress', 'webhook_delivery_in_progress', 'webhook_secret_rotation_not_prepared', 'webhook_secret_rotation_overlap_active', 'sandbox_api_key', 'api_key_in_query', 'subscription_inactive', 'monthly_quota_exceeded', 'invalid_query', 'unknown_query_parameter', 'invalid_path', 'invalid_body', 'unsupported_media_type', 'payload_too_large', 'method_not_allowed', 'ip_rate_limited', 'ip_throttled', 'export_expired', 'freshness_ceiling_unsatisfied'], 'type': 'string'}, 'doc_url': {'type': 'string'}, 'message': {'type': 'string'}, 'retry_at': {'type': 'string', 'format': 'date-time'}, 'freshness': {'$ref': '#/$defs/FreshnessFailure'}}}, 'ExactDecimal': {'type': 'object', 'required': ['value', 'unit', 'scale', 'basis'], 'properties': {'unit': {'type': 'string'}, 'basis': {'type': 'string'}, 'scale': {'type': 'integer', 'minimum': 0}, 'value': {'type': 'string', 'pattern': '^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$'}}}, 'TrustMetadata': {'type': 'object', 'required': ['source', 'freshness', 'reconciliation', 'completeness'], 'properties': {'source': {'$ref': '#/$defs/TrustSource'}, 'freshness': {'$ref': '#/$defs/TrustFreshness'}, 'completeness': {'$ref': '#/$defs/TrustCompleteness'}, 'reconciliation': {'$ref': '#/$defs/TrustReconciliation'}}}, 'TraderPnlExact': {'type': 'object', 'required': ['realized'], 'properties': {'realized': {'$ref': '#/$defs/ExactDecimal'}}}, 'TrustFreshness': {'type': 'object', 'required': ['status'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'status': {'enum': ['fresh', 'refreshing', 'stale', 'not_live', 'unknown', 'unavailable'], 'type': 'string'}, 'max_age_s': {'type': 'integer', 'minimum': 0}}}, 'BatchTraderItem': {'type': 'object', 'required': ['index', 'input', 'status'], 'properties': {'data': {'$ref': '#/$defs/Trader'}, 'error': {'$ref': '#/$defs/ApiErrorBody'}, 'index': {'type': 'integer'}, 'input': {'type': 'string'}, 'status': {'enum': ['ok', 'error'], 'type': 'string'}}}, 'CategorySkillV2': {'type': 'object', 'required': ['status', 'model_version', 'taxonomy_version', 'platform', 'scope', 'source_coverage', 'canonical_category', 'as_of', 'source_last_success_at', 'observation_started_at', 'latest_observation_at', 'independent_event_count', 'resolved_condition_count', 'unresolved_observation_count', 'edge_mean', 'edge_sd', 'edge_se', 'edge_lower_95', 'brier_event_avg'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'scope': {'enum': ['observed_goldsky_primary_taker_fill'], 'type': 'string'}, 'status': {'enum': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'type': 'string'}, 'edge_sd': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'edge_se': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'platform': {'enum': ['polymarket'], 'type': 'string'}, 'edge_mean': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'edge_lower_95': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'model_version': {'type': 'string'}, 'brier_event_avg': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'taxonomy_version': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'canonical_category': {'type': 'string'}, 'latest_observation_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}, 'observation_started_at': {'type': 'string', 'format': 'date-time'}, 'source_last_success_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}, 'independent_event_count': {'type': 'integer', 'minimum': 0}, 'resolved_condition_count': {'type': 'integer', 'minimum': 0}, 'unresolved_observation_count': {'type': 'integer', 'minimum': 0}}}, 'DataQualityGroup': {'type': 'object', 'required': ['group', 'owner', 'status'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'group': {'type': 'string'}, 'owner': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'enum': ['fresh', 'partial', 'unknown', 'untracked', 'unavailable'], 'type': 'string'}}}, 'FreshnessFailure': {'type': 'object', 'required': ['max_age_s', 'data_quality_status'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'max_age_s': {'type': 'integer', 'format': 'int64', 'minimum': 0}, 'actual_age_s': {'type': 'integer', 'format': 'int64', 'minimum': 0}, 'data_quality_status': {'enum': ['fresh', 'partial', 'unknown', 'untracked', 'unavailable'], 'type': 'string'}}}, 'TraderStatsExact': {'type': 'object', 'required': ['total_volume'], 'properties': {'total_volume': {'$ref': '#/$defs/ExactDecimal'}}}, 'BatchResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'total_items', 'successful_items', 'failed_items', 'request_cost', 'rate_limit'], 'properties': {'cached': {'type': 'boolean'}, 'rate_limit': {'$ref': '#/$defs/BatchRateLimitMeta'}, 'request_id': {'type': 'string'}, 'total_items': {'type': 'integer'}, 'failed_items': {'type': 'integer'}, 'request_cost': {'type': 'integer'}, 'successful_items': {'type': 'integer'}}}, 'TrustCompleteness': {'type': 'object', 'required': ['status'], 'properties': {'detail': {'type': 'string'}, 'status': {'enum': ['complete', 'partial', 'not_computed', 'not_applicable', 'unavailable'], 'type': 'string'}}}, 'BatchRateLimitMeta': {'type': 'object', 'required': ['basis', 'limit', 'remaining', 'reset'], 'properties': {'basis': {'type': 'string', 'const': 'batch_items_per_minute'}, 'limit': {'type': 'integer'}, 'reset': {'type': 'integer'}, 'remaining': {'type': 'integer'}}}, 'TrustReconciliation': {'type': 'object', 'required': ['status'], 'properties': {'detail': {'type': 'string'}, 'status': {'enum': ['provider_backed', 'db_mirror', 'computed', 'partial', 'not_applicable', 'unavailable'], 'type': 'string'}}}, 'CategorySkillModelReadiness': {'type': 'object', 'required': ['status', 'model_version', 'taxonomy_version', 'observation_started_at', 'as_of', 'source_last_success_at'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'status': {'enum': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'type': 'string'}, 'model_version': {'type': 'string'}, 'taxonomy_version': {'type': 'string'}, 'observation_started_at': {'type': 'string', 'format': 'date-time'}, 'source_last_success_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}}}}, 'anyOf': [{'type': 'object', 'required': ['object', 'data', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/BatchTraderItem'}}, 'meta': {'$ref': '#/$defs/BatchResponseMeta'}, 'object': {'type': 'string', 'const': 'trader_batch'}}}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
explore_markets
Explore Markets
Browse large-trade-active titled markets for discovery surfaces. Returns grouped event clusters or standalone markets plus live facets. Cursor-paginated over visible discovery entries. Args: - limit (number, 1-48, default 24): Max discovery entries per page - cursor (string, optional): Pagination cursor from previous response - category (string, optional): Filter by provider-native market category - status (string, optional): Filter by status: "active", "closed", or "all" - platform (string, optional): Explore is Polymarket-only; accepted for backward-compatibility, does not change the result set - sort (string, optional): Sort by "trending", "hot", "expiring", "large_trades" (deprecated spelling "whales"), "volume", or "newest" - q (string, optional): Keyword search against market titles, up to 64 characters before whitespace trimming Returns: Market discovery entries, facets, and pagination metadata.
Read only Idempotent
Input schema 
{'type': 'object', 'properties': {'q': {'type': 'string', 'maxLength': 64, 'description': 'Keyword search against market titles, up to 64 characters before whitespace trimming'}, 'sort': {'enum': ['trending', 'hot', 'expiring', 'large_trades', 'whales', 'volume', 'newest'], 'type': 'string', 'default': 'trending', 'description': 'Discovery sort order. large_trades ranks by large-trade activity; whales is its deprecated spelling and selects the same order.'}, 'limit': {'type': 'integer', 'default': 24, 'maximum': 48, 'minimum': 1, 'description': 'Max discovery entries (1-48, default 24)'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor from previous response'}, 'status': {'enum': ['active', 'closed', 'all'], 'type': 'string', 'default': 'all', 'description': 'Filter by market status'}, 'category': {'type': 'string', 'description': 'Filter by provider-native market category'}, 'platform': {'enum': ['polymarket'], 'type': 'string', 'default': 'polymarket', 'description': 'Explore is Polymarket-only; accepted for backward-compatibility and does not change the result set'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'ExploreEntry': {'oneOf': [{'$ref': '#/$defs/ExploreGroup'}, {'$ref': '#/$defs/ExploreStandalone'}], 'discriminator': {'mapping': {'group': '#/components/schemas/ExploreGroup', 'standalone': '#/components/schemas/ExploreStandalone'}, 'propertyName': 'type'}}, 'ExploreGroup': {'type': 'object', 'required': ['type', 'event_slug', 'parent_title', 'image', 'platform', 'category', 'markets', 'rep_volume', 'rep_large_trades', 'rep_whales'], 'properties': {'type': {'type': 'string', 'const': 'group'}, 'image': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'markets': {'type': 'array', 'items': {'$ref': '#/$defs/ExploreMarket'}, 'maxItems': 12}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'platform': {'anyOf': [{'enum': ['polymarket'], 'type': 'string'}, {'type': 'null'}]}, 'event_slug': {'type': 'string'}, 'rep_volume': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'rep_whales': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'parent_title': {'type': 'string'}, 'rep_large_trades': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'ExploreFacets': {'type': 'object', 'required': ['categories', 'platforms'], 'properties': {'platforms': {'type': 'array', 'items': {'$ref': '#/$defs/ExploreFacetValue'}}, 'categories': {'type': 'array', 'items': {'$ref': '#/$defs/ExploreFacetValue'}}}}, 'ExploreMarket': {'type': 'object', 'required': ['id', 'condition_id', 'title', 'slug', 'url_slug', 'image', 'icon', 'category', 'platform', 'status', 'volume', 'liquidity', 'large_trade_count', 'whale_trade_count', 'large_trade_distinct_wallets', 'whale_distinct_wallets', 'large_trade_total_usd', 'whale_total_usd', 'large_trade_last_at', 'whale_last_trade_at', 'end_date', 'created_at', 'outcome_yes', 'token_id_yes', 'outcome_no', 'token_id_no', 'event_slug', 'smart_score', 'smart_count', 'smart_label', 'outcome_yes_label', 'outcome_no_label', 'outcome_yes_provider_id', 'outcome_no_provider_id', 'open_interest', 'oi_change_pct', 'price_points', 'no_price_points', 'last_price', 'no_last_price', 'change_pct_24h', 'no_change_pct_24h', 'discover_score'], 'properties': {'id': {'type': 'string'}, 'icon': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'slug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'image': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'type': 'string', 'minLength': 1}, 'status': {'enum': ['active', 'closed'], 'type': 'string'}, 'volume': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'end_date': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}, 'platform': {'anyOf': [{'enum': ['polymarket'], 'type': 'string'}, {'type': 'null'}]}, 'url_slug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'freshness': {'type': 'object', 'required': ['enrichment_status', 'price_status'], 'properties': {'price_status': {'enum': ['available', 'unavailable'], 'type': 'string'}, 'enrichment_status': {'enum': ['available', 'unavailable'], 'type': 'string'}}}, 'liquidity': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'created_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}, 'event_slug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'last_price': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'outcome_no': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'outcome_yes': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'smart_count': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'smart_label': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'smart_score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'token_id_no': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'condition_id': {'type': 'string'}, 'price_points': {'anyOf': [{'type': 'array', 'items': {'type': 'array', 'items': {'type': 'number'}, 'maxItems': 2, 'minItems': 2}}, {'type': 'null'}]}, 'token_id_yes': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'no_last_price': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'oi_change_pct': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'open_interest': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'change_pct_24h': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'discover_score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'no_price_points': {'anyOf': [{'type': 'array', 'items': {'type': 'array', 'items': {'type': 'number'}, 'maxItems': 2, 'minItems': 2}}, {'type': 'null'}]}, 'whale_total_usd': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'outcome_no_label': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'score_components': {'type': 'object', 'required': ['volume_signal', 'large_trade_signal', 'whale_signal', 'liquidity_signal', 'recency_signal', 'sharp_money_signal', 'smart_money_signal', 'price_move_signal', 'missing_price_penalty'], 'properties': {'whale_signal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'volume_signal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'recency_signal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'liquidity_signal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'price_move_signal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'large_trade_signal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'sharp_money_signal': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'smart_money_signal': {'anyOf': [{'type': 'number', 'deprecated': True}, {'type': 'null'}]}, 'missing_price_penalty': {'type': 'number'}}}, 'large_trade_count': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'no_change_pct_24h': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'outcome_yes_label': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'whale_trade_count': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'large_trade_last_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}, 'whale_last_trade_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}, 'large_trade_total_usd': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'outcome_no_provider_id': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'whale_distinct_wallets': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'outcome_yes_provider_id': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'large_trade_distinct_wallets': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}}}, 'ExploreFacetValue': {'type': 'object', 'required': ['value', 'label', 'count'], 'properties': {'count': {'type': 'integer'}, 'label': {'type': 'string'}, 'value': {'type': 'string'}}}, 'ExploreStandalone': {'type': 'object', 'required': ['type', 'market'], 'properties': {'type': {'type': 'string', 'const': 'standalone'}, 'market': {'$ref': '#/$defs/ExploreMarket'}}}}, 'anyOf': [{'type': 'object', 'required': ['data', 'has_more', 'next_cursor', 'facets', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/ExploreEntry'}}, 'meta': {'$ref': '#/$defs/ResponseMeta'}, 'total': {'type': 'integer'}, 'facets': {'$ref': '#/$defs/ExploreFacets'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_coverage
Get coverage
Read which V1 data surfaces the API serves for Polymarket, the one venue it covers. Every surface reports the status supported: grade, pnl, strategy, timeline, large_trades, whale_signal (the deprecated spelling of large_trades), suspicious_trades, insider_radar (the deprecated spelling of suspicious_trades), and market_snapshot. Use this before choosing trader, market, large-trade, or suspicious-trade routes. Args: none Returns: Static backend-owned coverage document under the single key polymarket.
Read only Idempotent
Input schema 
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'Platforms': {'type': 'object', 'required': ['platforms'], 'properties': {'platforms': {'type': 'object', 'required': ['polymarket'], 'properties': {'polymarket': {'$ref': '#/$defs/PlatformCapabilities'}}}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'PlatformCapabilities': {'type': 'object', 'required': ['grade', 'pnl', 'strategy', 'timeline', 'large_trades', 'whale_signal', 'suspicious_trades', 'insider_radar', 'market_snapshot'], 'properties': {'pnl': {'$ref': '#/$defs/PlatformCapabilityStatus'}, 'grade': {'$ref': '#/$defs/PlatformCapabilityStatus'}, 'strategy': {'$ref': '#/$defs/PlatformCapabilityStatus'}, 'timeline': {'$ref': '#/$defs/PlatformCapabilityStatus'}, 'large_trades': {'$ref': '#/$defs/PlatformCapabilityStatus'}, 'whale_signal': {'$ref': '#/$defs/PlatformCapabilityStatus'}, 'insider_radar': {'$ref': '#/$defs/PlatformCapabilityStatus'}, 'market_snapshot': {'$ref': '#/$defs/PlatformCapabilityStatus'}, 'suspicious_trades': {'$ref': '#/$defs/PlatformCapabilityStatus'}}}, 'PlatformCapabilityStatus': {'enum': ['supported'], 'type': 'string'}}, 'anyOf': [{'allOf': [{'$ref': '#/$defs/Platforms'}, {'type': 'object', 'required': ['meta'], 'properties': {'meta': {'$ref': '#/$defs/ResponseMeta'}}}]}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_daily_report_snapshot
Get Daily Report Snapshot
Read one dated daily whale-activity report snapshot. Args: - date (string, required): UTC report date in YYYY-MM-DD format Returns: Report snapshot metadata and entries.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['date'], 'properties': {'date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'UTC report date in YYYY-MM-DD format'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'ReportPayload': {'type': 'object', 'required': ['total_large_trades', 'total_whale_trades', 'total_large_trade_volume', 'total_whale_volume', 'biggest_trade_size', 'active_traders', 'top_large_trades', 'top_whale_trades', 'categories', 'grade_distribution'], 'properties': {'categories': {'anyOf': [{'type': 'array', 'items': {'type': 'object'}}, {'type': 'null'}]}, 'active_traders': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'top_large_trades': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'required': ['outcome', 'side', 'title', 'size', 'price', 'token_id', 'id', 'trade_time', 'market_category', 'platform', 'name', 'pseudonym', 'trader_grade'], 'properties': {'id': {'anyOf': [{'type': 'integer', 'format': 'int64'}, {'type': 'null'}]}, 'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'side': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'size': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'price': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'outcome': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'platform': {'anyOf': [{'enum': ['polymarket'], 'type': 'string'}, {'type': 'null'}]}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'pseudonym': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'trade_time': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}, 'trader_grade': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'market_category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}}}, {'type': 'null'}]}, 'top_whale_trades': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'required': ['outcome', 'side', 'title', 'size', 'price', 'token_id', 'id', 'trade_time', 'market_category', 'platform', 'name', 'pseudonym', 'trader_grade'], 'properties': {'id': {'anyOf': [{'type': 'integer', 'format': 'int64'}, {'type': 'null'}]}, 'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'side': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'size': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'price': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'outcome': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'platform': {'anyOf': [{'enum': ['polymarket'], 'type': 'string'}, {'type': 'null'}]}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'pseudonym': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'trade_time': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}, 'trader_grade': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'market_category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}}}, {'type': 'null'}]}, 'biggest_trade_size': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'grade_distribution': {'anyOf': [{'type': 'array', 'items': {'type': 'object'}}, {'type': 'null'}]}, 'total_large_trades': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'total_whale_trades': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'total_whale_volume': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'total_large_trade_volume': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}}, 'SnapshotState': {'type': 'object', 'required': ['version', 'storage', 'status', 'generated_at', 'mutable_until', 'period_closed', 'final_after', 'source_read_started_at'], 'properties': {'status': {'enum': ['final', 'rolling'], 'type': 'string'}, 'storage': {'enum': ['durable', 'ephemeral'], 'type': 'string'}, 'version': {'type': 'integer', 'format': 'int64'}, 'final_after': {'type': 'string', 'format': 'date-time'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'mutable_until': {'anyOf': [{'type': 'string', 'format': 'date'}, {'type': 'null'}]}, 'period_closed': {'type': 'boolean'}, 'source_read_started_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}}}, 'ReportSnapshot': {'type': 'object', 'required': ['kind', 'generated_at', 'source_range', 'snapshot', 'completeness', 'reconciliation', 'report'], 'properties': {'kind': {'enum': ['daily', 'weekly', 'monthly'], 'type': 'string'}, 'report': {'$ref': '#/$defs/ReportPayload'}, 'snapshot': {'$ref': '#/$defs/SnapshotState'}, 'completeness': {'$ref': '#/$defs/SnapshotCompleteness'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'source_range': {'$ref': '#/$defs/ReportSourceRange'}, 'reconciliation': {'$ref': '#/$defs/ReportReconciliation'}}}, 'ReportSourceRange': {'type': 'object', 'required': ['start_date', 'end_date', 'timezone'], 'properties': {'end_date': {'type': 'string', 'format': 'date'}, 'timezone': {'type': 'string', 'const': 'UTC'}, 'start_date': {'type': 'string', 'format': 'date'}}}, 'ReportReconciliation': {'type': 'object', 'required': ['volume_kind', 'whale_volume_source', 'notes'], 'properties': {'notes': {'type': 'string'}, 'volume_kind': {'type': 'string', 'const': 'local_whale_activity_volume'}, 'whale_volume_source': {'type': 'string'}}}, 'SnapshotCompleteness': {'type': 'object', 'required': ['status', 'reason', 'expected_days', 'covered_days_with_whale_activity'], 'properties': {'reason': {'type': 'string'}, 'status': {'enum': ['complete', 'partial', 'empty'], 'type': 'string'}, 'expected_days': {'type': 'integer'}, 'covered_days_with_whale_activity': {'type': 'integer'}, 'covered_days_with_large_trade_activity': {'type': 'integer'}}}}, 'anyOf': [{'allOf': [{'$ref': '#/$defs/ReportSnapshot'}, {'type': 'object', 'required': ['meta'], 'properties': {'meta': {'$ref': '#/$defs/ResponseMeta'}}}]}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_event_replay_since
Replay Public Events
Replay durable public large-trade events strictly after an opaque cursor, in commit order (a page never reaches past the oldest open write transaction, so a late-committing lower id is delivered later instead of skipped). Filters narrow the stream in place and are bound to the cursor: a cursor issued under other filters answers error.reason cursor_expired, so restart without a cursor. expand=trade adds the public trade read to every event, so a page needs no per-event get_whale_trade call. Args: - cursor (string, optional): Opaque event replay cursor - limit (number, 1-100, default 50) - trader (string, optional): wallet address, trd_ id or username - condition_id (string, optional): raw condition_id or mkt_ id - min_grade (string, optional): S, A, B, C, D or F - min_size (number, optional): minimum size in USD - expand (string, optional): "trade" Returns: Event replay window with retention and completeness metadata; each event carries trade when expanded.
Read only Idempotent
Input schema 
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 50, 'maximum': 100, 'minimum': 1, 'description': 'Max events (1-100, default 50)'}, 'cursor': {'type': 'string', 'description': 'Opaque event replay cursor; bound to the filters the walk ran with'}, 'expand': {'enum': ['trade'], 'type': 'string', 'description': 'trade: add the public trade read to every event, so no per-event detail call is needed'}, 'trader': {'type': 'string', 'description': "Only this wallet's trades: address, trd_ id or username (bound to the cursor)"}, 'min_size': {'type': 'number', 'minimum': 0, 'description': 'Only trades of at least this size in USD (bound to the cursor)'}, 'min_grade': {'enum': ['S', 'A', 'B', 'C', 'D', 'F'], 'type': 'string', 'description': 'Only wallets at this grade or better (bound to the cursor)'}, 'condition_id': {'type': 'string', 'description': "Only this market's trades: raw condition_id or mkt_ id (bound to the cursor)"}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'LargeTrade': {'type': 'object', 'required': ['id', 'traded_at', 'size_usd', 'side', 'outcome', 'token_id', 'price', 'review_score', 'signal_score', 'recorded_review_score', 'recorded_signal_score', 'suspicion_score', 'suspicion_track', 'trader', 'market'], 'properties': {'id': {'type': 'string'}, 'side': {'enum': ['BUY', 'SELL'], 'type': 'string'}, 'price': {'type': 'number'}, 'market': {'type': 'object', 'required': ['id', 'condition_id', 'title'], 'properties': {'id': {'type': 'string'}, 'slug': {'type': 'string'}, 'title': {'type': 'string'}, 'category': {'type': 'string'}, 'condition_id': {'type': 'string'}}}, 'trader': {'type': 'object', 'required': ['id', 'address', 'grade_at_trade', 'grade_at_trade_status'], 'properties': {'id': {'type': 'string'}, 'grade': {'type': 'string'}, 'address': {'type': 'string'}, 'username': {'type': 'string'}, 'grade_at_trade': {'anyOf': [{'enum': ['S', 'A', 'B', 'C', 'D', 'F'], 'type': 'string'}, {'type': 'null'}]}, 'grade_at_trade_status': {'enum': ['graded', 'ungraded', 'unknown'], 'type': 'string'}}}, 'outcome': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'size_usd': {'type': 'number'}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'traded_at': {'type': 'string', 'format': 'date-time'}, 'review_score': {'type': 'number'}, 'signal_score': {'type': 'number', 'deprecated': True}, 'suspicion_score': {'anyOf': [{'type': 'integer', 'maximum': 100, 'minimum': 0}, {'type': 'null'}]}, 'suspicion_track': {'anyOf': [{'enum': ['whale', 'fresh_conviction', 'sliced_position'], 'type': 'string'}, {'type': 'null'}]}, 'market_volume_share': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'recorded_review_score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'recorded_signal_score': {'anyOf': [{'type': 'number', 'deprecated': True}, {'type': 'null'}]}}}, 'EventReplayMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost', 'replay', 'retention', 'completeness'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'replay': {'type': 'object', 'required': ['from_cursor', 'to_cursor', 'from_sequence', 'to_sequence', 'ordering', 'pending_beyond_horizon', 'expand'], 'properties': {'expand': {'type': 'array', 'items': {'enum': ['trade'], 'type': 'string'}}, 'filters': {'type': 'object', 'properties': {'trader': {'type': 'string'}, 'min_size': {'type': 'number'}, 'min_grade': {'enum': ['S', 'A', 'B', 'C', 'D', 'F'], 'type': 'string'}, 'condition_id': {'type': 'string'}}}, 'ordering': {'type': 'string', 'const': 'commit_visibility_then_id_asc'}, 'to_cursor': {'type': 'string'}, 'from_cursor': {'type': 'string'}, 'to_sequence': {'type': 'integer', 'minimum': 0}, 'from_sequence': {'type': 'integer', 'minimum': 0}, 'pending_beyond_horizon': {'type': 'boolean'}}}, 'retention': {'type': 'object', 'required': ['status', 'retained_events', 'cursor_expired'], 'properties': {'status': {'enum': ['durable_database'], 'type': 'string'}, 'cursor_expired': {'type': 'boolean', 'const': False}, 'retained_events': {'type': 'integer', 'minimum': 0}}}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'completeness': {'type': 'object', 'required': ['status', 'reason'], 'properties': {'reason': {'type': 'string'}, 'status': {'enum': ['complete', 'caught_up'], 'type': 'string'}}}}}, 'EventReplayEvent': {'type': 'object', 'required': ['id', 'type', 'cursor', 'sequence', 'published_at', 'payload', 'source', 'freshness'], 'properties': {'id': {'type': 'string'}, 'type': {'enum': ['whale_trades_inserted'], 'type': 'string'}, 'trade': {'oneOf': [{'$ref': '#/$defs/LargeTrade'}, {'type': 'null'}]}, 'cursor': {'type': 'string'}, 'source': {'$ref': '#/$defs/EventReplaySource'}, 'payload': {'type': 'object', 'required': ['count', 'whale_alert_id', 'condition_id', 'trader_id', 'platform'], 'properties': {'count': {'type': 'integer', 'minimum': 1}, 'platform': {'enum': ['polymarket'], 'type': 'string'}, 'trader_id': {'type': 'integer'}, 'condition_id': {'type': 'string'}, 'whale_alert_id': {'type': 'integer', 'minimum': 1}}, 'additionalProperties': True}, 'sequence': {'type': 'integer', 'minimum': 1}, 'freshness': {'$ref': '#/$defs/EventReplayFreshness'}, 'published_at': {'type': 'string', 'format': 'date-time'}}}, 'EventReplaySource': {'type': 'object', 'required': ['kind', 'producer_family', 'owner', 'provider_fetch_at_request_time'], 'properties': {'kind': {'type': 'string', 'const': 'local_durable_replay'}, 'owner': {'type': 'string', 'const': 'whale_alerts'}, 'producer_family': {'enum': ['whale_trades'], 'type': 'string'}, 'provider_fetch_at_request_time': {'type': 'boolean', 'const': False}}}, 'EventReplayFreshness': {'type': 'object', 'required': ['status', 'observed_at'], 'properties': {'status': {'type': 'string', 'const': 'observed'}, 'observed_at': {'type': 'string', 'format': 'date-time'}}}}, 'anyOf': [{'type': 'object', 'required': ['data', 'has_more', 'next_cursor', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/EventReplayEvent'}}, 'meta': {'$ref': '#/$defs/EventReplayMeta'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_game
Get one game
The same game object list_games returns, for one event_slug: both sides with their provider ids and live scores, the UTC kickoff, the provider's own status, the esports series format, and every linked Polymarket market with its condition_id and outcome token ids. The slug is the identity the live_sports_updated webhook pulse carries, so a receiver can read the full game straight from a pulse. Args: - event_slug (string, required): the game's event slug, for example nfl-buf-nyj-2026-09-22. Matched case-insensitively Returns: the game object with the envelope's meta. status.state keeps postponed, cancelled, suspended and delayed distinct from a plain 'not live'. Each game's own coverage reports whether scores, competitor provider ids and the schedule were available: when competitors reads labels, do not join on names. A slug outside the published coverage answers 404, including a real Polymarket event in a sport this deployment does not serve; list_games names what is covered. Carries no price, no sharp-money split and no holder identity.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['event_slug'], 'properties': {'event_slug': {'type': 'string', 'minLength': 1, 'description': "The game's event slug, for example nfl-buf-nyj-2026-09-22; matched case-insensitively"}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'Game': {'type': 'object', 'required': ['object', 'event_slug', 'status', 'competitors', 'draw_offered', 'markets', 'freshness', 'coverage', 'url'], 'properties': {'url': {'type': 'string'}, 'sport': {'type': 'string'}, 'title': {'type': 'string'}, 'league': {'type': 'string'}, 'object': {'type': 'string', 'const': 'game'}, 'status': {'$ref': '#/$defs/GameStatus'}, 'game_id': {'type': 'string'}, 'markets': {'type': 'array', 'items': {'$ref': '#/$defs/GameMarket'}}, 'coverage': {'$ref': '#/$defs/GameCoverage'}, 'freshness': {'$ref': '#/$defs/GameFreshness'}, 'event_slug': {'type': 'string'}, 'competitors': {'type': 'array', 'items': {'$ref': '#/$defs/GameCompetitor'}}, 'draw_offered': {'type': 'boolean'}, 'scheduled_at': {'type': 'string', 'format': 'date-time'}, 'series_format': {'type': 'string'}}}, 'GameMarket': {'type': 'object', 'required': ['id', 'condition_id', 'platform'], 'properties': {'id': {'type': 'string'}, 'side': {'enum': ['home', 'away', 'draw', 'other'], 'type': 'string'}, 'slug': {'type': 'string'}, 'prices': {'$ref': '#/$defs/GameMarketPrices'}, 'platform': {'enum': ['polymarket'], 'type': 'string'}, 'outcome_no': {'type': 'string'}, 'outcome_yes': {'type': 'string'}, 'condition_id': {'type': 'string'}, 'outcome_token_ids': {'type': 'array', 'items': {'type': 'string'}}, 'sports_market_type': {'type': 'string'}}}, 'GameStatus': {'type': 'object', 'required': ['state', 'ended'], 'properties': {'live': {'type': 'boolean'}, 'clock': {'type': 'string'}, 'ended': {'type': 'boolean'}, 'state': {'enum': ['scheduled', 'live', 'paused', 'ended', 'postponed', 'cancelled', 'suspended', 'delayed', 'unknown'], 'type': 'string'}, 'period': {'type': 'string'}, 'match_status': {'enum': ['scheduled', 'in_progress', 'halftime', 'penalty_shootout', 'delayed', 'suspended', 'final', 'final_overtime', 'final_shootout', 'awarded', 'forfeit', 'not_necessary', 'postponed', 'cancelled', 'unknown'], 'type': 'string'}, 'provider_status': {'type': 'string'}}}, 'GameCoverage': {'type': 'object', 'required': ['scores', 'competitors', 'schedule'], 'properties': {'scores': {'enum': ['available', 'unavailable'], 'type': 'string'}, 'schedule': {'enum': ['available', 'unavailable'], 'type': 'string'}, 'competitors': {'enum': ['provider_ids', 'labels', 'unavailable'], 'type': 'string'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'GameFreshness': {'type': 'object', 'required': ['source', 'source_status', 'source_availability', 'source_freshness', 'delayed'], 'properties': {'source': {'enum': ['live', 'upcoming'], 'type': 'string'}, 'delayed': {'type': 'boolean'}, 'source_status': {'enum': ['ok', 'unavailable'], 'type': 'string'}, 'scores_source_at': {'type': 'string', 'format': 'date-time'}, 'source_freshness': {'enum': ['fresh', 'stale', 'unknown', 'not_applicable'], 'type': 'string'}, 'scores_observed_at': {'type': 'string', 'format': 'date-time'}, 'source_age_seconds': {'type': 'integer'}, 'source_observed_at': {'type': 'string', 'format': 'date-time'}, 'source_availability': {'enum': ['available', 'unavailable', 'not_applicable'], 'type': 'string'}}}, 'GameCompetitor': {'type': 'object', 'required': ['name'], 'properties': {'logo': {'type': 'string'}, 'name': {'type': 'string'}, 'score': {'type': 'string'}, 'record': {'type': 'string'}, 'provider_id': {'type': 'string'}}}, 'GameMarketPrices': {'type': 'object', 'required': ['provider', 'observed_at', 'observation_source'], 'properties': {'provider': {'$ref': '#/$defs/GameMarketProviderPrices'}, 'observed_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'observation_source': {'enum': ['board_snapshot', 'clob_display'], 'type': 'string'}}}, 'GameMarketPricePaired': {'type': 'object', 'required': ['state', 'competitor_a', 'competitor_b', 'competitor_a_is_yes', 'binding_provenance'], 'properties': {'state': {'type': 'string', 'const': 'paired'}, 'competitor_a': {'$ref': '#/$defs/GameMarketPriceCompetitor'}, 'competitor_b': {'$ref': '#/$defs/GameMarketPriceCompetitor'}, 'binding_provenance': {'$ref': '#/$defs/GameMarketPriceBindingProvenance'}, 'competitor_a_is_yes': {'type': 'boolean'}}}, 'GameMarketPriceInvalid': {'type': 'object', 'required': ['state', 'reason'], 'properties': {'state': {'type': 'string', 'const': 'invalid'}, 'reason': {'enum': ['team_cardinality', 'outcome_cardinality', 'price_cardinality', 'non_finite_price', 'out_of_range_price', 'non_complementary_prices', 'ambiguous_identity', 'final_identity_mismatch'], 'type': 'string'}, 'binding_provenance': {'$ref': '#/$defs/GameMarketPriceBindingProvenance'}, 'competitor_a_is_yes': {'type': 'boolean'}, 'competitor_a_provider_id': {'type': 'integer', 'format': 'int64'}, 'competitor_b_provider_id': {'type': 'integer', 'format': 'int64'}}}, 'GameMarketProviderPrices': {'oneOf': [{'$ref': '#/$defs/GameMarketPricePaired'}, {'$ref': '#/$defs/GameMarketPriceIncomplete'}, {'$ref': '#/$defs/GameMarketPriceInvalid'}], 'discriminator': {'mapping': {'paired': '#/components/schemas/GameMarketPricePaired', 'invalid': '#/components/schemas/GameMarketPriceInvalid', 'incomplete': '#/components/schemas/GameMarketPriceIncomplete'}, 'propertyName': 'state'}}, 'GameMarketPriceCompetitor': {'type': 'object', 'required': ['label', 'price', 'price_provenance'], 'properties': {'label': {'type': 'string'}, 'price': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'provider_id': {'type': 'integer', 'format': 'int64'}, 'price_provenance': {'enum': ['gamma_outcome_prices', 'clob_display'], 'type': 'string'}}}, 'GameMarketPriceIncomplete': {'type': 'object', 'required': ['state', 'reason'], 'properties': {'state': {'type': 'string', 'const': 'incomplete'}, 'reason': {'enum': ['outcome_prices_missing', 'outcome_price_leg_missing', 'zero_price_sentinel', 'display_price_pair_unavailable', 'outcome_identity_unavailable', 'final_score_unavailable'], 'type': 'string'}, 'binding_provenance': {'$ref': '#/$defs/GameMarketPriceBindingProvenance'}, 'competitor_a_is_yes': {'type': 'boolean'}, 'competitor_a_provider_id': {'type': 'integer', 'format': 'int64'}, 'competitor_b_provider_id': {'type': 'integer', 'format': 'int64'}}}, 'GameMarketPriceBindingProvenance': {'enum': ['provider_ids', 'exact_labels', 'containment_labels', 'elimination'], 'type': 'string'}}, 'anyOf': [{'allOf': [{'$ref': '#/$defs/Game'}, {'type': 'object', 'required': ['meta'], 'properties': {'meta': {'$ref': '#/$defs/ResponseMeta'}}}]}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_insider_radar
Get Insider Radar Flags
Deprecated alias of get_suspicious_trades (#16301), kept live; it calls the deprecated /api/v1/insider-radar path. Stored trades whose recorded suspicion score meets the live flag threshold. Cursor-paginated by suspicion score (highest first). Use mode=stable when a walk must stay on one published scoring generation; restart when it returns cursor_expired. Each suspicious trade includes: - suspicion_score (60-100) - severity (currently flag) - Sub-scores: size and fresh_wallet when recorded; timing and edge are null - Evidence JSON with the scorer's stored signals Args: - limit (number, 1-100, default 20): Max results per page - cursor (string, optional): Pagination cursor from previous response - min_suspicion (number, 0-100, default 0): Minimum score; the live floor of 60 also applies - severity (string, optional): "flag" selects live rows; "watch" returns none because no live watch policy exists - mode (string, optional): "live" (default) uses fresh cached pages; "stable" pins the walk to one published scoring generation Returns: List of suspicious trades with trader, market, scores, and evidence.
Read only Idempotent
Input schema 
{'type': 'object', 'properties': {'mode': {'enum': ['live', 'stable'], 'type': 'string', 'default': 'live', 'description': 'live uses the fresh response cache; stable pins pagination to one published scoring generation'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Max results (1-100, default 20)'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor from previous response'}, 'severity': {'enum': ['flag', 'watch'], 'type': 'string', 'description': '"flag" selects live rows; "watch" returns none because no live watch policy exists'}, 'min_suspicion': {'type': 'number', 'default': 0, 'maximum': 100, 'minimum': 0, 'description': 'Minimum suspicion score (0-100); the live floor of 60 also applies'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'SuspiciousTrade': {'type': 'object', 'required': ['id', 'suspicion_score', 'severity', 'trader', 'market', 'scores', 'evidence', 'created_at'], 'properties': {'id': {'type': 'string'}, 'market': {'type': 'object', 'required': ['id', 'condition_id', 'title'], 'properties': {'id': {'type': 'string'}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'condition_id': {'type': 'string'}}}, 'scores': {'type': 'object', 'required': ['timing', 'edge', 'size', 'fresh_wallet'], 'properties': {'edge': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'size': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'timing': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'fresh_wallet': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}}, 'trader': {'type': 'object', 'required': ['id', 'address', 'username'], 'properties': {'id': {'type': 'string'}, 'address': {'type': 'string'}, 'username': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}}, 'evidence': {}, 'severity': {'enum': ['flag'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'suspicion_score': {'type': 'number', 'maximum': 100, 'minimum': 60}}}}, 'anyOf': [{'type': 'object', 'required': ['data', 'has_more', 'next_cursor', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/SuspiciousTrade'}}, 'meta': {'$ref': '#/$defs/ResponseMeta'}, 'total': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_insider_radar_flag
Get Insider Radar Flag
Deprecated alias of get_suspicious_trade (#16301), kept live; it calls the deprecated /api/v1/insider-radar/{id} path. Read one suspicious trade by ID. Accepts the rf_ ID returned by list responses or the raw numeric whale_alerts.id. Args: - id (string, required): Suspicious trade ID such as rf_123 or 123 Returns: One suspicious trade with trader, market, suspicion scores, and evidence.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Suspicious trade ID such as rf_123 or 123'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'SuspiciousTrade': {'type': 'object', 'required': ['id', 'suspicion_score', 'severity', 'trader', 'market', 'scores', 'evidence', 'created_at'], 'properties': {'id': {'type': 'string'}, 'market': {'type': 'object', 'required': ['id', 'condition_id', 'title'], 'properties': {'id': {'type': 'string'}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'condition_id': {'type': 'string'}}}, 'scores': {'type': 'object', 'required': ['timing', 'edge', 'size', 'fresh_wallet'], 'properties': {'edge': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'size': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'timing': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'fresh_wallet': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}}, 'trader': {'type': 'object', 'required': ['id', 'address', 'username'], 'properties': {'id': {'type': 'string'}, 'address': {'type': 'string'}, 'username': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}}, 'evidence': {}, 'severity': {'enum': ['flag'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'suspicion_score': {'type': 'number', 'maximum': 100, 'minimum': 60}}}}, 'anyOf': [{'allOf': [{'$ref': '#/$defs/SuspiciousTrade'}, {'type': 'object', 'required': ['meta'], 'properties': {'meta': {'$ref': '#/$defs/ResponseMeta'}}}]}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_large_positions
List Large Positions
List the largest current open positions from graded traders (Polymarket-only). Each row carries position value, open (unrealized) P&L, share count, entry/current price, outcome label, and trader/market context. Cursor-paginated by position value descending. Polymarket-only: the scanner filters platform = 'polymarket', so an unknown condition_id matches nothing and returns an empty list (never fabricated rows). Args: - limit (number, 1-100, default 20): Max results per page - cursor (string, optional): Opaque pagination cursor from previous response - min_size (number, optional): Minimum position value in USD - category (string, optional): Filter by provider-backed market category - min_grade (string, optional): Minimum trader grade (S, A, B, C, D, F) - condition_id (string, optional): Scope to one market (raw provider id or mkt_-prefixed) Returns: List of large positions with trader, market, value, P&L, and pagination metadata.
Read only Idempotent
Input schema 
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Max results (1-100, default 20)'}, 'cursor': {'type': 'string', 'description': 'Opaque pagination cursor from previous response'}, 'category': {'type': 'string', 'description': 'Filter by provider-backed market category'}, 'min_size': {'type': 'number', 'minimum': 0, 'description': 'Minimum position value in USD'}, 'min_grade': {'enum': ['S', 'A', 'B', 'C', 'D', 'F'], 'type': 'string', 'description': 'Minimum trader grade'}, 'condition_id': {'type': 'string', 'description': 'Scope to one market (raw provider condition_id or mkt_-prefixed). Polymarket-only; an unknown id returns an empty list.'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'LargePosition': {'type': 'object', 'required': ['id', 'platform', 'is_two_sided', 'holdings', 'share_count', 'token_id', 'event_leg_count', 'first_seen_at', 'last_updated_at', 'trader', 'market'], 'properties': {'id': {'type': 'string'}, 'market': {'type': 'object', 'required': ['id', 'condition_id'], 'properties': {'id': {'type': 'string'}, 'slug': {'type': 'string'}, 'title': {'type': 'string'}, 'category': {'type': 'string'}, 'event_slug': {'type': 'string'}, 'condition_id': {'type': 'string'}}}, 'trader': {'type': 'object', 'required': ['id', 'address'], 'properties': {'id': {'type': 'string'}, 'pnl': {'type': 'number'}, 'grade': {'enum': ['S', 'A', 'B', 'C', 'D', 'F'], 'type': 'string'}, 'address': {'type': 'string'}, 'username': {'type': 'string'}, 'win_rate': {'type': 'number'}, 'markets_traded': {'type': 'integer'}}}, 'holdings': {'type': 'array', 'items': {'type': 'object', 'required': ['outcome_index', 'token_id', 'share_count'], 'properties': {'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'value_usd': {'type': 'number'}, 'share_count': {'type': 'number'}, 'current_price': {'type': 'number'}, 'outcome_index': {'type': 'integer'}, 'outcome_label': {'type': 'string'}, 'unrealized_pnl': {'type': 'number'}, 'avg_entry_price': {'type': 'number'}}}}, 'platform': {'enum': ['polymarket'], 'type': 'string'}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'share_count': {'type': 'number'}, 'is_two_sided': {'type': 'boolean'}, 'current_price': {'type': 'number'}, 'first_seen_at': {'type': 'string', 'format': 'date-time'}, 'outcome_label': {'type': 'string'}, 'total_size_usd': {'type': 'number'}, 'avg_entry_price': {'type': 'number'}, 'event_leg_count': {'type': 'integer'}, 'last_updated_at': {'type': 'string', 'format': 'date-time'}, 'combined_value_usd': {'type': 'number'}, 'event_total_value_usd': {'type': 'number'}, 'combined_unrealized_pnl': {'type': 'number'}, 'position_unrealized_pnl': {'type': 'number'}}}}, 'anyOf': [{'type': 'object', 'required': ['data', 'has_more', 'next_cursor', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/LargePosition'}}, 'meta': {'$ref': '#/$defs/ResponseMeta'}, 'total': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_large_trade
Get large trade
Read one large trade by ID. Accepts either the wt_ ID returned by large-trade list/history responses or the raw numeric id. Args: - id (string, required): Large trade ID such as wt_123 or 123 Returns: One large trade with trader info, market context, size, side, price, current review_score (signal_score is its deprecated twin, same value) and trader grade, point-in-time recorded_review_score (recorded_signal_score is its deprecated twin; null before 2026-08-03) and trader grade_at_trade with grade_at_trade_status (unknown before 2026-09-19), optional suspicion_score, and optional suspicion_track. A null suspicion track means the persisted legacy row has no track label.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Large trade ID such as wt_123 or 123'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'LargeTrade': {'type': 'object', 'required': ['id', 'traded_at', 'size_usd', 'side', 'outcome', 'token_id', 'price', 'review_score', 'signal_score', 'recorded_review_score', 'recorded_signal_score', 'suspicion_score', 'suspicion_track', 'trader', 'market'], 'properties': {'id': {'type': 'string'}, 'side': {'enum': ['BUY', 'SELL'], 'type': 'string'}, 'price': {'type': 'number'}, 'market': {'type': 'object', 'required': ['id', 'condition_id', 'title'], 'properties': {'id': {'type': 'string'}, 'slug': {'type': 'string'}, 'title': {'type': 'string'}, 'category': {'type': 'string'}, 'condition_id': {'type': 'string'}}}, 'trader': {'type': 'object', 'required': ['id', 'address', 'grade_at_trade', 'grade_at_trade_status'], 'properties': {'id': {'type': 'string'}, 'grade': {'type': 'string'}, 'address': {'type': 'string'}, 'username': {'type': 'string'}, 'grade_at_trade': {'anyOf': [{'enum': ['S', 'A', 'B', 'C', 'D', 'F'], 'type': 'string'}, {'type': 'null'}]}, 'grade_at_trade_status': {'enum': ['graded', 'ungraded', 'unknown'], 'type': 'string'}}}, 'outcome': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'size_usd': {'type': 'number'}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'traded_at': {'type': 'string', 'format': 'date-time'}, 'review_score': {'type': 'number'}, 'signal_score': {'type': 'number', 'deprecated': True}, 'suspicion_score': {'anyOf': [{'type': 'integer', 'maximum': 100, 'minimum': 0}, {'type': 'null'}]}, 'suspicion_track': {'anyOf': [{'enum': ['whale', 'fresh_conviction', 'sliced_position'], 'type': 'string'}, {'type': 'null'}]}, 'market_volume_share': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'recorded_review_score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'recorded_signal_score': {'anyOf': [{'type': 'number', 'deprecated': True}, {'type': 'null'}]}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'LargeTradeDetail': {'allOf': [{'$ref': '#/$defs/LargeTrade'}, {'type': 'object', 'required': ['counterparty_analysis'], 'properties': {'counterparty_analysis': {'$ref': '#/$defs/CounterpartyAnalysis'}}}]}, 'CounterpartyAnalysis': {'type': 'object', 'required': ['status', 'execution_count', 'available_execution_count', 'unavailable_execution_count', 'executions'], 'properties': {'status': {'enum': ['available', 'partial', 'unavailable'], 'type': 'string'}, 'executions': {'type': 'array', 'items': {'$ref': '#/$defs/CounterpartyExecution'}}, 'analysis_id': {'type': 'string'}, 'snapshot_id': {'type': 'string'}, 'execution_count': {'type': 'integer'}, 'unavailable_reason': {'type': 'string'}, 'executions_next_cursor': {'type': 'string'}, 'available_execution_count': {'type': 'integer'}, 'unavailable_execution_count': {'type': 'integer'}}}, 'CounterpartyExecution': {'type': 'object', 'required': ['execution_id', 'exchange_family', 'transaction_hash', 'orders_matched_log_index', 'taker', 'makers'], 'properties': {'taker': {'$ref': '#/$defs/CounterpartyParticipant'}, 'makers': {'type': 'array', 'items': {'$ref': '#/$defs/CounterpartyParticipant'}}, 'execution_id': {'type': 'string'}, 'exchange_family': {'enum': ['ctf_v2', 'neg_risk_ctf_v2'], 'type': 'string'}, 'transaction_hash': {'type': 'string'}, 'makers_next_cursor': {'type': 'string'}, 'orders_matched_log_index': {'type': 'integer'}}}, 'CounterpartyParticipant': {'type': 'object', 'required': ['counterparty_key', 'execution_wallet', 'identity_status', 'maker_fill_count', 'filled_shares', 'filled_usdc', 'share_pct', 'match_breakdown'], 'properties': {'grade': {'type': 'string'}, 'share_pct': {'type': 'string'}, 'filled_usdc': {'type': 'string'}, 'display_name': {'type': 'string'}, 'filled_shares': {'type': 'string'}, 'wallet_family': {'type': 'string'}, 'last_traded_at': {'type': 'string', 'format': 'date-time'}, 'identity_status': {'enum': ['resolved', 'infrastructure', 'unavailable'], 'type': 'string'}, 'match_breakdown': {'type': 'array', 'items': {'$ref': '#/$defs/CounterpartyMatchBreakdown'}}, 'profile_segment': {'type': 'string'}, 'counterparty_key': {'type': 'string'}, 'execution_wallet': {'type': 'string'}, 'maker_fill_count': {'type': 'integer'}, 'resolution_block': {'type': 'integer'}, 'resolved_user_id': {'type': 'string'}, 'resolution_source': {'type': 'string'}}}, 'CounterpartyMatchBreakdown': {'type': 'object', 'required': ['match_type', 'maker_fill_count', 'filled_shares'], 'properties': {'match_type': {'enum': ['COMPLEMENTARY', 'MINT', 'MERGE'], 'type': 'string'}, 'filled_shares': {'type': 'string'}, 'maker_fill_count': {'type': 'integer'}}}}, 'anyOf': [{'allOf': [{'$ref': '#/$defs/LargeTradeDetail'}, {'type': 'object', 'required': ['meta'], 'properties': {'meta': {'$ref': '#/$defs/ResponseMeta'}}}]}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_large_trades
List large trades
Get recent large trades from graded prediction market traders. Each trade includes a 0-1 review score, persisted suspicion facts, trader grade, and market context. Cursor-paginated, newest first. Args: - limit (number, 1-100, default 20): Max results per page - cursor (string, optional): Pagination cursor from previous response - min_size (number, default 5000): Minimum trade size in USD - category (string, optional): Filter by market category (case-insensitive) - min_grade (string, optional): Minimum trader grade (S, A, B, C, D, F) - suspicious_only (boolean, optional): Keep only persisted suspicion_score >= 60; false preserves the current result set - min_market_volume_share (number, 0-1, optional): Keep only trades whose market_volume_share is known and at least this; a fraction, so 0.01 is one percent of the market's traded volume - sort (string, optional): "recent" (default, newest first) or "market_volume_share" (biggest share of its market first, over the last 30 days, or from the from bound on the history tools; a cursor is bound to the order it was minted in) - since (string, optional): wt_ id of a trade a previous call returned; answers only the trades recorded after it, in commit order, so a trade recorded late still arrives. Poll with the first trade of the last answer that had trades and deduplicate on id; recent order only Returns: List of large trades with trader info, market context, size, side, price, current review_score (signal_score is its deprecated twin, same value) and trader grade, point-in-time recorded_review_score (recorded_signal_score is its deprecated twin; null before 2026-08-03) and trader grade_at_trade with grade_at_trade_status (unknown before 2026-09-19), optional suspicion_score, and optional suspicion_track. A null suspicion track means the persisted legacy row has no track label. The page carries data_quality beside data: status, as_of (the oldest clock the page rests on) and field_groups. fresh means tracked and clocked, not current: compare as_of with your own tolerance. unknown means this read cannot date that group, never that it is recent.
Read only Idempotent
Input schema 
{'type': 'object', 'properties': {'sort': {'enum': ['recent', 'market_volume_share'], 'type': 'string', 'default': 'recent', 'description': "Order of the page. recent is newest first. market_volume_share ranks by each trade's share of its market's traded volume, biggest first, a trade whose share is unavailable last, over the last 30 days. A cursor is bound to the order it was minted in"}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Max results (1-100, default 20)'}, 'since': {'type': 'string', 'description': 'wt_ id of a trade a previous call returned: answer only the trades recorded after it, in commit order, so a trade recorded late still arrives and none is skipped. Poll with the first trade of the last answer that had trades and deduplicate on id. Recent order only'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor from previous response'}, 'category': {'type': 'string', 'description': 'Filter by market category (case-insensitive)'}, 'min_size': {'type': 'number', 'default': 5000, 'minimum': 0, 'description': 'Minimum trade size in USD (default 5000)'}, 'min_grade': {'enum': ['S', 'A', 'B', 'C', 'D', 'F'], 'type': 'string', 'description': 'Minimum trader grade'}, 'suspicious_only': {'type': 'boolean', 'default': False, 'description': 'Keep only rows with persisted suspicion_score >= 60'}, 'min_market_volume_share': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': "Keep only trades whose market_volume_share is known and at least this. A fraction, not a percent: 0.01 is one percent of the market's traded volume. A trade whose share is unavailable is never returned by a non-zero value"}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'LargeTrade': {'type': 'object', 'required': ['id', 'traded_at', 'size_usd', 'side', 'outcome', 'token_id', 'price', 'review_score', 'signal_score', 'recorded_review_score', 'recorded_signal_score', 'suspicion_score', 'suspicion_track', 'trader', 'market'], 'properties': {'id': {'type': 'string'}, 'side': {'enum': ['BUY', 'SELL'], 'type': 'string'}, 'price': {'type': 'number'}, 'market': {'type': 'object', 'required': ['id', 'condition_id', 'title'], 'properties': {'id': {'type': 'string'}, 'slug': {'type': 'string'}, 'title': {'type': 'string'}, 'category': {'type': 'string'}, 'condition_id': {'type': 'string'}}}, 'trader': {'type': 'object', 'required': ['id', 'address', 'grade_at_trade', 'grade_at_trade_status'], 'properties': {'id': {'type': 'string'}, 'grade': {'type': 'string'}, 'address': {'type': 'string'}, 'username': {'type': 'string'}, 'grade_at_trade': {'anyOf': [{'enum': ['S', 'A', 'B', 'C', 'D', 'F'], 'type': 'string'}, {'type': 'null'}]}, 'grade_at_trade_status': {'enum': ['graded', 'ungraded', 'unknown'], 'type': 'string'}}}, 'outcome': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'size_usd': {'type': 'number'}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'traded_at': {'type': 'string', 'format': 'date-time'}, 'review_score': {'type': 'number'}, 'signal_score': {'type': 'number', 'deprecated': True}, 'suspicion_score': {'anyOf': [{'type': 'integer', 'maximum': 100, 'minimum': 0}, {'type': 'null'}]}, 'suspicion_track': {'anyOf': [{'enum': ['whale', 'fresh_conviction', 'sliced_position'], 'type': 'string'}, {'type': 'null'}]}, 'market_volume_share': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'recorded_review_score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'recorded_signal_score': {'anyOf': [{'type': 'number', 'deprecated': True}, {'type': 'null'}]}}}, 'DataQuality': {'type': 'object', 'required': ['status', 'field_groups'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'status': {'enum': ['fresh', 'partial', 'unknown', 'untracked', 'unavailable'], 'type': 'string'}, 'field_groups': {'type': 'array', 'items': {'$ref': '#/$defs/DataQualityGroup'}}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'DataQualityGroup': {'type': 'object', 'required': ['group', 'owner', 'status'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'group': {'type': 'string'}, 'owner': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'enum': ['fresh', 'partial', 'unknown', 'untracked', 'unavailable'], 'type': 'string'}}}}, 'anyOf': [{'type': 'object', 'required': ['data', 'has_more', 'next_cursor', 'data_quality', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/LargeTrade'}}, 'meta': {'$ref': '#/$defs/ResponseMeta'}, 'total': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'data_quality': {'$ref': '#/$defs/DataQuality'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_large_trades_history
Replay historical large trades
Replay historical large trades from the local record. Supports cursor pagination plus condition, trader, category, grade, platform, suspicion, market-share, and RFC3339 from/to filters, and a market_volume_share sort. Args: - limit (number, 1-100, default 20) - cursor (string, optional): Pagination cursor with wth_ prefix - min_size (number, optional): Minimum trade size in USD - condition_id (string, optional): Exact raw provider condition_id - trader (string, optional): Wallet, alias, or username - category (string, optional) - min_grade (string, optional): S, A, B, C, D, or F; filters on today's grade, not the grade at trade time - suspicious_only (boolean, optional): Keep only persisted suspicion_score >= 60 - platform (string, optional): polymarket or all - from/to (string, optional): RFC3339 traded_at bounds - min_market_volume_share (number, 0-1, optional): Keep only trades whose market_volume_share is known and at least this; a fraction, so 0.01 is one percent of the market's traded volume - sort (string, optional): "recent" (default, newest first) or "market_volume_share" (biggest share of its market first, over the last 30 days, or from the from bound on the history tools; a cursor is bound to the order it was minted in) Returns: Historical large trades with replay metadata, current review_score (signal_score is its deprecated twin, same value) and trader grade, point-in-time recorded_review_score (recorded_signal_score is its deprecated twin; null before 2026-08-03) and trader grade_at_trade with grade_at_trade_status (unknown before 2026-09-19), optional suspicion_score, and optional suspicion_track. A null suspicion track means the persisted legacy row has no track label. The page carries data_quality beside data: status, as_of (the oldest clock the page rests on) and field_groups. fresh means tracked and clocked, not current: compare as_of with your own tolerance. unknown means this read cannot date that group, never that it is recent.
Read only Idempotent
Input schema 
{'type': 'object', 'properties': {'to': {'type': 'string', 'format': 'date-time', 'description': 'Exclusive traded_at upper bound'}, 'from': {'type': 'string', 'format': 'date-time', 'description': 'Inclusive traded_at lower bound'}, 'sort': {'enum': ['recent', 'market_volume_share'], 'type': 'string', 'default': 'recent', 'description': "Order of the page. recent is newest first. market_volume_share ranks by each trade's share of its market's traded volume, biggest first, a trade whose share is unavailable last, over from, or the last 30 days when from is omitted. A cursor is bound to the order it was minted in"}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Max results (1-100, default 20)'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor from previous response'}, 'trader': {'type': 'string', 'description': 'Trader wallet, alias, or username'}, 'category': {'type': 'string', 'description': 'Filter by market category'}, 'min_size': {'type': 'number', 'default': 5000, 'minimum': 0, 'description': 'Minimum trade size in USD'}, 'platform': {'enum': ['polymarket', 'all'], 'type': 'string', 'description': 'Filter by provider platform'}, 'min_grade': {'enum': ['S', 'A', 'B', 'C', 'D', 'F'], 'type': 'string', 'description': 'Minimum trader grade'}, 'condition_id': {'type': 'string', 'description': 'Exact raw provider condition_id'}, 'suspicious_only': {'type': 'boolean', 'default': False, 'description': 'Keep only rows with persisted suspicion_score >= 60'}, 'min_market_volume_share': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': "Keep only trades whose market_volume_share is known and at least this. A fraction, not a percent: 0.01 is one percent of the market's traded volume. A trade whose share is unavailable is never returned by a non-zero value"}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'LargeTrade': {'type': 'object', 'required': ['id', 'traded_at', 'size_usd', 'side', 'outcome', 'token_id', 'price', 'review_score', 'signal_score', 'recorded_review_score', 'recorded_signal_score', 'suspicion_score', 'suspicion_track', 'trader', 'market'], 'properties': {'id': {'type': 'string'}, 'side': {'enum': ['BUY', 'SELL'], 'type': 'string'}, 'price': {'type': 'number'}, 'market': {'type': 'object', 'required': ['id', 'condition_id', 'title'], 'properties': {'id': {'type': 'string'}, 'slug': {'type': 'string'}, 'title': {'type': 'string'}, 'category': {'type': 'string'}, 'condition_id': {'type': 'string'}}}, 'trader': {'type': 'object', 'required': ['id', 'address', 'grade_at_trade', 'grade_at_trade_status'], 'properties': {'id': {'type': 'string'}, 'grade': {'type': 'string'}, 'address': {'type': 'string'}, 'username': {'type': 'string'}, 'grade_at_trade': {'anyOf': [{'enum': ['S', 'A', 'B', 'C', 'D', 'F'], 'type': 'string'}, {'type': 'null'}]}, 'grade_at_trade_status': {'enum': ['graded', 'ungraded', 'unknown'], 'type': 'string'}}}, 'outcome': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'size_usd': {'type': 'number'}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'traded_at': {'type': 'string', 'format': 'date-time'}, 'review_score': {'type': 'number'}, 'signal_score': {'type': 'number', 'deprecated': True}, 'suspicion_score': {'anyOf': [{'type': 'integer', 'maximum': 100, 'minimum': 0}, {'type': 'null'}]}, 'suspicion_track': {'anyOf': [{'enum': ['whale', 'fresh_conviction', 'sliced_position'], 'type': 'string'}, {'type': 'null'}]}, 'market_volume_share': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'recorded_review_score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'recorded_signal_score': {'anyOf': [{'type': 'number', 'deprecated': True}, {'type': 'null'}]}}}, 'DataQuality': {'type': 'object', 'required': ['status', 'field_groups'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'status': {'enum': ['fresh', 'partial', 'unknown', 'untracked', 'unavailable'], 'type': 'string'}, 'field_groups': {'type': 'array', 'items': {'$ref': '#/$defs/DataQualityGroup'}}}}, 'DataQualityGroup': {'type': 'object', 'required': ['group', 'owner', 'status'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'group': {'type': 'string'}, 'owner': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'enum': ['fresh', 'partial', 'unknown', 'untracked', 'unavailable'], 'type': 'string'}}}, 'LargeTradeHistoryMeta': {'type': 'object', 'required': ['request_id', 'cached', 'source', 'completeness'], 'properties': {'cached': {'type': 'boolean'}, 'source': {'type': 'object', 'required': ['kind', 'table', 'provider_fetch_at_request_time'], 'properties': {'kind': {'type': 'string', 'const': 'local_replay'}, 'table': {'type': 'string', 'const': 'whale_alerts'}, 'provider_fetch_at_request_time': {'type': 'boolean', 'const': False}}}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'completeness': {'type': 'object', 'required': ['status', 'reason'], 'properties': {'reason': {'type': 'string'}, 'status': {'type': 'string', 'const': 'best_effort'}}}}}}, 'anyOf': [{'type': 'object', 'required': ['data', 'has_more', 'next_cursor', 'data_quality', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/LargeTrade'}}, 'meta': {'$ref': '#/$defs/LargeTradeHistoryMeta'}, 'total': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'data_quality': {'$ref': '#/$defs/DataQuality'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_leaderboard
Get Trader Leaderboard
Get the top-ranked prediction market traders (grades S, A, B only). Sorted by composite score descending. Supports cursor pagination and optional filters. Args: - limit (number, 1-100, default 20): Max results per page - cursor (string, optional): Pagination cursor from previous response - category (string, optional): Filter by category slug - strategy (string, optional): Current styles: two_sided, category_focused, high_activity, diversified, mixed, unclassified. Historical filters remain accepted: accumulator, algo_trader, arbitrageur, directional, event_driven, market_maker, momentum, scalper, speculator, swing_trader Returns: Ranked list of traders with grade, score, P&L, volume, win rate, and strategy.
Read only Idempotent
Input schema 
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Max results (1-100, default 20)'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor from previous response'}, 'category': {'type': 'string', 'description': 'Filter by category slug'}, 'strategy': {'enum': ['accumulator', 'algo_trader', 'arbitrageur', 'category_focused', 'directional', 'diversified', 'event_driven', 'high_activity', 'market_maker', 'mixed', 'momentum', 'scalper', 'speculator', 'swing_trader', 'two_sided', 'unclassified'], 'type': 'string', 'description': 'Filter by strategy type'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'LeaderboardEntry': {'type': 'object', 'required': ['id', 'address', 'platform'], 'properties': {'id': {'type': 'string'}, 'pnl': {'type': 'number'}, 'grade': {'type': 'string'}, 'score': {'type': 'number'}, 'volume': {'type': 'number'}, 'address': {'type': 'string'}, 'platform': {'enum': ['polymarket'], 'type': 'string'}, 'username': {'type': 'string'}, 'win_rate': {'type': 'number'}, 'last_active': {'type': 'string', 'format': 'date-time'}, 'streak_tier': {'enum': ['hot', 'rising', 'neutral', 'cooling', 'cold'], 'type': 'string'}, 'realized_pnl': {'type': 'number'}, 'strategy_type': {'type': 'string'}, 'markets_traded': {'type': 'integer'}}}}, 'anyOf': [{'type': 'object', 'required': ['data', 'has_more', 'next_cursor', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/LeaderboardEntry'}}, 'meta': {'$ref': '#/$defs/ResponseMeta'}, 'total': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_market_flow
Get market flow
One market's flow and top positions: the signed flow of every tracked large trade in the window (net_flow_usd and its direction, YES or NO), the large-trade count, gross buy and sell volumes, and the top five graded trader positions. The envelope object is market_flow. Use search_markets first to find the condition_id for a market. Args: - condition_id (string, required): Market condition ID (from search_markets results) - timeframe (string, optional): Lookback window: "1h", "4h", "24h", "7d" (default "24h") Returns: Market info, the flow under sharp_money (net_flow_usd, direction YES/NO, large_trade_count, volumes) with smart_money as its deprecated byte-identical alias, and the top 5 graded trader positions.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['condition_id'], 'properties': {'timeframe': {'enum': ['1h', '4h', '24h', '7d'], 'type': 'string', 'default': '24h', 'description': 'Lookback window (default 24h)'}, 'condition_id': {'type': 'string', 'description': 'Market condition ID'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'MarketFlow': {'type': 'object', 'required': ['market', 'sharp_money', 'smart_money', 'timeframe'], 'properties': {'market': {'type': 'object', 'required': ['id', 'condition_id', 'title', 'slug', 'category', 'platform'], 'properties': {'id': {'type': 'string'}, 'slug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'platform': {'anyOf': [{'enum': ['polymarket'], 'type': 'string'}, {'type': 'null'}]}, 'condition_id': {'type': 'string'}}}, 'timeframe': {'type': 'string'}, 'sharp_money': {'type': 'object', 'required': ['net_flow_usd', 'direction', 'token_id', 'whale_trade_count', 'buy_volume_usd', 'sell_volume_usd', 'top_positions', 'oldest_snapshot_as_of'], 'properties': {'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'direction': {'enum': ['YES', 'NO'], 'type': 'string'}, 'net_flow_usd': {'type': 'number'}, 'top_positions': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'address', 'username', 'grade', 'side', 'token_id', 'size_usd'], 'properties': {'id': {'type': 'string'}, 'side': {'enum': ['YES', 'NO'], 'type': 'string'}, 'grade': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'size_usd': {'type': 'number'}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'username': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}}}, 'buy_volume_usd': {'type': 'number'}, 'sell_volume_usd': {'type': 'number'}, 'large_trade_count': {'type': 'integer'}, 'whale_trade_count': {'type': 'integer'}, 'oldest_snapshot_as_of': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}}}, 'smart_money': {'type': 'object', 'required': ['net_flow_usd', 'direction', 'token_id', 'whale_trade_count', 'buy_volume_usd', 'sell_volume_usd', 'top_positions', 'oldest_snapshot_as_of'], 'deprecated': True, 'properties': {'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'direction': {'enum': ['YES', 'NO'], 'type': 'string'}, 'net_flow_usd': {'type': 'number'}, 'top_positions': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'address', 'username', 'grade', 'side', 'token_id', 'size_usd'], 'properties': {'id': {'type': 'string'}, 'side': {'enum': ['YES', 'NO'], 'type': 'string'}, 'grade': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'size_usd': {'type': 'number'}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'username': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}}}, 'buy_volume_usd': {'type': 'number'}, 'sell_volume_usd': {'type': 'number'}, 'large_trade_count': {'type': 'integer'}, 'whale_trade_count': {'type': 'integer'}, 'oldest_snapshot_as_of': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}}}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}}, 'anyOf': [{'allOf': [{'$ref': '#/$defs/MarketFlow'}, {'type': 'object', 'required': ['meta'], 'properties': {'meta': {'$ref': '#/$defs/ResponseMeta'}}}]}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_market_intel
Get Market Intelligence
Deprecated alias of get_market_flow (#16312), kept live; it calls the deprecated /api/v1/market/{condition_id}/intel path, whose envelope keeps object: market_intel. Sharp money flow analysis for a specific prediction market. Shows net flow direction, whale trade count, buy/sell volumes, and top graded trader positions. Use search_markets first to find the condition_id for a market. Args: - condition_id (string, required): Market condition ID (from search_markets results) - timeframe (string, optional): Lookback window: "1h", "4h", "24h", "7d" (default "24h") Returns: Market info, sharp_money flow (net_flow_usd, direction YES/NO, volumes) with smart_money as its deprecated byte-identical alias, and top 5 trader positions.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['condition_id'], 'properties': {'timeframe': {'enum': ['1h', '4h', '24h', '7d'], 'type': 'string', 'default': '24h', 'description': 'Lookback window (default 24h)'}, 'condition_id': {'type': 'string', 'description': 'Market condition ID'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'MarketFlow': {'type': 'object', 'required': ['market', 'sharp_money', 'smart_money', 'timeframe'], 'properties': {'market': {'type': 'object', 'required': ['id', 'condition_id', 'title', 'slug', 'category', 'platform'], 'properties': {'id': {'type': 'string'}, 'slug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'platform': {'anyOf': [{'enum': ['polymarket'], 'type': 'string'}, {'type': 'null'}]}, 'condition_id': {'type': 'string'}}}, 'timeframe': {'type': 'string'}, 'sharp_money': {'type': 'object', 'required': ['net_flow_usd', 'direction', 'token_id', 'whale_trade_count', 'buy_volume_usd', 'sell_volume_usd', 'top_positions', 'oldest_snapshot_as_of'], 'properties': {'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'direction': {'enum': ['YES', 'NO'], 'type': 'string'}, 'net_flow_usd': {'type': 'number'}, 'top_positions': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'address', 'username', 'grade', 'side', 'token_id', 'size_usd'], 'properties': {'id': {'type': 'string'}, 'side': {'enum': ['YES', 'NO'], 'type': 'string'}, 'grade': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'size_usd': {'type': 'number'}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'username': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}}}, 'buy_volume_usd': {'type': 'number'}, 'sell_volume_usd': {'type': 'number'}, 'large_trade_count': {'type': 'integer'}, 'whale_trade_count': {'type': 'integer'}, 'oldest_snapshot_as_of': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}}}, 'smart_money': {'type': 'object', 'required': ['net_flow_usd', 'direction', 'token_id', 'whale_trade_count', 'buy_volume_usd', 'sell_volume_usd', 'top_positions', 'oldest_snapshot_as_of'], 'deprecated': True, 'properties': {'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'direction': {'enum': ['YES', 'NO'], 'type': 'string'}, 'net_flow_usd': {'type': 'number'}, 'top_positions': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'address', 'username', 'grade', 'side', 'token_id', 'size_usd'], 'properties': {'id': {'type': 'string'}, 'side': {'enum': ['YES', 'NO'], 'type': 'string'}, 'grade': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'size_usd': {'type': 'number'}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'username': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}}}, 'buy_volume_usd': {'type': 'number'}, 'sell_volume_usd': {'type': 'number'}, 'large_trade_count': {'type': 'integer'}, 'whale_trade_count': {'type': 'integer'}, 'oldest_snapshot_as_of': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}}}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}}, 'anyOf': [{'allOf': [{'$ref': '#/$defs/MarketFlow'}, {'type': 'object', 'required': ['meta'], 'properties': {'meta': {'$ref': '#/$defs/ResponseMeta'}}}]}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_market_snapshot
Get Market Snapshot
Provider-first live market-card snapshot for one raw provider condition_id. Forwards IDs to the V1 handler without mkt_ rewriting. Args: - condition_id (string, required): Raw provider condition_id returned by search or explore Returns: Market identity, outcomes, liquidity, sports context, and freshness states.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['condition_id'], 'properties': {'condition_id': {'type': 'string', 'minLength': 1, 'description': 'Raw provider condition_id'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'TrustSource': {'type': 'object', 'required': ['kind', 'owner'], 'properties': {'kind': {'enum': ['provider', 'database', 'cache', 'computed', 'client_input', 'unavailable'], 'type': 'string'}, 'field': {'type': 'string'}, 'owner': {'type': 'string'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'TennisPoints': {'type': 'object', 'required': ['source', 'match_key', 'player_keys', 'points', 'source_revision', 'observed_at', 'expires_at', 'set_number', 'games'], 'properties': {'games': {'type': 'array', 'items': {'type': 'integer', 'minimum': 0}, 'maxItems': 2, 'minItems': 2}, 'points': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 2, 'minItems': 2}, 'source': {'enum': ['api_tennis'], 'type': 'string'}, 'match_key': {'type': 'integer'}, 'expires_at': {'type': 'string', 'format': 'date-time'}, 'set_number': {'type': 'integer', 'minimum': 1}, 'observed_at': {'type': 'string', 'format': 'date-time'}, 'player_keys': {'type': 'array', 'items': {'type': 'integer'}, 'maxItems': 2, 'minItems': 2}, 'serving_side': {'enum': ['first', 'second'], 'type': 'string'}, 'source_revision': {'type': 'integer', 'minimum': 1}}}, 'TrustMetadata': {'type': 'object', 'required': ['source', 'freshness', 'reconciliation', 'completeness'], 'properties': {'source': {'$ref': '#/$defs/TrustSource'}, 'freshness': {'$ref': '#/$defs/TrustFreshness'}, 'completeness': {'$ref': '#/$defs/TrustCompleteness'}, 'reconciliation': {'$ref': '#/$defs/TrustReconciliation'}}}, 'MarketSnapshot': {'type': 'object', 'required': ['market', 'outcomes', 'liquidity', 'sports', 'freshness'], 'properties': {'trust': {'$ref': '#/$defs/MarketSnapshotTrust'}, 'market': {'type': 'object', 'required': ['id', 'condition_id', 'provider', 'title', 'slug', 'page_slug', 'event_slug', 'category', 'status', 'description', 'image', 'series_slug', 'market_type', 'market_result', 'created_at', 'end_date', 'resolved_at'], 'properties': {'id': {'type': 'string'}, 'slug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'image': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'status': {'enum': ['active', 'closed'], 'type': 'string'}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'end_date': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}, 'provider': {'type': 'string'}, 'page_slug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'created_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}, 'event_slug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'description': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'market_type': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'resolved_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}, 'series_slug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'condition_id': {'type': 'string'}, 'market_result': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}}, 'sports': {'type': 'object', 'required': ['status', 'source'], 'properties': {'reason': {'type': 'string'}, 'source': {'type': 'string'}, 'status': {'enum': ['fresh', 'stale', 'not_live', 'unavailable'], 'type': 'string'}, 'live_score': {'allOf': [{'type': 'object'}, {'type': 'object', 'properties': {'tennis_points': {'$ref': '#/$defs/TennisPoints'}}}]}, 'live_match_key': {'type': 'string'}, 'live_league_key': {'type': 'string'}}}, 'outcomes': {'type': 'array', 'items': {'type': 'object', 'required': ['side', 'label', 'top_of_book'], 'properties': {'side': {'enum': ['yes', 'no'], 'type': 'string'}, 'label': {'type': 'string'}, 'token_id': {'type': 'string'}, 'top_of_book': {'$ref': '#/$defs/MarketSnapshotTopOfBook'}, 'current_price': {'type': 'number'}}}}, 'freshness': {'type': 'object', 'required': ['market_data', 'top_of_book', 'live_sports'], 'properties': {'live_sports': {'$ref': '#/$defs/MarketSnapshotFreshness'}, 'market_data': {'$ref': '#/$defs/MarketSnapshotFreshness'}, 'top_of_book': {'$ref': '#/$defs/MarketSnapshotFreshness'}}}, 'liquidity': {'type': 'object', 'required': ['source', 'volume_usd', 'liquidity_usd', 'volume_24h_usd', 'last_price'], 'properties': {'source': {'type': 'string'}, 'last_price': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'volume_usd': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'liquidity_usd': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'volume_24h_usd': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}}}}, 'TrustFreshness': {'type': 'object', 'required': ['status'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'status': {'enum': ['fresh', 'refreshing', 'stale', 'not_live', 'unknown', 'unavailable'], 'type': 'string'}, 'max_age_s': {'type': 'integer', 'minimum': 0}}}, 'TrustCompleteness': {'type': 'object', 'required': ['status'], 'properties': {'detail': {'type': 'string'}, 'status': {'enum': ['complete', 'partial', 'not_computed', 'not_applicable', 'unavailable'], 'type': 'string'}}}, 'MarketSnapshotTrust': {'type': 'object', 'required': ['current_price', 'spread_bps'], 'properties': {'spread_bps': {'$ref': '#/$defs/TrustMetadata'}, 'current_price': {'$ref': '#/$defs/TrustMetadata'}}}, 'TrustReconciliation': {'type': 'object', 'required': ['status'], 'properties': {'detail': {'type': 'string'}, 'status': {'enum': ['provider_backed', 'db_mirror', 'computed', 'partial', 'not_applicable', 'unavailable'], 'type': 'string'}}}, 'MarketSnapshotFreshness': {'type': 'object', 'required': ['status', 'source'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'reason': {'type': 'string'}, 'source': {'type': 'string'}, 'status': {'enum': ['fresh', 'stale', 'available', 'not_live', 'unavailable'], 'type': 'string'}, 'stale_after_s': {'type': 'integer'}}}, 'MarketSnapshotTopOfBook': {'type': 'object', 'required': ['status', 'source'], 'properties': {'reason': {'type': 'string'}, 'source': {'type': 'string'}, 'status': {'enum': ['available', 'unavailable'], 'type': 'string'}, 'best_ask': {'type': 'number'}, 'best_bid': {'type': 'number'}, 'spread_bps': {'type': 'integer'}, 'ask_depth_usdc': {'type': 'number'}, 'bid_depth_usdc': {'type': 'number'}}}}, 'anyOf': [{'allOf': [{'$ref': '#/$defs/MarketSnapshot'}, {'type': 'object', 'required': ['meta'], 'properties': {'meta': {'$ref': '#/$defs/ResponseMeta'}}}]}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_monthly_report_snapshot
Get Monthly Report Snapshot
Read one UTC monthly whale-activity report snapshot. Args: - month (string, required): UTC report month in YYYY-MM format Returns: Report snapshot metadata and entries.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['month'], 'properties': {'month': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}$', 'description': 'UTC report month in YYYY-MM format'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'ReportPayload': {'type': 'object', 'required': ['total_large_trades', 'total_whale_trades', 'total_large_trade_volume', 'total_whale_volume', 'biggest_trade_size', 'active_traders', 'top_large_trades', 'top_whale_trades', 'categories', 'grade_distribution'], 'properties': {'categories': {'anyOf': [{'type': 'array', 'items': {'type': 'object'}}, {'type': 'null'}]}, 'active_traders': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'top_large_trades': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'required': ['outcome', 'side', 'title', 'size', 'price', 'token_id', 'id', 'trade_time', 'market_category', 'platform', 'name', 'pseudonym', 'trader_grade'], 'properties': {'id': {'anyOf': [{'type': 'integer', 'format': 'int64'}, {'type': 'null'}]}, 'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'side': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'size': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'price': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'outcome': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'platform': {'anyOf': [{'enum': ['polymarket'], 'type': 'string'}, {'type': 'null'}]}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'pseudonym': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'trade_time': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}, 'trader_grade': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'market_category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}}}, {'type': 'null'}]}, 'top_whale_trades': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'required': ['outcome', 'side', 'title', 'size', 'price', 'token_id', 'id', 'trade_time', 'market_category', 'platform', 'name', 'pseudonym', 'trader_grade'], 'properties': {'id': {'anyOf': [{'type': 'integer', 'format': 'int64'}, {'type': 'null'}]}, 'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'side': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'size': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'price': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'outcome': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'platform': {'anyOf': [{'enum': ['polymarket'], 'type': 'string'}, {'type': 'null'}]}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'pseudonym': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'trade_time': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}, 'trader_grade': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'market_category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}}}, {'type': 'null'}]}, 'biggest_trade_size': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'grade_distribution': {'anyOf': [{'type': 'array', 'items': {'type': 'object'}}, {'type': 'null'}]}, 'total_large_trades': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'total_whale_trades': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'total_whale_volume': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'total_large_trade_volume': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}}, 'SnapshotState': {'type': 'object', 'required': ['version', 'storage', 'status', 'generated_at', 'mutable_until', 'period_closed', 'final_after', 'source_read_started_at'], 'properties': {'status': {'enum': ['final', 'rolling'], 'type': 'string'}, 'storage': {'enum': ['durable', 'ephemeral'], 'type': 'string'}, 'version': {'type': 'integer', 'format': 'int64'}, 'final_after': {'type': 'string', 'format': 'date-time'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'mutable_until': {'anyOf': [{'type': 'string', 'format': 'date'}, {'type': 'null'}]}, 'period_closed': {'type': 'boolean'}, 'source_read_started_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}}}, 'ReportSnapshot': {'type': 'object', 'required': ['kind', 'generated_at', 'source_range', 'snapshot', 'completeness', 'reconciliation', 'report'], 'properties': {'kind': {'enum': ['daily', 'weekly', 'monthly'], 'type': 'string'}, 'report': {'$ref': '#/$defs/ReportPayload'}, 'snapshot': {'$ref': '#/$defs/SnapshotState'}, 'completeness': {'$ref': '#/$defs/SnapshotCompleteness'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'source_range': {'$ref': '#/$defs/ReportSourceRange'}, 'reconciliation': {'$ref': '#/$defs/ReportReconciliation'}}}, 'ReportSourceRange': {'type': 'object', 'required': ['start_date', 'end_date', 'timezone'], 'properties': {'end_date': {'type': 'string', 'format': 'date'}, 'timezone': {'type': 'string', 'const': 'UTC'}, 'start_date': {'type': 'string', 'format': 'date'}}}, 'ReportReconciliation': {'type': 'object', 'required': ['volume_kind', 'whale_volume_source', 'notes'], 'properties': {'notes': {'type': 'string'}, 'volume_kind': {'type': 'string', 'const': 'local_whale_activity_volume'}, 'whale_volume_source': {'type': 'string'}}}, 'SnapshotCompleteness': {'type': 'object', 'required': ['status', 'reason', 'expected_days', 'covered_days_with_whale_activity'], 'properties': {'reason': {'type': 'string'}, 'status': {'enum': ['complete', 'partial', 'empty'], 'type': 'string'}, 'expected_days': {'type': 'integer'}, 'covered_days_with_whale_activity': {'type': 'integer'}, 'covered_days_with_large_trade_activity': {'type': 'integer'}}}}, 'anyOf': [{'allOf': [{'$ref': '#/$defs/ReportSnapshot'}, {'type': 'object', 'required': ['meta'], 'properties': {'meta': {'$ref': '#/$defs/ResponseMeta'}}}]}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_pick_of_the_day
Get Pick of the Day
Get today's published Pick of the Day: the sports markets where graded (S/A/B) sharp money is positioned, frozen at publish time. Pro-tier. Read `picks` in `publication_order` order; use stable decimal-string `pick_id` for identity, not the deprecated `pick_rank`. `is_free_selection` designates account access; `supersedes_pick_id` names a replaced pick (up to fifteen items; thin days carry fewer). Each pick carries the matchup, the backed side (pick_outcome_label), the frozen pre-game price and the return on the flat $1,000 stake (`stake_usd`, `return_usd`; `return_per_100` keeps the literal $100 basis), the sharp-money holders on that side, the top grade, CLV capture status, and the thesis. `scheduled_picks` lists today's selected-but-unreleased slots with only pick_rank, release_at, and kickoff; no market identity exists before release. Before any pick is released the tool returns an error carrying reason pick_not_released and a retry_at instant: schedule the next read from retry_at (or the earliest scheduled_picks.release_at) instead of polling. A current-day pick whose holder proof is not readable yet is listed in `proof_pending_picks` (pick_rank, release_at, kickoff, retry_at) while `picks` carries the proof-readable picks; the tool returns read_model_warming with a retry only when no published pick has readable proof. Args: none Returns: The published pick set for the current product day (America/New_York), or a pick_not_released error with retry_at.
Read only Idempotent
Input schema 
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'ScoreCell': {'type': 'object', 'required': ['games'], 'properties': {'games': {'type': 'integer'}, 'tiebreak': {'type': 'integer'}}}, 'PickHolder': {'type': 'object', 'required': ['address', 'name', 'grade', 'last_traded_at', 'shares'], 'properties': {'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'grade': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'is_bot': {'type': 'boolean'}, 'shares': {'type': 'number'}, 'address': {'type': 'string'}, 'x_username': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'is_new_wallet': {'type': 'boolean'}, 'last_traded_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}, 'markets_traded': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'entry_value_usd': {'type': 'number'}, 'profile_segment': {'type': 'string'}, 'wallet_age_days': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'category_win_rate': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'category_win_record': {'type': 'object', 'required': ['wins', 'decided'], 'properties': {'wins': {'type': 'integer', 'minimum': 0}, 'decided': {'type': 'integer', 'minimum': 0}}}, 'category_win_rate_game': {'type': 'string'}, 'category_win_rate_status': {'enum': ['measured', 'not_enough_data', 'unavailable'], 'type': 'string'}}}, 'ScoreFormat': {'enum': ['two_side', 'multi_set', 'esports_series'], 'type': 'string'}, 'PickOfTheDay': {'type': 'object', 'required': ['state', 'supersedes_pick_id'], 'properties': {'picks': {'type': 'array', 'items': {'$ref': '#/$defs/PickOfTheDay'}}, 'state': {'enum': ['full'], 'type': 'string'}, 'thesis': {'type': 'string'}, 'clv_pct': {'type': 'number'}, 'holders': {'type': 'array', 'items': {'$ref': '#/$defs/PickHolder'}}, 'matchup': {'type': 'string'}, 'outcome': {'enum': ['pending', 'win', 'loss', 'void'], 'type': 'string'}, 'pick_id': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'traders': {'type': 'integer'}, 'category': {'type': 'string'}, 'platform': {'enum': ['polymarket'], 'type': 'string'}, 'position': {'type': 'string'}, 'token_id': {'type': 'string'}, 'clv_basis': {'type': 'string'}, 'is_locked': {'type': 'boolean'}, 'pick_date': {'type': 'string', 'format': 'date'}, 'pick_rank': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'deprecated': True}, 'sharp_pct': {'type': 'number'}, 'sharp_usd': {'type': 'number'}, 'smart_usd': {'type': 'number', 'deprecated': True}, 'stake_usd': {'type': 'number'}, 'top_grade': {'type': 'string'}, 'clv_status': {'type': 'string'}, 'disclaimer': {'type': 'string'}, 'event_slug': {'type': 'string'}, 'game_ended': {'type': 'boolean'}, 'market_pct': {'type': 'number'}, 'market_url': {'type': 'string'}, 'pick_count': {'type': 'integer', 'maximum': 10, 'minimum': 1}, 'release_at': {'type': 'string', 'format': 'date-time'}, 'return_usd': {'type': 'number'}, 'unit_score': {'type': 'number'}, 'clv_display': {'type': 'string'}, 'backed_price': {'type': 'number'}, 'game_started': {'type': 'boolean'}, 'holder_count': {'type': 'integer'}, 'odds_display': {'type': 'string'}, 'side_summary': {'type': 'string'}, 'editorial_note': {'type': 'string'}, 'payout_display': {'type': 'string'}, 'polymarket_url': {'type': 'string'}, 'profit_display': {'type': 'string'}, 'return_per_100': {'type': 'number'}, 'sports_context': {'allOf': [{'$ref': '#/$defs/PickSportsContext'}]}, 'clv_explanation': {'type': 'string'}, 'display_holders': {'type': 'array', 'items': {'$ref': '#/$defs/PickHolder'}}, 'event_link_slug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'outcome_display': {'type': 'string'}, 'scheduled_picks': {'type': 'array', 'items': {'$ref': '#/$defs/ScheduledPickSlot'}}, 'backed_sharp_usd': {'type': 'number'}, 'display_category': {'type': 'string'}, 'entry_price_note': {'type': 'string'}, 'is_free_selection': {'type': 'boolean'}, 'publication_order': {'type': 'integer'}, 'qualifying_expert': {'type': 'object', 'required': ['address', 'name', 'grade', 'canonical_category', 'win_rate', 'n_resolved', 'position_usd', 'stats_computed_at'], 'properties': {'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'grade': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'address': {'type': 'string'}, 'win_rate': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'n_resolved': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'position_usd': {'type': 'number'}, 'stats_computed_at': {'type': 'string', 'format': 'date-time'}, 'canonical_category': {'type': 'string'}, 'opposite_position_usd': {'type': 'number'}}}, 'pick_outcome_label': {'type': 'string'}, 'sharp_wallet_count': {'type': 'integer'}, 'smart_wallet_count': {'type': 'integer', 'deprecated': True}, 'supersedes_pick_id': {'anyOf': [{'type': 'string', 'pattern': '^[1-9][0-9]*$'}, {'type': 'null'}]}, 'unit_score_display': {'type': 'string'}, 'entry_authorization': {'$ref': '#/$defs/PotdEntryAuthorization'}, 'proof_pending_picks': {'type': 'array', 'items': {'$ref': '#/$defs/ProofPendingPickSlot'}}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'PickSportsTeam': {'type': 'object', 'required': ['label', 'short_label', 'full_name', 'provider_id', 'logo', 'logo_mark_dark', 'color', 'record', 'score'], 'properties': {'logo': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'sets': {'type': 'array', 'items': {'$ref': '#/$defs/ScoreCell'}}, 'tour': {'enum': ['atp', 'wta', 'itf'], 'type': 'string'}, 'color': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'label': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'score': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'format': {'$ref': '#/$defs/ScoreFormat'}, 'record': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'headshot': {'type': 'string'}, 'sets_won': {'type': 'integer'}, 'full_name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'provider_id': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'short_label': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'logo_mark_dark': {'type': 'boolean'}, 'headshot_revision': {'type': 'integer', 'format': 'int64', 'minimum': 0}}}, 'PickSportsContext': {'type': 'object', 'required': ['league_name', 'league_logo', 'yes_team', 'no_team', 'event_matchup'], 'properties': {'game_id': {'type': 'integer'}, 'no_team': {'anyOf': [{'allOf': [{'$ref': '#/$defs/PickSportsTeam'}]}, {'type': 'null'}]}, 'yes_team': {'anyOf': [{'allOf': [{'$ref': '#/$defs/PickSportsTeam'}]}, {'type': 'null'}]}, 'league_logo': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'league_name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'event_matchup': {'type': 'boolean'}, 'matchup_title': {'type': 'string'}, 'competition_label': {'type': 'string'}, 'event_subject_team': {'allOf': [{'$ref': '#/$defs/PickSportsTeam'}]}}}, 'ScheduledPickSlot': {'type': 'object', 'required': ['pick_rank', 'release_at', 'kickoff', 'pick_id', 'publication_order', 'is_free_selection', 'supersedes_pick_id'], 'properties': {'kickoff': {'type': 'string', 'format': 'date-time'}, 'pick_id': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'pick_rank': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'deprecated': True}, 'release_at': {'type': 'string', 'format': 'date-time'}, 'is_free_selection': {'type': 'boolean'}, 'publication_order': {'type': 'integer'}, 'supersedes_pick_id': {'anyOf': [{'type': 'string', 'pattern': '^[1-9][0-9]*$'}, {'type': 'null'}]}}}, 'ProofPendingPickSlot': {'type': 'object', 'required': ['pick_rank', 'release_at', 'retry_at', 'pick_id', 'publication_order', 'is_free_selection', 'supersedes_pick_id'], 'properties': {'kickoff': {'type': 'string', 'format': 'date-time'}, 'pick_id': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'retry_at': {'type': 'string', 'format': 'date-time'}, 'pick_rank': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'deprecated': True}, 'release_at': {'type': 'string', 'format': 'date-time'}, 'is_free_selection': {'type': 'boolean'}, 'publication_order': {'type': 'integer'}, 'supersedes_pick_id': {'anyOf': [{'type': 'string', 'pattern': '^[1-9][0-9]*$'}, {'type': 'null'}]}}}, 'PotdEntryAuthorization': {'type': 'object', 'required': ['version', 'authorization_id', 'policy_version', 'condition_id', 'token_id', 'outcome_index', 'category', 'canonical_event_id', 'max_entry_price', 'reference_best_ask', 'reference_book_hash', 'reference_book_at', 'issued_at', 'expires_at'], 'properties': {'version': {'enum': [1], 'type': 'integer'}, 'category': {'type': 'string'}, 'token_id': {'type': 'string'}, 'issued_at': {'type': 'string', 'format': 'date-time'}, 'expires_at': {'type': 'string', 'format': 'date-time'}, 'condition_id': {'type': 'string'}, 'outcome_index': {'enum': [0, 1], 'type': 'integer'}, 'policy_version': {'enum': [7], 'type': 'integer'}, 'max_entry_price': {'type': 'string'}, 'authorization_id': {'type': 'string', 'format': 'uuid'}, 'reference_book_at': {'type': 'string', 'format': 'date-time'}, 'canonical_event_id': {'type': 'string'}, 'reference_best_ask': {'type': 'string'}, 'reference_book_hash': {'type': 'string'}}}}, 'anyOf': [{'allOf': [{'$ref': '#/$defs/PickOfTheDay'}, {'type': 'object', 'required': ['meta'], 'properties': {'meta': {'$ref': '#/$defs/ResponseMeta'}}}]}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_pick_of_the_day_archive
Get Pick of the Day Archive
Get the complete Pick of the Day track record: every published pick with its settled outcome (win, loss, void, or pending), the frozen backed price, unit score, and CLV fields, plus the rolling hit rate (wins / decided; void and pending excluded) and the flat-$1,000-stake profit and ROI (`hit_rate.stake_usd` names the stake). Pro-tier. A published pick is never deleted, re-pointed, or re-priced, so the archive is the whole record, losses included. Resolved picks are public on the web; a still-pending pick's backed side is included here because the API key proves Pro. Args: none Returns: picks[] newest first with outcome and CLV fields, plus the aggregate record (hit_rate, decided, wins, losses, voids, profit, roi, total risked).
Read only Idempotent
Input schema 
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'PickOfTheDayArchive': {'type': 'object', 'required': ['picks', 'days', 'hit_rate'], 'properties': {'days': {'type': 'array', 'items': {'$ref': '#/$defs/PickOfTheDayArchiveDay'}}, 'picks': {'type': 'array', 'items': {'$ref': '#/$defs/PickOfTheDayArchiveEntry'}}, 'hit_rate': {'$ref': '#/$defs/PickOfTheDayHitRate'}}}, 'PickOfTheDayHitRate': {'type': 'object', 'required': ['wins', 'losses', 'decided', 'pct', 'void', 'pending', 'net_profit_usd', 'staked_usd', 'roi_pct', 'net_profit_display', 'roi_display', 'win_rate_display', 'clv_eligible', 'clv_total', 'clv_measured', 'clv_applicable', 'clv_not_applicable', 'clv_pending', 'clv_unavailable', 'clv_state', 'clv_beats_close', 'clv_ties'], 'properties': {'pct': {'type': 'number'}, 'void': {'type': 'integer'}, 'wins': {'type': 'integer'}, 'losses': {'type': 'integer'}, 'series': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'net_profit_usd', 'hit_rate_pct'], 'properties': {'date': {'type': 'string', 'format': 'date'}, 'hit_rate_pct': {'type': 'number'}, 'net_profit_usd': {'type': 'number'}}}}, 'decided': {'type': 'integer'}, 'pending': {'type': 'integer'}, 'roi_pct': {'type': 'number'}, 'clv_ties': {'type': 'integer'}, 'clv_state': {'enum': ['measured', 'pending', 'unavailable', 'not_applicable', 'none'], 'type': 'string'}, 'clv_total': {'type': 'integer'}, 'stake_usd': {'type': 'number'}, 'clv_avg_pp': {'type': 'number'}, 'staked_usd': {'type': 'number'}, 'unit_score': {'type': 'number'}, 'clv_avg_pct': {'type': 'number'}, 'clv_pending': {'type': 'integer'}, 'roi_display': {'type': 'string'}, 'clv_eligible': {'type': 'integer'}, 'clv_measured': {'type': 'integer'}, 'clv_applicable': {'type': 'integer'}, 'net_profit_usd': {'type': 'number'}, 'clv_avg_display': {'type': 'string'}, 'clv_beats_close': {'type': 'integer'}, 'clv_unavailable': {'type': 'integer'}, 'clv_coverage_pct': {'type': 'number'}, 'win_rate_display': {'type': 'string'}, 'clv_avg_pp_display': {'type': 'string'}, 'clv_not_applicable': {'type': 'integer'}, 'net_profit_display': {'type': 'string'}, 'unit_score_display': {'type': 'string'}, 'clv_coverage_display': {'type': 'string'}, 'clv_coverage_explanation': {'type': 'string'}}}, 'PickOfTheDayArchiveDay': {'type': 'object', 'required': ['date', 'picks', 'wins', 'losses', 'void', 'pending'], 'properties': {'date': {'type': 'string', 'format': 'date'}, 'void': {'type': 'integer', 'minimum': 0}, 'wins': {'type': 'integer', 'minimum': 0}, 'picks': {'type': 'integer', 'minimum': 1}, 'sweep': {'enum': ['win', 'loss'], 'type': 'string'}, 'losses': {'type': 'integer', 'minimum': 0}, 'pending': {'type': 'integer', 'minimum': 0}, 'unit_score': {'type': 'number', 'format': 'double'}, 'unit_score_display': {'type': 'string'}}}, 'PickOfTheDayArchiveEntry': {'type': 'object', 'required': ['pick_date', 'matchup', 'category', 'outcome', 'pick_id', 'publication_order', 'is_free_selection', 'supersedes_pick_id'], 'properties': {'clv_pct': {'type': 'number'}, 'matchup': {'type': 'string'}, 'outcome': {'enum': ['pending', 'win', 'loss', 'void'], 'type': 'string'}, 'pick_id': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'category': {'type': 'string'}, 'clv_basis': {'type': 'string'}, 'image_url': {'type': 'string'}, 'pick_date': {'type': 'string', 'format': 'date'}, 'pick_rank': {'type': 'integer', 'maximum': 10, 'minimum': 1, 'deprecated': True}, 'stake_usd': {'type': 'number'}, 'top_grade': {'type': 'string'}, 'clv_status': {'type': 'string'}, 'return_usd': {'type': 'number'}, 'unit_score': {'type': 'number'}, 'clv_display': {'type': 'string'}, 'resolved_at': {'type': 'string', 'format': 'date-time'}, 'backed_price': {'type': 'number'}, 'published_at': {'type': 'string', 'format': 'date-time'}, 'payout_display': {'type': 'string'}, 'return_per_100': {'type': 'number'}, 'clv_close_price': {'type': 'number'}, 'clv_entry_price': {'type': 'number'}, 'clv_explanation': {'type': 'string'}, 'outcome_display': {'type': 'string'}, 'display_category': {'type': 'string'}, 'clv_applicability': {'enum': ['applicable', 'not_applicable'], 'type': 'string'}, 'is_free_selection': {'type': 'boolean'}, 'publication_order': {'type': 'integer'}, 'pick_outcome_label': {'type': 'string'}, 'supersedes_pick_id': {'anyOf': [{'type': 'string', 'pattern': '^[1-9][0-9]*$'}, {'type': 'null'}]}, 'unit_score_display': {'type': 'string'}}}}, 'anyOf': [{'allOf': [{'$ref': '#/$defs/PickOfTheDayArchive'}, {'type': 'object', 'required': ['meta'], 'properties': {'meta': {'$ref': '#/$defs/ResponseMeta'}}}]}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_pick_of_the_day_ledger_entry
Get Pick of the Day Proof
Read one published pick's sealed, opened or uncommitted ledger entry by its stable decimal-string pick_id. commitment_version explicitly selects version 1 legacy proofs or version 2 rank-free proofs. Never infer a proof format from dates or reorder canonical bytes. Pending proofs withhold the backed side and nonce. This tool requires the usual authenticated MCP tools/call transport; the corresponding REST read is public.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['pick_id'], 'properties': {'pick_id': {'type': 'string', 'pattern': '^[1-9][0-9]*$', 'description': 'Stable positive database row id as decimal text'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'PickOfTheDayLedgerEntry': {'oneOf': [{'$ref': '#/$defs/PickOfTheDayLedgerSealedEntry'}, {'$ref': '#/$defs/PickOfTheDayLedgerOpenedEntry'}, {'$ref': '#/$defs/PickOfTheDayLedgerUncommittedEntry'}], 'discriminator': {'mapping': {'opened': '#/components/schemas/PickOfTheDayLedgerOpenedEntry', 'sealed': '#/components/schemas/PickOfTheDayLedgerSealedEntry', 'uncommitted': '#/components/schemas/PickOfTheDayLedgerUncommittedEntry'}, 'propertyName': 'state'}}, 'PickOfTheDayCommitmentPayload': {'oneOf': [{'$ref': '#/$defs/PickOfTheDayCommitmentPayloadV1'}, {'$ref': '#/$defs/PickOfTheDayCommitmentPayloadV2'}]}, 'PickOfTheDayLedgerOpenedEntry': {'type': 'object', 'required': ['state', 'pick_date', 'pick_rank', 'commitment_hash', 'commitment_nonce', 'commitment_algo', 'sealed_at', 'resolved_at', 'kickoff', 'payload', 'outcome', 'matchup', 'category', 'permalink', 'pick_id', 'publication_order', 'is_free_selection', 'supersedes_pick_id', 'commitment_version'], 'properties': {'state': {'type': 'string', 'const': 'opened'}, 'kickoff': {'type': 'string', 'format': 'date-time'}, 'matchup': {'type': 'string'}, 'outcome': {'enum': ['win', 'loss', 'void'], 'type': 'string'}, 'payload': {'$ref': '#/$defs/PickOfTheDayCommitmentPayload'}, 'pick_id': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'category': {'type': 'string'}, 'permalink': {'type': 'string', 'format': 'uri'}, 'pick_date': {'type': 'string', 'format': 'date'}, 'pick_rank': {'type': 'integer', 'deprecated': True}, 'sealed_at': {'type': 'string', 'format': 'date-time'}, 'resolved_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'commitment_algo': {'type': 'string', 'const': 'sha256(canonical_json(payload)||nonce)'}, 'commitment_hash': {'type': 'string'}, 'commitment_nonce': {'type': 'string'}, 'is_free_selection': {'type': 'boolean'}, 'publication_order': {'type': 'integer'}, 'commitment_version': {'enum': [1, 2], 'type': 'integer'}, 'supersedes_pick_id': {'anyOf': [{'type': 'string', 'pattern': '^[1-9][0-9]*$'}, {'type': 'null'}]}}}, 'PickOfTheDayLedgerSealedEntry': {'type': 'object', 'required': ['state', 'pick_date', 'pick_rank', 'commitment_hash', 'commitment_algo', 'sealed_at', 'kickoff', 'permalink', 'pick_id', 'publication_order', 'is_free_selection', 'supersedes_pick_id', 'commitment_version'], 'properties': {'state': {'type': 'string', 'const': 'sealed'}, 'kickoff': {'type': 'string', 'format': 'date-time'}, 'pick_id': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'permalink': {'type': 'string', 'format': 'uri'}, 'pick_date': {'type': 'string', 'format': 'date'}, 'pick_rank': {'type': 'integer', 'deprecated': True}, 'sealed_at': {'type': 'string', 'format': 'date-time'}, 'commitment_algo': {'type': 'string', 'const': 'sha256(canonical_json(payload)||nonce)'}, 'commitment_hash': {'type': 'string'}, 'is_free_selection': {'type': 'boolean'}, 'publication_order': {'type': 'integer'}, 'commitment_version': {'enum': [1, 2], 'type': 'integer'}, 'supersedes_pick_id': {'anyOf': [{'type': 'string', 'pattern': '^[1-9][0-9]*$'}, {'type': 'null'}]}}}, 'PickOfTheDayUncommittedPayload': {'type': 'object', 'required': ['backed_price', 'condition_id', 'kickoff', 'pick_date', 'pick_outcome_index', 'pick_outcome_label', 'pick_rank', 'platform'], 'properties': {'kickoff': {'type': ['string', 'null'], 'format': 'date-time'}, 'platform': {'enum': ['polymarket'], 'type': 'string'}, 'pick_date': {'type': 'string', 'format': 'date'}, 'pick_rank': {'type': 'integer'}, 'backed_price': {'type': 'string'}, 'condition_id': {'type': 'string'}, 'pick_outcome_index': {'enum': [0, 1], 'type': 'integer'}, 'pick_outcome_label': {'type': 'string'}}}, 'PickOfTheDayCommitmentPayloadV1': {'type': 'object', 'required': ['backed_price', 'condition_id', 'kickoff', 'pick_date', 'pick_outcome_index', 'pick_outcome_label', 'pick_rank', 'platform'], 'properties': {'kickoff': {'type': 'string', 'format': 'date-time'}, 'platform': {'enum': ['polymarket'], 'type': 'string'}, 'pick_date': {'type': 'string', 'format': 'date'}, 'pick_rank': {'type': 'integer'}, 'backed_price': {'type': 'string'}, 'condition_id': {'type': 'string'}, 'pick_outcome_index': {'enum': [0, 1], 'type': 'integer'}, 'pick_outcome_label': {'type': 'string'}}}, 'PickOfTheDayCommitmentPayloadV2': {'type': 'object', 'required': ['backed_price', 'condition_id', 'kickoff', 'pick_date', 'pick_outcome_index', 'pick_outcome_label', 'platform', 'pick_id', 'version'], 'properties': {'kickoff': {'type': 'string', 'format': 'date-time'}, 'pick_id': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'version': {'type': 'integer', 'const': 2}, 'platform': {'enum': ['polymarket'], 'type': 'string'}, 'pick_date': {'type': 'string', 'format': 'date'}, 'backed_price': {'type': 'string'}, 'condition_id': {'type': 'string'}, 'pick_outcome_index': {'enum': [0, 1], 'type': 'integer'}, 'pick_outcome_label': {'type': 'string'}}}, 'PickOfTheDayLedgerUncommittedEntry': {'type': 'object', 'required': ['state', 'pick_date', 'pick_rank', 'pre_commitment', 'outcome', 'matchup', 'category', 'resolved_at', 'payload', 'permalink', 'pick_id', 'publication_order', 'is_free_selection', 'supersedes_pick_id'], 'properties': {'state': {'type': 'string', 'const': 'uncommitted'}, 'matchup': {'type': 'string'}, 'outcome': {'enum': ['pending', 'win', 'loss', 'void'], 'type': 'string'}, 'payload': {'anyOf': [{'oneOf': [{'$ref': '#/$defs/PickOfTheDayUncommittedPayload'}, {'type': 'null'}]}, {'type': 'null'}]}, 'pick_id': {'type': 'string', 'pattern': '^[1-9][0-9]*$'}, 'category': {'type': 'string'}, 'permalink': {'type': 'string', 'format': 'uri'}, 'pick_date': {'type': 'string', 'format': 'date'}, 'pick_rank': {'type': 'integer', 'deprecated': True}, 'resolved_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'pre_commitment': {'type': 'boolean', 'const': True}, 'is_free_selection': {'type': 'boolean'}, 'publication_order': {'type': 'integer'}, 'supersedes_pick_id': {'anyOf': [{'type': 'string', 'pattern': '^[1-9][0-9]*$'}, {'type': 'null'}]}}}}, 'anyOf': [{'allOf': [{'$ref': '#/$defs/PickOfTheDayLedgerEntry'}, {'type': 'object', 'required': ['meta'], 'properties': {'meta': {'$ref': '#/$defs/ResponseMeta'}}}]}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_platforms
Get Platform Capability Matrix
Deprecated alias of get_coverage (#16315), kept live; it calls the deprecated /api/v1/platforms path, which serves the same body. Read which V1 data surfaces the API serves for Polymarket, the one venue it covers. Every surface reports the status supported: grade, pnl, strategy, timeline, large_trades, whale_signal (the deprecated spelling of large_trades), suspicious_trades, insider_radar (the deprecated spelling of suspicious_trades), and market_snapshot. Use this before choosing trader, market, large-trade, or suspicious-trade routes. Args: none Returns: Static backend-owned coverage document under the single key polymarket.
Read only Idempotent
Input schema 
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'Platforms': {'type': 'object', 'required': ['platforms'], 'properties': {'platforms': {'type': 'object', 'required': ['polymarket'], 'properties': {'polymarket': {'$ref': '#/$defs/PlatformCapabilities'}}}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'PlatformCapabilities': {'type': 'object', 'required': ['grade', 'pnl', 'strategy', 'timeline', 'large_trades', 'whale_signal', 'suspicious_trades', 'insider_radar', 'market_snapshot'], 'properties': {'pnl': {'$ref': '#/$defs/PlatformCapabilityStatus'}, 'grade': {'$ref': '#/$defs/PlatformCapabilityStatus'}, 'strategy': {'$ref': '#/$defs/PlatformCapabilityStatus'}, 'timeline': {'$ref': '#/$defs/PlatformCapabilityStatus'}, 'large_trades': {'$ref': '#/$defs/PlatformCapabilityStatus'}, 'whale_signal': {'$ref': '#/$defs/PlatformCapabilityStatus'}, 'insider_radar': {'$ref': '#/$defs/PlatformCapabilityStatus'}, 'market_snapshot': {'$ref': '#/$defs/PlatformCapabilityStatus'}, 'suspicious_trades': {'$ref': '#/$defs/PlatformCapabilityStatus'}}}, 'PlatformCapabilityStatus': {'enum': ['supported'], 'type': 'string'}}, 'anyOf': [{'allOf': [{'$ref': '#/$defs/Platforms'}, {'type': 'object', 'required': ['meta'], 'properties': {'meta': {'$ref': '#/$defs/ResponseMeta'}}}]}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_positions
List Current Positions
List current prediction-market positions from the public positions-board feed. Returns trader, market, value, side, share, P&L, and freshness context. Cursor-paginated by current value descending. Args: - limit (number, 1-100, default 20): Max results per page - cursor (string, optional): Pagination cursor from previous response - min_size (number, optional): Minimum current value in USD; defaults to 100, or to 0 when wallet is present; send 0 for every reconciled position - category (string, optional): Filter by provider-backed market category - condition_id (string, optional): Scope to one market: raw provider condition_id or mkt_-prefixed market id - wallet (string[], optional): Scope to one wallet or a book of wallets (up to 25); each value is a wallet address, known username, or trd_-prefixed trader id - min_grade (string, optional): Minimum trader grade (S, A, B, C, D, F) - side (string, optional): Filter by binary side: "yes" or "no" - consistency (string, optional): live (default) or snapshot. snapshot requires wallet and freezes up to 500 positions and 2 MB for up to five minutes; repeat the same filters and consistency on every page. A new first page replaces the API key's prior snapshot; a changed filter errors, and an expired or replaced cursor returns cursor_expired Returns: List of current positions with pagination metadata. The page carries data_quality beside data: status, as_of (the oldest clock the page rests on) and field_groups. fresh means tracked and clocked, not current: compare as_of with your own tolerance. unknown means this read cannot date that group, never that it is recent. With consistency=snapshot, the page also carries snapshot: as_of, expires_at, row_count.
Read only Idempotent
Input schema 
{'type': 'object', 'properties': {'side': {'enum': ['yes', 'no'], 'type': 'string', 'description': 'Filter by binary outcome side'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Max results (1-100, default 20)'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor from previous response'}, 'wallet': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 25, 'description': 'Scope to one wallet or a book of wallets (up to 25). Each value is a wallet address, a known username, or a trd_-prefixed trader id, resolved like get_trader'}, 'category': {'type': 'string', 'description': 'Filter by provider-backed market category'}, 'min_size': {'type': 'number', 'minimum': 0, 'description': 'Minimum current position value in USD; defaults to 100, or to 0 when wallet is present'}, 'min_grade': {'enum': ['S', 'A', 'B', 'C', 'D', 'F'], 'type': 'string', 'description': 'Minimum trader grade'}, 'consistency': {'enum': ['live', 'snapshot'], 'type': 'string', 'default': 'live', 'description': 'live (default) reads the current value-ordered board. snapshot requires wallet and freezes up to 500 matching rows and 2 MB for up to five minutes; repeat the same filters and consistency on every page. A new first page from the same API key replaces its prior snapshot; a changed filter returns an error, and an expired or replaced cursor returns cursor_expired'}, 'condition_id': {'type': 'string', 'description': 'Scope to one market: raw provider condition_id or mkt_-prefixed market id'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'Position': {'type': 'object', 'required': ['id', 'platform', 'wallet', 'side', 'token_id', 'shares', 'current_value_usd', 'freshness', 'trader', 'market'], 'properties': {'id': {'type': 'string'}, 'side': {'enum': ['YES', 'NO'], 'type': 'string'}, 'exact': {'$ref': '#/$defs/PositionExact'}, 'market': {'type': 'object', 'required': ['id', 'condition_id', 'title'], 'properties': {'id': {'type': 'string'}, 'slug': {'type': 'string'}, 'title': {'type': 'string'}, 'category': {'type': 'string'}, 'end_date': {'type': 'string', 'format': 'date-time'}, 'event_slug': {'type': 'string'}, 'condition_id': {'type': 'string'}, 'outcome_label': {'type': 'string'}}}, 'shares': {'type': 'number'}, 'trader': {'type': 'object', 'required': ['id', 'address', 'is_new_wallet'], 'properties': {'id': {'type': 'string'}, 'pnl': {'type': 'number'}, 'grade': {'enum': ['S', 'A', 'B', 'C', 'D', 'F'], 'type': 'string'}, 'address': {'type': 'string'}, 'markets': {'type': 'integer'}, 'username': {'type': 'string'}, 'win_rate': {'type': 'number'}, 'is_new_wallet': {'type': 'boolean'}, 'wallet_age_days': {'type': 'number'}}}, 'wallet': {'type': 'string'}, 'cash_pnl': {'type': 'number'}, 'platform': {'enum': ['polymarket'], 'type': 'string'}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'avg_price': {'type': 'number'}, 'freshness': {'enum': ['fresh', 'refreshing', 'stale', 'unknown'], 'type': 'string'}, 'realized_pnl': {'type': 'number'}, 'current_value_usd': {'type': 'number'}, 'initial_value_usd': {'type': 'number'}, 'last_reconciled_at': {'type': 'string', 'format': 'date-time'}}}, 'DataQuality': {'type': 'object', 'required': ['status', 'field_groups'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'status': {'enum': ['fresh', 'partial', 'unknown', 'untracked', 'unavailable'], 'type': 'string'}, 'field_groups': {'type': 'array', 'items': {'$ref': '#/$defs/DataQualityGroup'}}}}, 'ExactDecimal': {'type': 'object', 'required': ['value', 'unit', 'scale', 'basis'], 'properties': {'unit': {'type': 'string'}, 'basis': {'type': 'string'}, 'scale': {'type': 'integer', 'minimum': 0}, 'value': {'type': 'string', 'pattern': '^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'PositionExact': {'type': 'object', 'required': ['shares', 'current_value_usd'], 'properties': {'shares': {'$ref': '#/$defs/ExactDecimal'}, 'cash_pnl': {'$ref': '#/$defs/ExactDecimal'}, 'avg_price': {'$ref': '#/$defs/ExactDecimal'}, 'realized_pnl': {'$ref': '#/$defs/ExactDecimal'}, 'cost_basis_usd': {'$ref': '#/$defs/ExactDecimal'}, 'current_value_usd': {'$ref': '#/$defs/ExactDecimal'}, 'initial_value_usd': {'$ref': '#/$defs/ExactDecimal'}}}, 'DataQualityGroup': {'type': 'object', 'required': ['group', 'owner', 'status'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'group': {'type': 'string'}, 'owner': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'enum': ['fresh', 'partial', 'unknown', 'untracked', 'unavailable'], 'type': 'string'}}}}, 'anyOf': [{'type': 'object', 'required': ['data', 'has_more', 'next_cursor', 'data_quality', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Position'}}, 'meta': {'$ref': '#/$defs/ResponseMeta'}, 'total': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'snapshot': {'type': 'object', 'required': ['as_of', 'expires_at', 'row_count'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'row_count': {'type': 'integer'}, 'expires_at': {'type': 'string', 'format': 'date-time'}}}, 'next_cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'data_quality': {'$ref': '#/$defs/DataQuality'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_position_timeline
Get Position Timeline
Get stored Polymarket fills available for one tracked trader in one market, newest first, with server-computed running_amount and running_avg_price. The REST identity accepts a 0x wallet, username, trd_-prefixed trader id, or bare integer traders.id with precedence wallet, trd_, integer, then username. Only HOT and WARM tier traders are tracked. Args: - condition_id (string, required): Market condition ID - address (string, optional): Any supported REST trader identity, including a bare integer traders.id - trader_id (number, optional): Convenience alias for a bare integer traders.id; provide exactly one of address or trader_id - limit (number, 1-100, default 20): Max events per page - cursor (string, optional): Pagination cursor from previous response Returns: List of position timeline events with pagination metadata.
Read only Idempotent
Input schema 
{'type': 'object', 'oneOf': [{'not': {'required': ['trader_id']}, 'required': ['address']}, {'not': {'required': ['address']}, 'required': ['trader_id']}], 'required': ['condition_id'], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Max events (1-100, default 20)'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor from previous response'}, 'address': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Trader identity: 0x wallet, username, trd_-prefixed traders.id, or bare integer traders.id'}, 'trader_id': {'type': 'integer', 'minimum': 1, 'description': 'Internal traders.id alias'}, 'condition_id': {'type': 'string', 'minLength': 1, 'description': 'Market condition ID'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'PositionTimelineEvent': {'type': 'object', 'required': ['id', 'event_timestamp', 'action', 'outcome_side', 'token_id', 'amount_delta', 'price', 'usdc_notional', 'tx_hash', 'running_amount', 'running_avg_price'], 'properties': {'id': {'type': 'string'}, 'price': {'type': 'number'}, 'action': {'enum': ['buy', 'sell'], 'type': 'string'}, 'tx_hash': {'type': 'string'}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'amount_delta': {'type': 'number'}, 'outcome_side': {'enum': ['yes', 'no'], 'type': 'string'}, 'usdc_notional': {'type': 'number'}, 'running_amount': {'type': 'number'}, 'event_timestamp': {'type': 'string', 'format': 'date-time'}, 'running_avg_price': {'type': 'number'}}}}, 'anyOf': [{'type': 'object', 'required': ['data', 'has_more', 'next_cursor', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/PositionTimelineEvent'}}, 'meta': {'$ref': '#/$defs/ResponseMeta'}, 'total': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_position_timeline_by_id
Get Position Timeline By Trader ID
Get stored Polymarket fills available for one internal trader id in one market, newest first, using the public V1 /api/v1/traders/{id}/position-timeline route. Args: - condition_id (string, required): Market condition ID - trader_id (number, required): Internal traders.id alias - limit (number, 1-100, default 20) - cursor (string, optional) Returns: List of position timeline events with pagination metadata.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['condition_id', 'trader_id'], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Max events (1-100, default 20)'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor from previous response'}, 'trader_id': {'type': 'integer', 'minimum': 1, 'description': 'Internal traders.id alias'}, 'condition_id': {'type': 'string', 'minLength': 1, 'description': 'Market condition ID'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'PositionTimelineEvent': {'type': 'object', 'required': ['id', 'event_timestamp', 'action', 'outcome_side', 'token_id', 'amount_delta', 'price', 'usdc_notional', 'tx_hash', 'running_amount', 'running_avg_price'], 'properties': {'id': {'type': 'string'}, 'price': {'type': 'number'}, 'action': {'enum': ['buy', 'sell'], 'type': 'string'}, 'tx_hash': {'type': 'string'}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'amount_delta': {'type': 'number'}, 'outcome_side': {'enum': ['yes', 'no'], 'type': 'string'}, 'usdc_notional': {'type': 'number'}, 'running_amount': {'type': 'number'}, 'event_timestamp': {'type': 'string', 'format': 'date-time'}, 'running_avg_price': {'type': 'number'}}}}, 'anyOf': [{'type': 'object', 'required': ['data', 'has_more', 'next_cursor', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/PositionTimelineEvent'}}, 'meta': {'$ref': '#/$defs/ResponseMeta'}, 'total': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_pre_game_side_observations
List pre-game side observations
Observation-only evidence for sports and esports markets, for a Pro API key: graded-holder piles the ranked route does not fund. cohort is required: wider_holder (pre-game holder piles outside the funded route's admission), in_play (provider-confirmed live games with fresh holder and directional evidence), or emerging_pile (wider_holder rows whose sharp share is in [0.75, 0.85) with a complete holder scan, before kickoff). Every row carries observation_only=true, the provider market and token identity, kickoff, observed_at, the side and its price, the graded-holder distribution and scores, holder_scan_complete, directional_status, directional_rank_score, and rank. Canonical field names are side, backing_score and side_share; the older piled_side, conviction_score and smart_score keys carry the same values and stay on the wire. The page carries snapshot_as_of, degraded, funnel, and meta: when degraded is true the snapshot is partial and is not healthy evidence. This surface never feeds or changes get_pre_game_sides. Supports category (omitted means all sports; a non-sport category returns an empty list), limit (1-100, default 20), and cursor (pinned to the cohort and snapshot; a refreshed snapshot rejects it with cursor_expired, so request the first page again).
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['cohort'], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1}, 'cohort': {'enum': ['wider_holder', 'in_play', 'emerging_pile'], 'type': 'string', 'description': 'Observation cohort; required'}, 'cursor': {'type': 'string', 'description': 'Opaque cursor pinned to the cohort and its snapshot'}, 'category': {'type': 'string', 'description': 'Sport category; omitted means all sports'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'PreGameSideObservation': {'type': 'object', 'required': ['condition_id', 'token_id', 'category', 'raw_category', 'title', 'event_slug', 'event_id', 'parent_event_id', 'game_start_time', 'observed_at', 'cohort', 'observation_only', 'piled_side', 'piled_outcome_index', 'backed_price', 'sharp_pct', 'backed_sharp_usd', 's_count', 'a_count', 'b_count', 'graded_holders', 'top_grade', 'smart_score', 'volume', 'conviction_score', 'provider_read_source', 'holder_scan_complete', 'holder_snapshot_at', 'directional_status', 'one_way_holder_count', 'hedged_holder_count', 'one_way_graded_usd', 'directional_confidence', 'directional_rank_score', 'rank', 'side', 'backing_score', 'side_share'], 'properties': {'rank': {'type': 'integer', 'minimum': 1}, 'side': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'cohort': {'enum': ['wider_holder', 'in_play', 'emerging_pile'], 'type': 'string'}, 'volume': {'type': 'number', 'exclusiveMinimum': 0}, 'a_count': {'type': 'integer', 'minimum': 0}, 'b_count': {'type': 'integer', 'minimum': 0}, 's_count': {'type': 'integer', 'minimum': 0}, 'category': {'enum': ['Basketball', 'Football', 'Baseball', 'Hockey', 'MMA', 'Boxing', 'Soccer', 'Cricket', 'Golf', 'Tennis', 'Esports', 'Racing', 'Table Tennis', 'Pickleball'], 'type': 'string'}, 'event_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'token_id': {'type': 'string'}, 'sharp_pct': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'top_grade': {'enum': ['S', 'A', 'B'], 'type': 'string'}, 'event_slug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'piled_side': {'anyOf': [{'type': 'string', 'deprecated': True}, {'type': 'null'}]}, 'side_share': {'type': 'number', 'maximum': 1, 'minimum': -1}, 'observed_at': {'type': 'string', 'format': 'date-time'}, 'smart_score': {'type': 'number', 'maximum': 1, 'minimum': -1, 'deprecated': True}, 'backed_price': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'condition_id': {'type': 'string'}, 'raw_category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'backing_score': {'type': 'number', 'minimum': 0}, 'graded_holders': {'type': 'integer', 'minimum': 1}, 'game_start_time': {'type': 'string', 'format': 'date-time'}, 'parent_event_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'backed_sharp_usd': {'type': 'number', 'minimum': 0}, 'conviction_score': {'type': 'number', 'minimum': 0, 'deprecated': True}, 'observation_only': {'type': 'boolean', 'const': True}, 'directional_status': {'enum': ['available', 'unknown_ungrouped', 'unknown_stale', 'unavailable'], 'type': 'string'}, 'holder_snapshot_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}, 'one_way_graded_usd': {'anyOf': [{'type': 'number', 'minimum': 0}, {'type': 'null'}]}, 'hedged_holder_count': {'anyOf': [{'type': 'integer', 'minimum': 0}, {'type': 'null'}]}, 'piled_outcome_index': {'enum': [0, 1], 'type': 'integer'}, 'holder_scan_complete': {'type': 'boolean'}, 'one_way_holder_count': {'anyOf': [{'type': 'integer', 'minimum': 0}, {'type': 'null'}]}, 'provider_read_source': {'enum': ['cached', 'live'], 'type': 'string'}, 'directional_confidence': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}, 'directional_rank_score': {'type': 'number', 'minimum': 0}}}, 'PreGameSideFunnelReport': {'type': 'object', 'required': ['sports'], 'properties': {'sports': {'type': 'array', 'items': {'$ref': '#/$defs/PreGameSideSportFunnelReport'}}}}, 'PreGameSideSportFunnelReport': {'type': 'object', 'required': ['sport', 'board_input', 'board_live_available', 'board_upcoming_configured', 'board_upcoming_available', 'board_upcoming_status', 'board_upcoming_unavailable_scopes', 'input', 'terminals', 'terminal_total', 'reconciled'], 'properties': {'input': {'type': 'integer', 'minimum': 0}, 'sport': {'enum': ['Basketball', 'Football', 'Baseball', 'Hockey', 'MMA', 'Boxing', 'Soccer', 'Cricket', 'Golf', 'Tennis', 'Esports', 'Racing', 'Table Tennis', 'Pickleball'], 'type': 'string'}, 'terminals': {'type': 'object', 'propertyNames': {'$ref': '#/$defs/PreGameSideObservationTerminalReason'}, 'additionalProperties': {'type': 'integer', 'minimum': 0}}, 'reconciled': {'type': 'boolean'}, 'board_input': {'type': 'integer', 'minimum': 0}, 'terminal_total': {'type': 'integer', 'minimum': 0}, 'board_live_available': {'type': 'boolean'}, 'board_upcoming_status': {'enum': ['unknown', 'not_configured', 'available', 'capacity_limited', 'source_unavailable', 'cold_unavailable', 'deadline_unavailable'], 'type': 'string'}, 'board_upcoming_available': {'type': 'boolean'}, 'board_upcoming_configured': {'type': 'boolean'}, 'board_upcoming_unavailable_scopes': {'type': 'array', 'items': {'enum': ['category', 'nfl', 'cfb', 'nba', 'wnba', 'nhl', 'mls', 'valorant', 'league-of-legends', 'counter-strike-2', 'dota-2', 'registry', 'union', 'wave'], 'type': 'string'}, 'uniqueItems': True}}}, 'PreGameSideObservationTerminalReason': {'enum': ['outside_horizon', 'resolved', 'provider_closed', 'provider_excluded', 'invalid_market', 'missing_token', 'missing_stored_market', 'not_provider_live', 'board_source_unavailable', 'board_deadline_unavailable', 'primary_slate_candidate', 'zero_indexed_holder_research', 'capacity_limited', 'provider_unavailable', 'holder_deadline_unavailable', 'holder_computation_unavailable', 'holder_scan_incomplete', 'no_current_graded_holder', 'split_holder_pile', 'price_unavailable', 'wider_holder_emitted', 'in_play_emitted', 'in_play_stale_observed', 'in_play_directional_unavailable', 'internal_unclassified'], 'type': 'string'}}, 'anyOf': [{'type': 'object', 'required': ['data', 'has_more', 'next_cursor', 'snapshot_as_of', 'degraded', 'funnel', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/PreGameSideObservation'}}, 'meta': {'$ref': '#/$defs/ResponseMeta'}, 'funnel': {'$ref': '#/$defs/PreGameSideFunnelReport'}, 'degraded': {'type': 'boolean'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'anyOf': [{'anyOf': [{'type': 'string'}, {'type': 'null'}]}, {'type': 'null'}]}, 'snapshot_as_of': {'type': 'string', 'format': 'date-time'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_pre_game_sides
List pre-game sides
Upcoming games ranked by the side profitable wallets hold, for a Pro API key. Eligibility uses recent graded large-trade flow; ranking uses current graded holder concentration. Returns provider market identity, the side and its token ID, kickoff, grade distribution, backing_score, ranked_at, and availability. Canonical field names are side, ranked_at, backing_score and side_share; the older piled_side, signal_created_at, conviction_score and smart_score keys carry the same values and stay on the wire. A row is analytics, not an order instruction. Cached snapshots can include kickoffs that have since passed; inspect timestamps before acting. Supports category, limit (1-100, default 20), cursor, horizon_hours (1-48, default 12), and min_grade (S, A, B; default B).
Read only Idempotent
Input schema 
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1}, 'cursor': {'type': 'string', 'description': 'Opaque cursor pinned to a signal snapshot'}, 'category': {'type': 'string', 'description': 'Sport category; omitted means all sports'}, 'min_grade': {'enum': ['S', 'A', 'B'], 'type': 'string', 'default': 'B'}, 'horizon_hours': {'type': 'integer', 'default': 12, 'maximum': 48, 'minimum': 1}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'PreGameSide': {'type': 'object', 'required': ['condition_id', 'signal_created_at', 'token_id', 'category', 'raw_category', 'title', 'event_slug', 'game_start_time', 'piled_side', 'piled_outcome_index', 'sharp_pct', 'backed_sharp_usd', 's_count', 'a_count', 'b_count', 'graded_holders', 'top_grade', 'smart_score', 'volume', 'net_side', 'conviction_score', 'one_way_holder_count', 'hedged_holder_count', 'one_way_graded_usd', 'directional_confidence', 'directional_rank_score', 'category_skill', 'rank', 'side', 'ranked_at', 'backing_score', 'side_share'], 'properties': {'rank': {'type': 'integer'}, 'side': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'volume': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'a_count': {'type': 'integer'}, 'b_count': {'type': 'integer'}, 's_count': {'type': 'integer'}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'net_side': {'anyOf': [{'enum': ['BUY', 'SELL'], 'type': 'string'}, {'type': 'null'}]}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'ranked_at': {'type': 'string', 'format': 'date-time'}, 'sharp_pct': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'top_grade': {'anyOf': [{'enum': ['S', 'A', 'B'], 'type': 'string'}, {'type': 'null'}]}, 'event_slug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'piled_side': {'anyOf': [{'type': 'string', 'deprecated': True}, {'type': 'null'}]}, 'side_share': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'smart_score': {'anyOf': [{'type': 'number', 'deprecated': True}, {'type': 'null'}]}, 'condition_id': {'type': 'string'}, 'raw_category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'backing_score': {'type': 'number'}, 'category_skill': {'$ref': '#/$defs/PreGameSideCategorySkill'}, 'graded_holders': {'type': 'integer'}, 'game_start_time': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}, 'backed_sharp_usd': {'type': 'number'}, 'conviction_score': {'type': 'number', 'deprecated': True}, 'signal_created_at': {'type': 'string', 'format': 'date-time', 'deprecated': True}, 'one_way_graded_usd': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'hedged_holder_count': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'piled_outcome_index': {'type': 'integer'}, 'one_way_holder_count': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'directional_confidence': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'directional_rank_score': {'type': 'number'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'PreGameSideCategorySkill': {'type': 'object', 'required': ['status', 'model_version', 'taxonomy_version', 'platform', 'scope', 'source_coverage', 'observation_started_at', 'as_of', 'canonical_category', 'eligible_holders', 'covered_holders', 'backed_sharp_usd', 'covered_backed_usd', 'coverage_pct', 'weighted_edge_mean', 'weighted_holder_lower_mean', 'specialist_backed_usd', 'specialist_backed_usd_pct', 'largest_holder_backed_usd_pct', 'minimum_holder_event_count'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'status': {'enum': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'type': 'string'}, 'platform': {'type': 'string', 'const': 'polymarket'}, 'coverage_pct': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}, 'model_version': {'type': 'string'}, 'covered_holders': {'type': 'integer', 'minimum': 0}, 'source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'backed_sharp_usd': {'anyOf': [{'type': 'number', 'minimum': 0}, {'type': 'null'}]}, 'eligible_holders': {'type': 'integer', 'minimum': 0}, 'taxonomy_version': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'canonical_category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'covered_backed_usd': {'anyOf': [{'type': 'number', 'minimum': 0}, {'type': 'null'}]}, 'weighted_edge_mean': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': -1}, {'type': 'null'}]}, 'specialist_backed_usd': {'anyOf': [{'type': 'number', 'minimum': 0}, {'type': 'null'}]}, 'observation_started_at': {'type': 'string', 'format': 'date-time'}, 'specialist_backed_usd_pct': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}, 'minimum_holder_event_count': {'anyOf': [{'type': 'integer', 'minimum': 0}, {'type': 'null'}]}, 'weighted_holder_lower_mean': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'largest_holder_backed_usd_pct': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}}}}, 'anyOf': [{'type': 'object', 'required': ['data', 'has_more', 'next_cursor', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/PreGameSide'}}, 'meta': {'$ref': '#/$defs/ResponseMeta'}, 'total': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_report
Get Report Snapshot
Unified whale-activity report snapshot selector. One route for all three granularities; dispatches to the same per-granularity cap and date window as the granularity-specific report tools. Args: - granularity (string, required): "daily", "weekly", or "monthly" - period (string, required): Period token for the granularity. daily: UTC date YYYY-MM-DD. weekly: ISO week YYYY-WW, or a from,to YYYY-MM-DD pair. monthly: UTC month YYYY-MM. Returns: Report snapshot metadata and entries (source_range, snapshot.status, completeness, reconciliation, report).
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['granularity', 'period'], 'properties': {'period': {'type': 'string', 'minLength': 1, 'description': 'Period token: daily YYYY-MM-DD, weekly YYYY-WW or a from,to YYYY-MM-DD pair, monthly YYYY-MM'}, 'granularity': {'enum': ['daily', 'weekly', 'monthly'], 'type': 'string', 'description': 'Report granularity selector'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'ReportPayload': {'type': 'object', 'required': ['total_large_trades', 'total_whale_trades', 'total_large_trade_volume', 'total_whale_volume', 'biggest_trade_size', 'active_traders', 'top_large_trades', 'top_whale_trades', 'categories', 'grade_distribution'], 'properties': {'categories': {'anyOf': [{'type': 'array', 'items': {'type': 'object'}}, {'type': 'null'}]}, 'active_traders': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'top_large_trades': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'required': ['outcome', 'side', 'title', 'size', 'price', 'token_id', 'id', 'trade_time', 'market_category', 'platform', 'name', 'pseudonym', 'trader_grade'], 'properties': {'id': {'anyOf': [{'type': 'integer', 'format': 'int64'}, {'type': 'null'}]}, 'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'side': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'size': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'price': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'outcome': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'platform': {'anyOf': [{'enum': ['polymarket'], 'type': 'string'}, {'type': 'null'}]}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'pseudonym': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'trade_time': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}, 'trader_grade': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'market_category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}}}, {'type': 'null'}]}, 'top_whale_trades': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'required': ['outcome', 'side', 'title', 'size', 'price', 'token_id', 'id', 'trade_time', 'market_category', 'platform', 'name', 'pseudonym', 'trader_grade'], 'properties': {'id': {'anyOf': [{'type': 'integer', 'format': 'int64'}, {'type': 'null'}]}, 'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'side': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'size': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'price': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'outcome': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'platform': {'anyOf': [{'enum': ['polymarket'], 'type': 'string'}, {'type': 'null'}]}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'pseudonym': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'trade_time': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}, 'trader_grade': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'market_category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}}}, {'type': 'null'}]}, 'biggest_trade_size': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'grade_distribution': {'anyOf': [{'type': 'array', 'items': {'type': 'object'}}, {'type': 'null'}]}, 'total_large_trades': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'total_whale_trades': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'total_whale_volume': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'total_large_trade_volume': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}}, 'SnapshotState': {'type': 'object', 'required': ['version', 'storage', 'status', 'generated_at', 'mutable_until', 'period_closed', 'final_after', 'source_read_started_at'], 'properties': {'status': {'enum': ['final', 'rolling'], 'type': 'string'}, 'storage': {'enum': ['durable', 'ephemeral'], 'type': 'string'}, 'version': {'type': 'integer', 'format': 'int64'}, 'final_after': {'type': 'string', 'format': 'date-time'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'mutable_until': {'anyOf': [{'type': 'string', 'format': 'date'}, {'type': 'null'}]}, 'period_closed': {'type': 'boolean'}, 'source_read_started_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}}}, 'ReportSnapshot': {'type': 'object', 'required': ['kind', 'generated_at', 'source_range', 'snapshot', 'completeness', 'reconciliation', 'report'], 'properties': {'kind': {'enum': ['daily', 'weekly', 'monthly'], 'type': 'string'}, 'report': {'$ref': '#/$defs/ReportPayload'}, 'snapshot': {'$ref': '#/$defs/SnapshotState'}, 'completeness': {'$ref': '#/$defs/SnapshotCompleteness'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'source_range': {'$ref': '#/$defs/ReportSourceRange'}, 'reconciliation': {'$ref': '#/$defs/ReportReconciliation'}}}, 'ReportSourceRange': {'type': 'object', 'required': ['start_date', 'end_date', 'timezone'], 'properties': {'end_date': {'type': 'string', 'format': 'date'}, 'timezone': {'type': 'string', 'const': 'UTC'}, 'start_date': {'type': 'string', 'format': 'date'}}}, 'ReportReconciliation': {'type': 'object', 'required': ['volume_kind', 'whale_volume_source', 'notes'], 'properties': {'notes': {'type': 'string'}, 'volume_kind': {'type': 'string', 'const': 'local_whale_activity_volume'}, 'whale_volume_source': {'type': 'string'}}}, 'SnapshotCompleteness': {'type': 'object', 'required': ['status', 'reason', 'expected_days', 'covered_days_with_whale_activity'], 'properties': {'reason': {'type': 'string'}, 'status': {'enum': ['complete', 'partial', 'empty'], 'type': 'string'}, 'expected_days': {'type': 'integer'}, 'covered_days_with_whale_activity': {'type': 'integer'}, 'covered_days_with_large_trade_activity': {'type': 'integer'}}}}, 'anyOf': [{'allOf': [{'$ref': '#/$defs/ReportSnapshot'}, {'type': 'object', 'required': ['meta'], 'properties': {'meta': {'$ref': '#/$defs/ResponseMeta'}}}]}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_sharp_money_flows
List sharp-money flows
Ranked sharp-money flow discovery across prediction markets. Use this before you know a condition_id to find where graded traders are net buying or selling. Cursor-paginated, ranked by absolute net flow descending. Args: - timeframe (string, optional): Lookback window: "1h", "4h", "24h", "7d" (default "24h") - limit (number, 1-100, default 20): Max results per page - cursor (string, optional): Pagination cursor with smf_ prefix - category (string, optional): Filter by provider-backed market category - platform (string, optional): "polymarket" or "all" (default "all") - min_grade (string, optional): Minimum trader grade S, A, B, C, D, or F (default "B" = S/A/B) - direction (string, optional): Filter by net flow direction: "YES" or "NO" Returns: Ranked markets with sharp_money (net_flow_usd, direction, whale_trade_count, buy/sell volumes) and market identity. smart_money is a deprecated byte-identical alias of sharp_money.
Read only Idempotent
Input schema 
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Max results (1-100, default 20)'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor with smf_ prefix'}, 'category': {'type': 'string', 'description': 'Filter by provider-backed market category'}, 'platform': {'enum': ['polymarket', 'all'], 'type': 'string', 'default': 'all', 'description': 'Platform filter (default all)'}, 'direction': {'enum': ['YES', 'NO'], 'type': 'string', 'description': 'Filter by net flow direction'}, 'min_grade': {'enum': ['S', 'A', 'B', 'C', 'D', 'F'], 'type': 'string', 'default': 'B', 'description': 'Minimum trader grade (default B = S/A/B)'}, 'timeframe': {'enum': ['1h', '4h', '24h', '7d'], 'type': 'string', 'default': '24h', 'description': 'Lookback window (default 24h)'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'SmartMoneyFlowMarket': {'type': 'object', 'required': ['market', 'sharp_money', 'smart_money', 'timeframe'], 'properties': {'market': {'type': 'object', 'required': ['id', 'condition_id', 'title', 'slug', 'category', 'platform'], 'properties': {'id': {'type': 'string'}, 'slug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'platform': {'anyOf': [{'enum': ['polymarket'], 'type': 'string'}, {'type': 'null'}]}, 'condition_id': {'type': 'string'}}}, 'timeframe': {'type': 'string'}, 'sharp_money': {'type': 'object', 'required': ['net_flow_usd', 'direction', 'token_id', 'whale_trade_count', 'buy_volume_usd', 'sell_volume_usd'], 'properties': {'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'direction': {'enum': ['YES', 'NO'], 'type': 'string'}, 'net_flow_usd': {'type': 'number'}, 'buy_volume_usd': {'type': 'number'}, 'sell_volume_usd': {'type': 'number'}, 'large_trade_count': {'type': 'integer'}, 'whale_trade_count': {'type': 'integer'}}}, 'smart_money': {'type': 'object', 'required': ['net_flow_usd', 'direction', 'token_id', 'whale_trade_count', 'buy_volume_usd', 'sell_volume_usd'], 'deprecated': True, 'properties': {'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'direction': {'enum': ['YES', 'NO'], 'type': 'string'}, 'net_flow_usd': {'type': 'number'}, 'buy_volume_usd': {'type': 'number'}, 'sell_volume_usd': {'type': 'number'}, 'large_trade_count': {'type': 'integer'}, 'whale_trade_count': {'type': 'integer'}}}}}}, 'anyOf': [{'type': 'object', 'required': ['data', 'has_more', 'next_cursor', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/SmartMoneyFlowMarket'}}, 'meta': {'$ref': '#/$defs/ResponseMeta'}, 'total': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_smart_money_flows
List Smart-Money Flows
Deprecated alias of get_sharp_money_flows (#16308), kept live; it calls the deprecated /api/v1/markets/smart-money-flows path. Ranked sharp-money flow discovery across prediction markets. Use this before you know a condition_id to find where graded traders are net buying or selling. Cursor-paginated, ranked by absolute net flow descending. Args: - timeframe (string, optional): Lookback window: "1h", "4h", "24h", "7d" (default "24h") - limit (number, 1-100, default 20): Max results per page - cursor (string, optional): Pagination cursor with smf_ prefix - category (string, optional): Filter by provider-backed market category - platform (string, optional): "polymarket" or "all" (default "all") - min_grade (string, optional): Minimum trader grade S, A, B, C, D, or F (default "B" = S/A/B) - direction (string, optional): Filter by net flow direction: "YES" or "NO" Returns: Ranked markets with sharp_money (net_flow_usd, direction, whale_trade_count, buy/sell volumes) and market identity. smart_money is a deprecated byte-identical alias of sharp_money.
Read only Idempotent
Input schema 
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Max results (1-100, default 20)'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor with smf_ prefix'}, 'category': {'type': 'string', 'description': 'Filter by provider-backed market category'}, 'platform': {'enum': ['polymarket', 'all'], 'type': 'string', 'default': 'all', 'description': 'Platform filter (default all)'}, 'direction': {'enum': ['YES', 'NO'], 'type': 'string', 'description': 'Filter by net flow direction'}, 'min_grade': {'enum': ['S', 'A', 'B', 'C', 'D', 'F'], 'type': 'string', 'default': 'B', 'description': 'Minimum trader grade (default B = S/A/B)'}, 'timeframe': {'enum': ['1h', '4h', '24h', '7d'], 'type': 'string', 'default': '24h', 'description': 'Lookback window (default 24h)'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'SmartMoneyFlowMarket': {'type': 'object', 'required': ['market', 'sharp_money', 'smart_money', 'timeframe'], 'properties': {'market': {'type': 'object', 'required': ['id', 'condition_id', 'title', 'slug', 'category', 'platform'], 'properties': {'id': {'type': 'string'}, 'slug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'platform': {'anyOf': [{'enum': ['polymarket'], 'type': 'string'}, {'type': 'null'}]}, 'condition_id': {'type': 'string'}}}, 'timeframe': {'type': 'string'}, 'sharp_money': {'type': 'object', 'required': ['net_flow_usd', 'direction', 'token_id', 'whale_trade_count', 'buy_volume_usd', 'sell_volume_usd'], 'properties': {'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'direction': {'enum': ['YES', 'NO'], 'type': 'string'}, 'net_flow_usd': {'type': 'number'}, 'buy_volume_usd': {'type': 'number'}, 'sell_volume_usd': {'type': 'number'}, 'large_trade_count': {'type': 'integer'}, 'whale_trade_count': {'type': 'integer'}}}, 'smart_money': {'type': 'object', 'required': ['net_flow_usd', 'direction', 'token_id', 'whale_trade_count', 'buy_volume_usd', 'sell_volume_usd'], 'deprecated': True, 'properties': {'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'direction': {'enum': ['YES', 'NO'], 'type': 'string'}, 'net_flow_usd': {'type': 'number'}, 'buy_volume_usd': {'type': 'number'}, 'sell_volume_usd': {'type': 'number'}, 'large_trade_count': {'type': 'integer'}, 'whale_trade_count': {'type': 'integer'}}}}}}, 'anyOf': [{'type': 'object', 'required': ['data', 'has_more', 'next_cursor', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/SmartMoneyFlowMarket'}}, 'meta': {'$ref': '#/$defs/ResponseMeta'}, 'total': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_sports_edge_observations
Get Sports Edge Observations
Deprecated alias of get_pre_game_side_observations (#16310), kept live; it calls the deprecated /api/v1/sports-edge-observations path. Observation-only evidence for sports and esports markets, for a Pro API key: graded-holder piles the ranked signals route does not fund. cohort is required: wider_holder (pre-game holder piles outside the funded route's admission), in_play (provider-confirmed live games with fresh holder and directional evidence), or emerging_pile (wider_holder rows whose sharp share is in [0.75, 0.85) with a complete holder scan, before kickoff). Every row carries observation_only=true, the provider market and token identity, kickoff, observed_at, the piled outcome and price, the graded-holder distribution and scores, holder_scan_complete, directional_status, directional_rank_score, and rank. The page carries snapshot_as_of, degraded, funnel, and meta: when degraded is true the snapshot is partial and is not healthy evidence. This surface never feeds or changes get_sports_edge_signals. Supports category (omitted means all sports; a non-sport category returns an empty list), limit (1-100, default 20), and cursor (pinned to the cohort and snapshot; a refreshed snapshot rejects it with cursor_expired, so request the first page again).
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['cohort'], 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1}, 'cohort': {'enum': ['wider_holder', 'in_play', 'emerging_pile'], 'type': 'string', 'description': 'Observation cohort; required'}, 'cursor': {'type': 'string', 'description': 'Opaque cursor pinned to the cohort and its snapshot'}, 'category': {'type': 'string', 'description': 'Sport category; omitted means all sports'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'PreGameSideObservation': {'type': 'object', 'required': ['condition_id', 'token_id', 'category', 'raw_category', 'title', 'event_slug', 'event_id', 'parent_event_id', 'game_start_time', 'observed_at', 'cohort', 'observation_only', 'piled_side', 'piled_outcome_index', 'backed_price', 'sharp_pct', 'backed_sharp_usd', 's_count', 'a_count', 'b_count', 'graded_holders', 'top_grade', 'smart_score', 'volume', 'conviction_score', 'provider_read_source', 'holder_scan_complete', 'holder_snapshot_at', 'directional_status', 'one_way_holder_count', 'hedged_holder_count', 'one_way_graded_usd', 'directional_confidence', 'directional_rank_score', 'rank', 'side', 'backing_score', 'side_share'], 'properties': {'rank': {'type': 'integer', 'minimum': 1}, 'side': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'cohort': {'enum': ['wider_holder', 'in_play', 'emerging_pile'], 'type': 'string'}, 'volume': {'type': 'number', 'exclusiveMinimum': 0}, 'a_count': {'type': 'integer', 'minimum': 0}, 'b_count': {'type': 'integer', 'minimum': 0}, 's_count': {'type': 'integer', 'minimum': 0}, 'category': {'enum': ['Basketball', 'Football', 'Baseball', 'Hockey', 'MMA', 'Boxing', 'Soccer', 'Cricket', 'Golf', 'Tennis', 'Esports', 'Racing', 'Table Tennis', 'Pickleball'], 'type': 'string'}, 'event_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'token_id': {'type': 'string'}, 'sharp_pct': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'top_grade': {'enum': ['S', 'A', 'B'], 'type': 'string'}, 'event_slug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'piled_side': {'anyOf': [{'type': 'string', 'deprecated': True}, {'type': 'null'}]}, 'side_share': {'type': 'number', 'maximum': 1, 'minimum': -1}, 'observed_at': {'type': 'string', 'format': 'date-time'}, 'smart_score': {'type': 'number', 'maximum': 1, 'minimum': -1, 'deprecated': True}, 'backed_price': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'condition_id': {'type': 'string'}, 'raw_category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'backing_score': {'type': 'number', 'minimum': 0}, 'graded_holders': {'type': 'integer', 'minimum': 1}, 'game_start_time': {'type': 'string', 'format': 'date-time'}, 'parent_event_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'backed_sharp_usd': {'type': 'number', 'minimum': 0}, 'conviction_score': {'type': 'number', 'minimum': 0, 'deprecated': True}, 'observation_only': {'type': 'boolean', 'const': True}, 'directional_status': {'enum': ['available', 'unknown_ungrouped', 'unknown_stale', 'unavailable'], 'type': 'string'}, 'holder_snapshot_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}, 'one_way_graded_usd': {'anyOf': [{'type': 'number', 'minimum': 0}, {'type': 'null'}]}, 'hedged_holder_count': {'anyOf': [{'type': 'integer', 'minimum': 0}, {'type': 'null'}]}, 'piled_outcome_index': {'enum': [0, 1], 'type': 'integer'}, 'holder_scan_complete': {'type': 'boolean'}, 'one_way_holder_count': {'anyOf': [{'type': 'integer', 'minimum': 0}, {'type': 'null'}]}, 'provider_read_source': {'enum': ['cached', 'live'], 'type': 'string'}, 'directional_confidence': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}, 'directional_rank_score': {'type': 'number', 'minimum': 0}}}, 'PreGameSideFunnelReport': {'type': 'object', 'required': ['sports'], 'properties': {'sports': {'type': 'array', 'items': {'$ref': '#/$defs/PreGameSideSportFunnelReport'}}}}, 'PreGameSideSportFunnelReport': {'type': 'object', 'required': ['sport', 'board_input', 'board_live_available', 'board_upcoming_configured', 'board_upcoming_available', 'board_upcoming_status', 'board_upcoming_unavailable_scopes', 'input', 'terminals', 'terminal_total', 'reconciled'], 'properties': {'input': {'type': 'integer', 'minimum': 0}, 'sport': {'enum': ['Basketball', 'Football', 'Baseball', 'Hockey', 'MMA', 'Boxing', 'Soccer', 'Cricket', 'Golf', 'Tennis', 'Esports', 'Racing', 'Table Tennis', 'Pickleball'], 'type': 'string'}, 'terminals': {'type': 'object', 'propertyNames': {'$ref': '#/$defs/PreGameSideObservationTerminalReason'}, 'additionalProperties': {'type': 'integer', 'minimum': 0}}, 'reconciled': {'type': 'boolean'}, 'board_input': {'type': 'integer', 'minimum': 0}, 'terminal_total': {'type': 'integer', 'minimum': 0}, 'board_live_available': {'type': 'boolean'}, 'board_upcoming_status': {'enum': ['unknown', 'not_configured', 'available', 'capacity_limited', 'source_unavailable', 'cold_unavailable', 'deadline_unavailable'], 'type': 'string'}, 'board_upcoming_available': {'type': 'boolean'}, 'board_upcoming_configured': {'type': 'boolean'}, 'board_upcoming_unavailable_scopes': {'type': 'array', 'items': {'enum': ['category', 'nfl', 'cfb', 'nba', 'wnba', 'nhl', 'mls', 'valorant', 'league-of-legends', 'counter-strike-2', 'dota-2', 'registry', 'union', 'wave'], 'type': 'string'}, 'uniqueItems': True}}}, 'PreGameSideObservationTerminalReason': {'enum': ['outside_horizon', 'resolved', 'provider_closed', 'provider_excluded', 'invalid_market', 'missing_token', 'missing_stored_market', 'not_provider_live', 'board_source_unavailable', 'board_deadline_unavailable', 'primary_slate_candidate', 'zero_indexed_holder_research', 'capacity_limited', 'provider_unavailable', 'holder_deadline_unavailable', 'holder_computation_unavailable', 'holder_scan_incomplete', 'no_current_graded_holder', 'split_holder_pile', 'price_unavailable', 'wider_holder_emitted', 'in_play_emitted', 'in_play_stale_observed', 'in_play_directional_unavailable', 'internal_unclassified'], 'type': 'string'}}, 'anyOf': [{'type': 'object', 'required': ['data', 'has_more', 'next_cursor', 'snapshot_as_of', 'degraded', 'funnel', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/PreGameSideObservation'}}, 'meta': {'$ref': '#/$defs/ResponseMeta'}, 'funnel': {'$ref': '#/$defs/PreGameSideFunnelReport'}, 'degraded': {'type': 'boolean'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'anyOf': [{'anyOf': [{'type': 'string'}, {'type': 'null'}]}, {'type': 'null'}]}, 'snapshot_as_of': {'type': 'string', 'format': 'date-time'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_sports_edge_signals
Get Ranked Sports Edge Signals
Deprecated alias of get_pre_game_sides (#16310), kept live; it calls the deprecated /api/v1/sports-edge-signals path. Ranked pre-game sports and esports signals for a Pro API key. Eligibility uses recent graded whale flow; ranking uses current graded holder concentration. Returns provider market identity, backed outcome and token ID, kickoff, grade distribution, conviction, snapshot time, and availability. A signal is analytics, not an order instruction. Cached snapshots can include kickoffs that have since passed; inspect timestamps before acting. Supports category, limit (1-100, default 20), cursor, horizon_hours (1-48, default 12), and min_grade (S, A, B; default B).
Read only Idempotent
Input schema 
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1}, 'cursor': {'type': 'string', 'description': 'Opaque cursor pinned to a signal snapshot'}, 'category': {'type': 'string', 'description': 'Sport category; omitted means all sports'}, 'min_grade': {'enum': ['S', 'A', 'B'], 'type': 'string', 'default': 'B'}, 'horizon_hours': {'type': 'integer', 'default': 12, 'maximum': 48, 'minimum': 1}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'PreGameSide': {'type': 'object', 'required': ['condition_id', 'signal_created_at', 'token_id', 'category', 'raw_category', 'title', 'event_slug', 'game_start_time', 'piled_side', 'piled_outcome_index', 'sharp_pct', 'backed_sharp_usd', 's_count', 'a_count', 'b_count', 'graded_holders', 'top_grade', 'smart_score', 'volume', 'net_side', 'conviction_score', 'one_way_holder_count', 'hedged_holder_count', 'one_way_graded_usd', 'directional_confidence', 'directional_rank_score', 'category_skill', 'rank', 'side', 'ranked_at', 'backing_score', 'side_share'], 'properties': {'rank': {'type': 'integer'}, 'side': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'volume': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'a_count': {'type': 'integer'}, 'b_count': {'type': 'integer'}, 's_count': {'type': 'integer'}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'net_side': {'anyOf': [{'enum': ['BUY', 'SELL'], 'type': 'string'}, {'type': 'null'}]}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'ranked_at': {'type': 'string', 'format': 'date-time'}, 'sharp_pct': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'top_grade': {'anyOf': [{'enum': ['S', 'A', 'B'], 'type': 'string'}, {'type': 'null'}]}, 'event_slug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'piled_side': {'anyOf': [{'type': 'string', 'deprecated': True}, {'type': 'null'}]}, 'side_share': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'smart_score': {'anyOf': [{'type': 'number', 'deprecated': True}, {'type': 'null'}]}, 'condition_id': {'type': 'string'}, 'raw_category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'backing_score': {'type': 'number'}, 'category_skill': {'$ref': '#/$defs/PreGameSideCategorySkill'}, 'graded_holders': {'type': 'integer'}, 'game_start_time': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}, 'backed_sharp_usd': {'type': 'number'}, 'conviction_score': {'type': 'number', 'deprecated': True}, 'signal_created_at': {'type': 'string', 'format': 'date-time', 'deprecated': True}, 'one_way_graded_usd': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'hedged_holder_count': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'piled_outcome_index': {'type': 'integer'}, 'one_way_holder_count': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'directional_confidence': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'directional_rank_score': {'type': 'number'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'PreGameSideCategorySkill': {'type': 'object', 'required': ['status', 'model_version', 'taxonomy_version', 'platform', 'scope', 'source_coverage', 'observation_started_at', 'as_of', 'canonical_category', 'eligible_holders', 'covered_holders', 'backed_sharp_usd', 'covered_backed_usd', 'coverage_pct', 'weighted_edge_mean', 'weighted_holder_lower_mean', 'specialist_backed_usd', 'specialist_backed_usd_pct', 'largest_holder_backed_usd_pct', 'minimum_holder_event_count'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'status': {'enum': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'type': 'string'}, 'platform': {'type': 'string', 'const': 'polymarket'}, 'coverage_pct': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}, 'model_version': {'type': 'string'}, 'covered_holders': {'type': 'integer', 'minimum': 0}, 'source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'backed_sharp_usd': {'anyOf': [{'type': 'number', 'minimum': 0}, {'type': 'null'}]}, 'eligible_holders': {'type': 'integer', 'minimum': 0}, 'taxonomy_version': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'canonical_category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'covered_backed_usd': {'anyOf': [{'type': 'number', 'minimum': 0}, {'type': 'null'}]}, 'weighted_edge_mean': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': -1}, {'type': 'null'}]}, 'specialist_backed_usd': {'anyOf': [{'type': 'number', 'minimum': 0}, {'type': 'null'}]}, 'observation_started_at': {'type': 'string', 'format': 'date-time'}, 'specialist_backed_usd_pct': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}, 'minimum_holder_event_count': {'anyOf': [{'type': 'integer', 'minimum': 0}, {'type': 'null'}]}, 'weighted_holder_lower_mean': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'largest_holder_backed_usd_pct': {'anyOf': [{'type': 'number', 'maximum': 1, 'minimum': 0}, {'type': 'null'}]}}}}, 'anyOf': [{'type': 'object', 'required': ['data', 'has_more', 'next_cursor', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/PreGameSide'}}, 'meta': {'$ref': '#/$defs/ResponseMeta'}, 'total': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_suspicious_trade
Get suspicious trade
Read one suspicious trade by ID. Accepts the rf_ ID returned by list responses or the raw numeric whale_alerts.id. Args: - id (string, required): Suspicious trade ID such as rf_123 or 123 Returns: One suspicious trade with trader, market, suspicion scores, and evidence.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Suspicious trade ID such as rf_123 or 123'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'SuspiciousTrade': {'type': 'object', 'required': ['id', 'suspicion_score', 'severity', 'trader', 'market', 'scores', 'evidence', 'created_at'], 'properties': {'id': {'type': 'string'}, 'market': {'type': 'object', 'required': ['id', 'condition_id', 'title'], 'properties': {'id': {'type': 'string'}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'condition_id': {'type': 'string'}}}, 'scores': {'type': 'object', 'required': ['timing', 'edge', 'size', 'fresh_wallet'], 'properties': {'edge': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'size': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'timing': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'fresh_wallet': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}}, 'trader': {'type': 'object', 'required': ['id', 'address', 'username'], 'properties': {'id': {'type': 'string'}, 'address': {'type': 'string'}, 'username': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}}, 'evidence': {}, 'severity': {'enum': ['flag'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'suspicion_score': {'type': 'number', 'maximum': 100, 'minimum': 60}}}}, 'anyOf': [{'allOf': [{'$ref': '#/$defs/SuspiciousTrade'}, {'type': 'object', 'required': ['meta'], 'properties': {'meta': {'$ref': '#/$defs/ResponseMeta'}}}]}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_suspicious_trades
Get suspicious trades
Stored trades whose recorded suspicion score meets the live flag threshold. Cursor-paginated by suspicion score (highest first). Use mode=stable when a walk must stay on one published scoring generation; restart when it returns cursor_expired. Each suspicious trade includes: - suspicion_score (60-100) - severity (currently flag) - Sub-scores: size and fresh_wallet when recorded; timing and edge are null - Evidence JSON with the scorer's stored signals Args: - limit (number, 1-100, default 20): Max results per page - cursor (string, optional): Pagination cursor from previous response - min_suspicion (number, 0-100, default 0): Minimum score; the live floor of 60 also applies - severity (string, optional): "flag" selects live rows; "watch" returns none because no live watch policy exists - mode (string, optional): "live" (default) uses fresh cached pages; "stable" pins the walk to one published scoring generation Returns: List of suspicious trades with trader, market, scores, and evidence.
Read only Idempotent
Input schema 
{'type': 'object', 'properties': {'mode': {'enum': ['live', 'stable'], 'type': 'string', 'default': 'live', 'description': 'live uses the fresh response cache; stable pins pagination to one published scoring generation'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Max results (1-100, default 20)'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor from previous response'}, 'severity': {'enum': ['flag', 'watch'], 'type': 'string', 'description': '"flag" selects live rows; "watch" returns none because no live watch policy exists'}, 'min_suspicion': {'type': 'number', 'default': 0, 'maximum': 100, 'minimum': 0, 'description': 'Minimum suspicion score (0-100); the live floor of 60 also applies'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'SuspiciousTrade': {'type': 'object', 'required': ['id', 'suspicion_score', 'severity', 'trader', 'market', 'scores', 'evidence', 'created_at'], 'properties': {'id': {'type': 'string'}, 'market': {'type': 'object', 'required': ['id', 'condition_id', 'title'], 'properties': {'id': {'type': 'string'}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'condition_id': {'type': 'string'}}}, 'scores': {'type': 'object', 'required': ['timing', 'edge', 'size', 'fresh_wallet'], 'properties': {'edge': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'size': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'timing': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'fresh_wallet': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}}, 'trader': {'type': 'object', 'required': ['id', 'address', 'username'], 'properties': {'id': {'type': 'string'}, 'address': {'type': 'string'}, 'username': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}}, 'evidence': {}, 'severity': {'enum': ['flag'], 'type': 'string'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'suspicion_score': {'type': 'number', 'maximum': 100, 'minimum': 60}}}}, 'anyOf': [{'type': 'object', 'required': ['data', 'has_more', 'next_cursor', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/SuspiciousTrade'}}, 'meta': {'$ref': '#/$defs/ResponseMeta'}, 'total': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_trader
Get trader
Look up a prediction market trader by wallet address or username. Returns grade (S through F), P&L breakdown, win rate, and volume. Optional expand fields for heavier data: - strategy: Trading strategy classification - categories: Per-category performance breakdown - quant_metrics: curated advanced metrics (copy_score and smart_score 0-100, sharpe_30d, sharpe_7d, profit_factor, edge_consistency, sharpe_percentile, pf_percentile, consistency_percentile); emitted only for a computed row strictly under six hours old, otherwise omitted; each present value is a number or null - trust: Per-field provenance (source, freshness, reconciliation, completeness) for grade, P&L, and stats A wallet address with no trader yet returns sync_status "unknown" (not an error). A username or trader id that matches no trader is a not_found error. Args: - address (string, required): Ethereum wallet address (0x...) or trader username - expand (string[], optional): Heavy fields to include: "strategy", "categories", "quant_metrics", "trust" Returns: Trader profile with grade, P&L, stats, and optional expanded fields. The trader carries data_quality: status, as_of (the oldest clock the body rests on) and field_groups. fresh means tracked and clocked, not current: compare as_of with your own tolerance. unknown means this read cannot date that group, never that it is recent.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['address'], 'properties': {'expand': {'type': 'array', 'items': {'enum': ['strategy', 'categories', 'quant_metrics', 'trust'], 'type': 'string'}, 'description': 'Optional heavy fields to include'}, 'address': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Ethereum wallet address (0x...) or trader username'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'Trader': {'type': 'object', 'required': ['id', 'address', 'pnl', 'stats', 'data_quality'], 'properties': {'id': {'type': 'string'}, 'pnl': {'type': 'object', 'properties': {'exact': {'$ref': '#/$defs/TraderPnlExact'}, 'total': {'type': 'number'}, 'last_7d': {'type': 'number'}, 'last_30d': {'type': 'number'}, 'realized': {'type': 'number'}, 'unrealized': {'type': 'number'}}}, 'rank': {'type': 'integer'}, 'grade': {'enum': ['S', 'A', 'B', 'C', 'D', 'F'], 'type': 'string'}, 'score': {'type': 'number'}, 'stats': {'type': 'object', 'properties': {'exact': {'$ref': '#/$defs/TraderStatsExact'}, 'win_rate': {'type': 'number'}, 'total_volume': {'type': 'number'}, 'daily_win_rate': {'type': 'number'}, 'markets_traded': {'type': 'integer'}}}, 'trust': {'$ref': '#/$defs/TraderTrust'}, 'address': {'type': 'string'}, 'strategy': {'type': 'object', 'properties': {'confidence': {'type': 'number'}, 'description': {'type': 'string'}, 'strategy_type': {'type': 'string'}}}, 'username': {'type': 'string'}, 'synced_at': {'type': 'string', 'format': 'date-time'}, 'last_active': {'type': 'string', 'format': 'date-time'}, 'streak_tier': {'enum': ['hot', 'rising', 'neutral', 'cooling', 'cold'], 'type': 'string'}, 'sync_status': {'type': 'string'}, 'data_quality': {'$ref': '#/$defs/DataQuality'}, 'quant_metrics': {'type': 'object', 'required': ['smart_score', 'copy_score', 'sharpe_30d', 'sharpe_7d', 'profit_factor', 'edge_consistency', 'sharpe_percentile', 'pf_percentile', 'consistency_percentile'], 'properties': {'sharpe_7d': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'copy_score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'sharpe_30d': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'smart_score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'pf_percentile': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'profit_factor': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'edge_consistency': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'sharpe_percentile': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'consistency_percentile': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': False}, 'forecast_score': {'type': 'number'}, 'category_records': {'type': 'array', 'items': {'$ref': '#/$defs/CategorySkillV2'}}, 'forecast_evidence': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'category_strengths': {'type': 'object', 'additionalProperties': True}, 'category_skill_model': {'$ref': '#/$defs/CategorySkillModelReadiness'}}}, 'DataQuality': {'type': 'object', 'required': ['status', 'field_groups'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'status': {'enum': ['fresh', 'partial', 'unknown', 'untracked', 'unavailable'], 'type': 'string'}, 'field_groups': {'type': 'array', 'items': {'$ref': '#/$defs/DataQualityGroup'}}}}, 'TraderTrust': {'type': 'object', 'required': ['total_pnl', 'realized_pnl', 'unrealized_pnl', 'markets_traded', 'win_rate', 'daily_win_rate', 'total_volume', 'grade', 'score', 'forecast_score', 'forecast_evidence', 'rank', 'streak_tier', 'strategy', 'category_strengths', 'quant_metrics', 'last_active', 'synced_at', 'sync_status', 'category_records', 'category_skill_model'], 'properties': {'rank': {'$ref': '#/$defs/TrustMetadata'}, 'grade': {'$ref': '#/$defs/TrustMetadata'}, 'score': {'$ref': '#/$defs/TrustMetadata'}, 'strategy': {'$ref': '#/$defs/TrustMetadata'}, 'win_rate': {'$ref': '#/$defs/TrustMetadata'}, 'synced_at': {'$ref': '#/$defs/TrustMetadata'}, 'total_pnl': {'$ref': '#/$defs/TrustMetadata'}, 'last_active': {'$ref': '#/$defs/TrustMetadata'}, 'streak_tier': {'$ref': '#/$defs/TrustMetadata'}, 'sync_status': {'$ref': '#/$defs/TrustMetadata'}, 'realized_pnl': {'$ref': '#/$defs/TrustMetadata'}, 'total_volume': {'$ref': '#/$defs/TrustMetadata'}, 'quant_metrics': {'$ref': '#/$defs/TrustMetadata'}, 'daily_win_rate': {'$ref': '#/$defs/TrustMetadata'}, 'forecast_score': {'$ref': '#/$defs/TrustMetadata'}, 'markets_traded': {'$ref': '#/$defs/TrustMetadata'}, 'unrealized_pnl': {'$ref': '#/$defs/TrustMetadata'}, 'category_records': {'$ref': '#/$defs/TrustMetadata'}, 'forecast_evidence': {'$ref': '#/$defs/TrustMetadata'}, 'category_strengths': {'$ref': '#/$defs/TrustMetadata'}, 'category_skill_model': {'$ref': '#/$defs/TrustMetadata'}}}, 'TrustSource': {'type': 'object', 'required': ['kind', 'owner'], 'properties': {'kind': {'enum': ['provider', 'database', 'cache', 'computed', 'client_input', 'unavailable'], 'type': 'string'}, 'field': {'type': 'string'}, 'owner': {'type': 'string'}}}, 'ExactDecimal': {'type': 'object', 'required': ['value', 'unit', 'scale', 'basis'], 'properties': {'unit': {'type': 'string'}, 'basis': {'type': 'string'}, 'scale': {'type': 'integer', 'minimum': 0}, 'value': {'type': 'string', 'pattern': '^-?(0|[1-9][0-9]*)(\\.[0-9]+)?$'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'TrustMetadata': {'type': 'object', 'required': ['source', 'freshness', 'reconciliation', 'completeness'], 'properties': {'source': {'$ref': '#/$defs/TrustSource'}, 'freshness': {'$ref': '#/$defs/TrustFreshness'}, 'completeness': {'$ref': '#/$defs/TrustCompleteness'}, 'reconciliation': {'$ref': '#/$defs/TrustReconciliation'}}}, 'TraderPnlExact': {'type': 'object', 'required': ['realized'], 'properties': {'realized': {'$ref': '#/$defs/ExactDecimal'}}}, 'TrustFreshness': {'type': 'object', 'required': ['status'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'status': {'enum': ['fresh', 'refreshing', 'stale', 'not_live', 'unknown', 'unavailable'], 'type': 'string'}, 'max_age_s': {'type': 'integer', 'minimum': 0}}}, 'CategorySkillV2': {'type': 'object', 'required': ['status', 'model_version', 'taxonomy_version', 'platform', 'scope', 'source_coverage', 'canonical_category', 'as_of', 'source_last_success_at', 'observation_started_at', 'latest_observation_at', 'independent_event_count', 'resolved_condition_count', 'unresolved_observation_count', 'edge_mean', 'edge_sd', 'edge_se', 'edge_lower_95', 'brier_event_avg'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'scope': {'enum': ['observed_goldsky_primary_taker_fill'], 'type': 'string'}, 'status': {'enum': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'type': 'string'}, 'edge_sd': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'edge_se': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'platform': {'enum': ['polymarket'], 'type': 'string'}, 'edge_mean': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'edge_lower_95': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'model_version': {'type': 'string'}, 'brier_event_avg': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'taxonomy_version': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'canonical_category': {'type': 'string'}, 'latest_observation_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}, 'observation_started_at': {'type': 'string', 'format': 'date-time'}, 'source_last_success_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}, 'independent_event_count': {'type': 'integer', 'minimum': 0}, 'resolved_condition_count': {'type': 'integer', 'minimum': 0}, 'unresolved_observation_count': {'type': 'integer', 'minimum': 0}}}, 'DataQualityGroup': {'type': 'object', 'required': ['group', 'owner', 'status'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'group': {'type': 'string'}, 'owner': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'enum': ['fresh', 'partial', 'unknown', 'untracked', 'unavailable'], 'type': 'string'}}}, 'TraderStatsExact': {'type': 'object', 'required': ['total_volume'], 'properties': {'total_volume': {'$ref': '#/$defs/ExactDecimal'}}}, 'TrustCompleteness': {'type': 'object', 'required': ['status'], 'properties': {'detail': {'type': 'string'}, 'status': {'enum': ['complete', 'partial', 'not_computed', 'not_applicable', 'unavailable'], 'type': 'string'}}}, 'TrustReconciliation': {'type': 'object', 'required': ['status'], 'properties': {'detail': {'type': 'string'}, 'status': {'enum': ['provider_backed', 'db_mirror', 'computed', 'partial', 'not_applicable', 'unavailable'], 'type': 'string'}}}, 'CategorySkillModelReadiness': {'type': 'object', 'required': ['status', 'model_version', 'taxonomy_version', 'observation_started_at', 'as_of', 'source_last_success_at'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'status': {'enum': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'type': 'string'}, 'model_version': {'type': 'string'}, 'taxonomy_version': {'type': 'string'}, 'observation_started_at': {'type': 'string', 'format': 'date-time'}, 'source_last_success_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}}}}, 'anyOf': [{'allOf': [{'$ref': '#/$defs/Trader'}, {'type': 'object', 'required': ['meta'], 'properties': {'meta': {'$ref': '#/$defs/ResponseMeta'}}}]}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_trader_export_snapshot
Get Trader Export Snapshot
Read export source-range, completeness, volume reconciliation, row-count estimate, and large-export policy for one trader. Metadata only; does not start an export job. Args: - address (string, required): Trader wallet address, known username-style lookup, or trd_-prefixed trader ID emitted by the API. Bare integer database IDs are not accepted Returns: Trader export snapshot metadata.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['address'], 'properties': {'address': {'type': 'string', 'minLength': 1, 'description': 'Trader wallet address, known username-style lookup, or trd_-prefixed trader ID emitted by the API. Bare integer database IDs are not accepted'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'ExportCounts': {'type': 'object', 'required': ['pnl_days', 'exported_markets', 'estimated_trade_rows', 'estimated_size_mb'], 'properties': {'pnl_days': {'type': 'integer'}, 'exported_markets': {'type': 'integer'}, 'estimated_size_mb': {'type': 'number'}, 'estimated_trade_rows': {'type': 'integer'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'ExportSourceRange': {'type': 'object', 'required': ['first_pnl_date', 'last_pnl_date', 'latest_trade_at', 'latest_market_activity_at'], 'properties': {'last_pnl_date': {'anyOf': [{'type': 'string', 'format': 'date'}, {'type': 'null'}]}, 'first_pnl_date': {'anyOf': [{'type': 'string', 'format': 'date'}, {'type': 'null'}]}, 'latest_trade_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}, 'latest_market_activity_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}}}, 'LargeExportPolicy': {'type': 'object', 'required': ['mode', 'current_internal_route', 'v1_async', 'direct_streaming', 'async_job', 'rate_limit'], 'properties': {'mode': {'type': 'string', 'const': 'v1_async_export'}, 'v1_async': {'type': 'object', 'properties': {'formats': {'type': 'array', 'items': {'enum': ['json', 'ndjson', 'csv'], 'type': 'string'}}, 'retention': {'type': 'string'}, 'cancel_route': {'type': 'string'}, 'status_route': {'type': 'string'}, 'submit_route': {'type': 'string'}, 'status_values': {'type': 'array', 'items': {'enum': ['queued', 'running', 'ready', 'failed', 'reconcile_required', 'expired', 'cancel_requested', 'cancelled'], 'type': 'string'}}, 'download_route': {'type': 'string'}}}, 'async_job': {'type': 'object'}, 'rate_limit': {'type': 'object'}, 'direct_streaming': {'type': 'object'}, 'current_internal_route': {'type': 'string'}}}, 'ExportCompleteness': {'type': 'object', 'required': ['status', 'reason', 'sync_coverage'], 'properties': {'reason': {'type': 'string'}, 'status': {'enum': ['complete', 'partial', 'empty'], 'type': 'string'}, 'sync_coverage': {'type': 'number', 'minimum': 0}}}, 'TraderExportSnapshot': {'type': 'object', 'required': ['address', 'generated_at', 'source_range', 'completeness', 'reconciliation', 'counts', 'large_export_policy'], 'properties': {'counts': {'$ref': '#/$defs/ExportCounts'}, 'address': {'type': 'string'}, 'completeness': {'$ref': '#/$defs/ExportCompleteness'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'source_range': {'$ref': '#/$defs/ExportSourceRange'}, 'reconciliation': {'$ref': '#/$defs/ExportVolumeReconciliation'}, 'large_export_policy': {'$ref': '#/$defs/LargeExportPolicy'}}}, 'ExportVolumeReconciliation': {'type': 'object', 'required': ['provider_lifetime_volume', 'exported_activity_volume', 'exported_market_cost_basis', 'provider_activity_volume_gap', 'activity_volume_coverage'], 'properties': {'activity_volume_coverage': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'exported_activity_volume': {'type': 'number'}, 'provider_lifetime_volume': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'exported_market_cost_basis': {'type': 'number'}, 'provider_activity_volume_gap': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}}}, 'anyOf': [{'allOf': [{'$ref': '#/$defs/TraderExportSnapshot'}, {'type': 'object', 'required': ['meta'], 'properties': {'meta': {'$ref': '#/$defs/ResponseMeta'}}}]}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_trader_pnl
Get Trader P&L Time Series
Get a trader's daily P&L time series and pre-derived stats from the precomputed daily_pnl read model. Returns entries (daily cumulative P&L), period stats (all/90d/30d/7d), monthly aggregation, per-year totals, and the drawdown series. Reads the refreshed read model, not a per-request equity replay. A resolved trader with no daily P&L returns an empty structured object (HTTP 200); an unknown address returns not found. Args: - address (string, required): Wallet address (0x...), username, or trd_-prefixed trader id - from / to (string, optional): Inclusive UTC calendar dates (YYYY-MM-DD) bounding the daily series (entries and drawdown); stats, monthly and year_totals stay defined over the full history - sections (string[], optional): Which sections to return: "entries", "stats", "monthly", "year_totals", "drawdown"; omit for all five. A section left out is absent, and an unrecognized name is an error, never ignored Returns: Structured trader P&L object (entries, stats, monthly, year_totals, drawdown). A request that sent from, to or sections also carries view: the bounds applied, the sections present, entries_total, entries_in_window and the pre-window anchor.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['address'], 'properties': {'to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Inclusive UTC calendar-date upper bound (YYYY-MM-DD) for the daily series (entries and drawdown); omit for the whole stored history. Must not be before from'}, 'from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Inclusive UTC calendar-date lower bound (YYYY-MM-DD) for the daily series (entries and drawdown); omit for the whole stored history. Does not change stats, monthly or year_totals'}, 'address': {'type': 'string', 'maxLength': 100, 'minLength': 1, 'description': 'Wallet address (0x...), username, or trd_-prefixed trader id'}, 'sections': {'type': 'array', 'items': {'enum': ['entries', 'stats', 'monthly', 'year_totals', 'drawdown'], 'type': 'string'}, 'description': 'Which sections of the object to return; omit for all five. A section left out is absent from the result, never null or empty'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'TraderPnl': {'type': 'object', 'required': ['id', 'freshness_at'], 'properties': {'id': {'type': 'string'}, 'view': {'type': 'object', 'required': ['from', 'to', 'sections', 'entries_total', 'entries_in_window', 'anchor'], 'properties': {'to': {'anyOf': [{'type': 'string', 'format': 'date'}, {'type': 'null'}]}, 'from': {'anyOf': [{'type': 'string', 'format': 'date'}, {'type': 'null'}]}, 'anchor': {'anyOf': [{'type': 'object', 'required': ['date', 'cumulative_profit', 'total_pnl', 'drawdown'], 'properties': {'date': {'type': 'string', 'format': 'date'}, 'drawdown': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'total_pnl': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'cumulative_profit': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'null'}]}, 'sections': {'type': 'array', 'items': {'enum': ['entries', 'stats', 'monthly', 'year_totals', 'drawdown'], 'type': 'string'}}, 'entries_total': {'type': 'integer'}, 'entries_in_window': {'type': 'integer'}}, 'additionalProperties': False}, 'stats': {'type': 'object', 'required': ['all', 'd90', 'd30', 'd7'], 'properties': {'d7': {'type': 'object', 'required': ['current', 'change', 'change_pct', 'best_day', 'worst_day', 'win_days', 'loss_days', 'avg_day', 'rebase_anchor'], 'properties': {'change': {'type': 'number'}, 'avg_day': {'type': 'number'}, 'current': {'type': 'number'}, 'best_day': {'type': 'number'}, 'win_days': {'type': 'integer'}, 'loss_days': {'type': 'integer'}, 'worst_day': {'type': 'number'}, 'change_pct': {'type': 'number'}, 'best_day_date': {'type': 'string', 'format': 'date'}, 'rebase_anchor': {'type': 'number'}, 'worst_day_date': {'type': 'string', 'format': 'date'}}}, 'all': {'type': 'object', 'required': ['current', 'change', 'change_pct', 'best_day', 'worst_day', 'win_days', 'loss_days', 'avg_day', 'rebase_anchor'], 'properties': {'change': {'type': 'number'}, 'avg_day': {'type': 'number'}, 'current': {'type': 'number'}, 'best_day': {'type': 'number'}, 'win_days': {'type': 'integer'}, 'loss_days': {'type': 'integer'}, 'worst_day': {'type': 'number'}, 'change_pct': {'type': 'number'}, 'best_day_date': {'type': 'string', 'format': 'date'}, 'rebase_anchor': {'type': 'number'}, 'worst_day_date': {'type': 'string', 'format': 'date'}}}, 'd30': {'type': 'object', 'required': ['current', 'change', 'change_pct', 'best_day', 'worst_day', 'win_days', 'loss_days', 'avg_day', 'rebase_anchor'], 'properties': {'change': {'type': 'number'}, 'avg_day': {'type': 'number'}, 'current': {'type': 'number'}, 'best_day': {'type': 'number'}, 'win_days': {'type': 'integer'}, 'loss_days': {'type': 'integer'}, 'worst_day': {'type': 'number'}, 'change_pct': {'type': 'number'}, 'best_day_date': {'type': 'string', 'format': 'date'}, 'rebase_anchor': {'type': 'number'}, 'worst_day_date': {'type': 'string', 'format': 'date'}}}, 'd90': {'type': 'object', 'required': ['current', 'change', 'change_pct', 'best_day', 'worst_day', 'win_days', 'loss_days', 'avg_day', 'rebase_anchor'], 'properties': {'change': {'type': 'number'}, 'avg_day': {'type': 'number'}, 'current': {'type': 'number'}, 'best_day': {'type': 'number'}, 'win_days': {'type': 'integer'}, 'loss_days': {'type': 'integer'}, 'worst_day': {'type': 'number'}, 'change_pct': {'type': 'number'}, 'best_day_date': {'type': 'string', 'format': 'date'}, 'rebase_anchor': {'type': 'number'}, 'worst_day_date': {'type': 'string', 'format': 'date'}}}}}, 'entries': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'daily_change'], 'properties': {'date': {'type': 'string', 'format': 'date'}, 'total_pnl': {'type': 'number'}, 'daily_change': {'type': 'number'}, 'total_volume': {'type': 'number'}, 'markets_traded': {'type': 'integer'}, 'cumulative_profit': {'type': 'number'}}}}, 'monthly': {'type': 'array', 'items': {'type': 'object', 'required': ['year', 'month', 'pnl', 'markets_traded'], 'properties': {'pnl': {'type': 'number'}, 'year': {'type': 'integer'}, 'month': {'type': 'integer'}, 'markets_traded': {'type': 'integer'}}}}, 'drawdown': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'cumulative_profit', 'drawdown'], 'properties': {'date': {'type': 'string', 'format': 'date'}, 'drawdown': {'type': 'number'}, 'cumulative_profit': {'type': 'number'}}}}, 'year_totals': {'type': 'array', 'items': {'type': 'object', 'required': ['year', 'pnl'], 'properties': {'pnl': {'type': 'number'}, 'year': {'type': 'integer'}}}}, 'freshness_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}}, 'anyOf': [{'allOf': [{'$ref': '#/$defs/TraderPnl'}, {'type': 'object', 'required': ['meta'], 'properties': {'meta': {'$ref': '#/$defs/ResponseMeta'}}}]}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_trending_wallets
List Trending Wallets
List wallets ranked by trailing-window realized P&L (Polymarket-only discovery). Each row carries the window P&L, volume, distinct markets, grade, hot-streak tier, and a shape-only daily P&L series (per-day deltas from the provider curve; dates ascending, gaps are gaps — NOT zero-filled, and not guaranteed to sum to the window P&L). Cursor-paginated by window P&L descending. A cold read model returns a 503 retry-after (warming), never a 500 or fabricated ranking. Args: - limit (number, 1-50, default 20): Max results per page - cursor (string, optional): Opaque pagination cursor from previous response - window (string, optional): Trailing window: "7d" (default) or "30d" Returns: Ranked trending wallets with window stats and pagination metadata.
Read only Idempotent
Input schema 
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 50, 'minimum': 1, 'description': 'Max results (1-50, default 20; the provider board caps the ranked set at 50)'}, 'cursor': {'type': 'string', 'description': 'Opaque pagination cursor from previous response'}, 'window': {'enum': ['7d', '30d'], 'type': 'string', 'default': '7d', 'description': 'Trailing window (default 7d)'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'TrendingWallet': {'type': 'object', 'required': ['id', 'address', 'rank', 'platform', 'trending_pnl_usd', 'window_markets_traded', 'window_trade_days', 'daily_pnl_series'], 'properties': {'id': {'type': 'string'}, 'rank': {'type': 'integer'}, 'grade': {'enum': ['S', 'A', 'B', 'C', 'D', 'F'], 'type': 'string'}, 'address': {'type': 'string'}, 'platform': {'enum': ['polymarket'], 'type': 'string'}, 'username': {'type': 'string'}, 'last_synced': {'type': 'string', 'format': 'date-time'}, 'streak_tier': {'enum': ['hot', 'rising', 'neutral', 'cooling', 'cold'], 'type': 'string'}, 'all_time_score': {'type': 'number'}, 'all_time_pnl_usd': {'type': 'number'}, 'daily_pnl_series': {'type': 'array', 'items': {'type': 'object', 'required': ['date', 'pnl_usd'], 'properties': {'date': {'type': 'string', 'format': 'date'}, 'pnl_usd': {'type': 'number'}}}}, 'trending_pnl_usd': {'type': 'number'}, 'profile_image_url': {'type': 'string'}, 'window_trade_days': {'type': 'integer'}, 'window_volume_usd': {'type': 'number'}, 'window_volume_shares': {'type': 'number'}, 'window_markets_traded': {'type': 'integer'}}}}, 'anyOf': [{'type': 'object', 'required': ['data', 'has_more', 'next_cursor', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/TrendingWallet'}}, 'meta': {'$ref': '#/$defs/ResponseMeta'}, 'total': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_webhook
Get Webhook Endpoint
Read-only lookup of one webhook endpoint owned by the authenticated API key user. This does not create, update, verify, rotate, or delete webhook endpoints. Args: - id (number, required): Webhook endpoint id Returns: Webhook endpoint configuration record.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'integer', 'minimum': 1, 'description': 'Webhook endpoint id'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'WebhookStatus': {'enum': ['pending_verification', 'active', 'disabled'], 'type': 'string'}, 'WebhookEndpoint': {'type': 'object', 'required': ['id', 'object', 'name', 'url', 'event_types', 'trade_filters', 'status', 'verified_at', 'verification_token_expires_at', 'failure_count', 'created_at', 'updated_at', 'retry_policy', 'secret_rotation'], 'properties': {'id': {'type': 'integer', 'format': 'int64'}, 'url': {'type': 'string', 'format': 'uri'}, 'name': {'type': 'string'}, 'object': {'type': 'string', 'const': 'webhook'}, 'status': {'$ref': '#/$defs/WebhookStatus'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'event_types': {'type': 'array', 'items': {'$ref': '#/$defs/WebhookEventType'}}, 'verified_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}, 'retry_policy': {'$ref': '#/$defs/WebhookRetryPolicy'}, 'verification': {'$ref': '#/$defs/WebhookVerification'}, 'failure_count': {'type': 'integer'}, 'trade_filters': {'$ref': '#/$defs/LargeTradeSubscriptionFilters'}, 'signing_secret': {'type': 'string'}, 'secret_rotation': {'$ref': '#/$defs/WebhookSecretRotation'}, 'verification_token_expires_at': {'type': 'string', 'format': 'date-time'}}}, 'WebhookEventType': {'enum': ['large_trade_inserted_v2', 'large_trades_inserted', 'whale_trades_inserted', 'live_sports_updated', 'trader_synced', 'whale_trader_synced', 'large_positions_updated', 'wallet_grade_changed', 'suspicious_trade_flagged', 'insider_radar_flag_raised', 'sharp_money_flow_detected', 'smart_money_flow_detected', 'export_job_ready', 'export_job_failed', 'export_job_expired', 'export_job_cancelled'], 'type': 'string'}, 'WebhookRetryPolicy': {'type': 'object', 'required': ['max_attempts', 'terminal_status', 'retry_horizon_seconds', 'disable_after_consecutive_failures'], 'properties': {'max_attempts': {'type': 'integer', 'const': 8}, 'terminal_status': {'type': 'string', 'const': 'dead_letter'}, 'retry_horizon_seconds': {'type': 'integer', 'const': 7380}, 'disable_after_consecutive_failures': {'type': 'integer', 'const': 8}}}, 'WebhookVerification': {'type': 'object', 'required': ['token', 'expires_at'], 'properties': {'token': {'type': 'string'}, 'expires_at': {'type': 'string', 'format': 'date-time'}}}, 'WebhookSecretRotation': {'type': 'object', 'required': ['status', 'overlap_expires_at'], 'properties': {'status': {'enum': ['idle', 'pending', 'overlap'], 'type': 'string'}, 'overlap_expires_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}}}, 'LargeTradeSubscriptionFilters': {'type': 'object', 'properties': {'wallet': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{40}$'}, 'min_grade': {'enum': ['S', 'A', 'B', 'C', 'D', 'F'], 'type': 'string'}, 'condition_id': {'type': 'string'}, 'min_size_usd': {'type': 'string', 'pattern': '^[0-9]+(\\.[0-9]{1,6})?$'}}, 'additionalProperties': False}}, 'anyOf': [{'allOf': [{'$ref': '#/$defs/WebhookEndpoint'}, {'type': 'object', 'required': ['meta'], 'properties': {'meta': {'$ref': '#/$defs/ResponseMeta'}}}]}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_weekly_report_snapshot
Get Weekly Report Snapshot
Read one weekly whale-activity report snapshot. Pass either from/to UTC dates or an ISO YYYY-WW week token. Args: - week (string, optional): YYYY-WW selector - from/to (string, optional): UTC dates in YYYY-MM-DD format Returns: Report snapshot metadata and entries.
Read only Idempotent
Input schema 
{'type': 'object', 'oneOf': [{'not': {'anyOf': [{'required': ['from']}, {'required': ['to']}]}, 'required': ['week']}, {'not': {'required': ['week']}, 'required': ['from', 'to']}], 'properties': {'to': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'UTC source-range end in YYYY-MM-DD format'}, 'from': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'UTC source-range start in YYYY-MM-DD format'}, 'week': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}$', 'description': 'ISO week selector in YYYY-WW format'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'ReportPayload': {'type': 'object', 'required': ['total_large_trades', 'total_whale_trades', 'total_large_trade_volume', 'total_whale_volume', 'biggest_trade_size', 'active_traders', 'top_large_trades', 'top_whale_trades', 'categories', 'grade_distribution'], 'properties': {'categories': {'anyOf': [{'type': 'array', 'items': {'type': 'object'}}, {'type': 'null'}]}, 'active_traders': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'top_large_trades': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'required': ['outcome', 'side', 'title', 'size', 'price', 'token_id', 'id', 'trade_time', 'market_category', 'platform', 'name', 'pseudonym', 'trader_grade'], 'properties': {'id': {'anyOf': [{'type': 'integer', 'format': 'int64'}, {'type': 'null'}]}, 'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'side': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'size': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'price': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'outcome': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'platform': {'anyOf': [{'enum': ['polymarket'], 'type': 'string'}, {'type': 'null'}]}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'pseudonym': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'trade_time': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}, 'trader_grade': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'market_category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}}}, {'type': 'null'}]}, 'top_whale_trades': {'anyOf': [{'type': 'array', 'items': {'type': 'object', 'required': ['outcome', 'side', 'title', 'size', 'price', 'token_id', 'id', 'trade_time', 'market_category', 'platform', 'name', 'pseudonym', 'trader_grade'], 'properties': {'id': {'anyOf': [{'type': 'integer', 'format': 'int64'}, {'type': 'null'}]}, 'name': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'side': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'size': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'price': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'title': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'outcome': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'platform': {'anyOf': [{'enum': ['polymarket'], 'type': 'string'}, {'type': 'null'}]}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'pseudonym': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'trade_time': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}, 'trader_grade': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'market_category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}}}, {'type': 'null'}]}, 'biggest_trade_size': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'grade_distribution': {'anyOf': [{'type': 'array', 'items': {'type': 'object'}}, {'type': 'null'}]}, 'total_large_trades': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'total_whale_trades': {'anyOf': [{'type': 'integer'}, {'type': 'null'}]}, 'total_whale_volume': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'total_large_trade_volume': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}}}, 'SnapshotState': {'type': 'object', 'required': ['version', 'storage', 'status', 'generated_at', 'mutable_until', 'period_closed', 'final_after', 'source_read_started_at'], 'properties': {'status': {'enum': ['final', 'rolling'], 'type': 'string'}, 'storage': {'enum': ['durable', 'ephemeral'], 'type': 'string'}, 'version': {'type': 'integer', 'format': 'int64'}, 'final_after': {'type': 'string', 'format': 'date-time'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'mutable_until': {'anyOf': [{'type': 'string', 'format': 'date'}, {'type': 'null'}]}, 'period_closed': {'type': 'boolean'}, 'source_read_started_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}}}, 'ReportSnapshot': {'type': 'object', 'required': ['kind', 'generated_at', 'source_range', 'snapshot', 'completeness', 'reconciliation', 'report'], 'properties': {'kind': {'enum': ['daily', 'weekly', 'monthly'], 'type': 'string'}, 'report': {'$ref': '#/$defs/ReportPayload'}, 'snapshot': {'$ref': '#/$defs/SnapshotState'}, 'completeness': {'$ref': '#/$defs/SnapshotCompleteness'}, 'generated_at': {'type': 'string', 'format': 'date-time'}, 'source_range': {'$ref': '#/$defs/ReportSourceRange'}, 'reconciliation': {'$ref': '#/$defs/ReportReconciliation'}}}, 'ReportSourceRange': {'type': 'object', 'required': ['start_date', 'end_date', 'timezone'], 'properties': {'end_date': {'type': 'string', 'format': 'date'}, 'timezone': {'type': 'string', 'const': 'UTC'}, 'start_date': {'type': 'string', 'format': 'date'}}}, 'ReportReconciliation': {'type': 'object', 'required': ['volume_kind', 'whale_volume_source', 'notes'], 'properties': {'notes': {'type': 'string'}, 'volume_kind': {'type': 'string', 'const': 'local_whale_activity_volume'}, 'whale_volume_source': {'type': 'string'}}}, 'SnapshotCompleteness': {'type': 'object', 'required': ['status', 'reason', 'expected_days', 'covered_days_with_whale_activity'], 'properties': {'reason': {'type': 'string'}, 'status': {'enum': ['complete', 'partial', 'empty'], 'type': 'string'}, 'expected_days': {'type': 'integer'}, 'covered_days_with_whale_activity': {'type': 'integer'}, 'covered_days_with_large_trade_activity': {'type': 'integer'}}}}, 'anyOf': [{'allOf': [{'$ref': '#/$defs/ReportSnapshot'}, {'type': 'object', 'required': ['meta'], 'properties': {'meta': {'$ref': '#/$defs/ResponseMeta'}}}]}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_whale_trade
Get Whale Trade
Deprecated alias of get_large_trade (#16304), kept live; it calls the deprecated /api/v1/whale-trades/{id} path, whose envelope keeps object: whale_trade. Read one whale trade by ID. Accepts either the wt_ ID returned by whale-trade list/history responses or the raw numeric whale_alerts.id. Args: - id (string, required): Whale trade ID such as wt_123 or 123 Returns: One whale trade with trader info, market context, size, side, price, current review_score (signal_score is its deprecated twin, same value) and trader grade, point-in-time recorded_review_score (recorded_signal_score is its deprecated twin; null before 2026-08-03) and trader grade_at_trade with grade_at_trade_status (unknown before 2026-09-19), optional suspicion_score, and optional suspicion_track. A null suspicion track means the persisted legacy row has no track label.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'minLength': 1, 'description': 'Large trade ID such as wt_123 or 123'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'LargeTrade': {'type': 'object', 'required': ['id', 'traded_at', 'size_usd', 'side', 'outcome', 'token_id', 'price', 'review_score', 'signal_score', 'recorded_review_score', 'recorded_signal_score', 'suspicion_score', 'suspicion_track', 'trader', 'market'], 'properties': {'id': {'type': 'string'}, 'side': {'enum': ['BUY', 'SELL'], 'type': 'string'}, 'price': {'type': 'number'}, 'market': {'type': 'object', 'required': ['id', 'condition_id', 'title'], 'properties': {'id': {'type': 'string'}, 'slug': {'type': 'string'}, 'title': {'type': 'string'}, 'category': {'type': 'string'}, 'condition_id': {'type': 'string'}}}, 'trader': {'type': 'object', 'required': ['id', 'address', 'grade_at_trade', 'grade_at_trade_status'], 'properties': {'id': {'type': 'string'}, 'grade': {'type': 'string'}, 'address': {'type': 'string'}, 'username': {'type': 'string'}, 'grade_at_trade': {'anyOf': [{'enum': ['S', 'A', 'B', 'C', 'D', 'F'], 'type': 'string'}, {'type': 'null'}]}, 'grade_at_trade_status': {'enum': ['graded', 'ungraded', 'unknown'], 'type': 'string'}}}, 'outcome': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'size_usd': {'type': 'number'}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'traded_at': {'type': 'string', 'format': 'date-time'}, 'review_score': {'type': 'number'}, 'signal_score': {'type': 'number', 'deprecated': True}, 'suspicion_score': {'anyOf': [{'type': 'integer', 'maximum': 100, 'minimum': 0}, {'type': 'null'}]}, 'suspicion_track': {'anyOf': [{'enum': ['whale', 'fresh_conviction', 'sliced_position'], 'type': 'string'}, {'type': 'null'}]}, 'market_volume_share': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'recorded_review_score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'recorded_signal_score': {'anyOf': [{'type': 'number', 'deprecated': True}, {'type': 'null'}]}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'LargeTradeDetail': {'allOf': [{'$ref': '#/$defs/LargeTrade'}, {'type': 'object', 'required': ['counterparty_analysis'], 'properties': {'counterparty_analysis': {'$ref': '#/$defs/CounterpartyAnalysis'}}}]}, 'CounterpartyAnalysis': {'type': 'object', 'required': ['status', 'execution_count', 'available_execution_count', 'unavailable_execution_count', 'executions'], 'properties': {'status': {'enum': ['available', 'partial', 'unavailable'], 'type': 'string'}, 'executions': {'type': 'array', 'items': {'$ref': '#/$defs/CounterpartyExecution'}}, 'analysis_id': {'type': 'string'}, 'snapshot_id': {'type': 'string'}, 'execution_count': {'type': 'integer'}, 'unavailable_reason': {'type': 'string'}, 'executions_next_cursor': {'type': 'string'}, 'available_execution_count': {'type': 'integer'}, 'unavailable_execution_count': {'type': 'integer'}}}, 'CounterpartyExecution': {'type': 'object', 'required': ['execution_id', 'exchange_family', 'transaction_hash', 'orders_matched_log_index', 'taker', 'makers'], 'properties': {'taker': {'$ref': '#/$defs/CounterpartyParticipant'}, 'makers': {'type': 'array', 'items': {'$ref': '#/$defs/CounterpartyParticipant'}}, 'execution_id': {'type': 'string'}, 'exchange_family': {'enum': ['ctf_v2', 'neg_risk_ctf_v2'], 'type': 'string'}, 'transaction_hash': {'type': 'string'}, 'makers_next_cursor': {'type': 'string'}, 'orders_matched_log_index': {'type': 'integer'}}}, 'CounterpartyParticipant': {'type': 'object', 'required': ['counterparty_key', 'execution_wallet', 'identity_status', 'maker_fill_count', 'filled_shares', 'filled_usdc', 'share_pct', 'match_breakdown'], 'properties': {'grade': {'type': 'string'}, 'share_pct': {'type': 'string'}, 'filled_usdc': {'type': 'string'}, 'display_name': {'type': 'string'}, 'filled_shares': {'type': 'string'}, 'wallet_family': {'type': 'string'}, 'last_traded_at': {'type': 'string', 'format': 'date-time'}, 'identity_status': {'enum': ['resolved', 'infrastructure', 'unavailable'], 'type': 'string'}, 'match_breakdown': {'type': 'array', 'items': {'$ref': '#/$defs/CounterpartyMatchBreakdown'}}, 'profile_segment': {'type': 'string'}, 'counterparty_key': {'type': 'string'}, 'execution_wallet': {'type': 'string'}, 'maker_fill_count': {'type': 'integer'}, 'resolution_block': {'type': 'integer'}, 'resolved_user_id': {'type': 'string'}, 'resolution_source': {'type': 'string'}}}, 'CounterpartyMatchBreakdown': {'type': 'object', 'required': ['match_type', 'maker_fill_count', 'filled_shares'], 'properties': {'match_type': {'enum': ['COMPLEMENTARY', 'MINT', 'MERGE'], 'type': 'string'}, 'filled_shares': {'type': 'string'}, 'maker_fill_count': {'type': 'integer'}}}}, 'anyOf': [{'allOf': [{'$ref': '#/$defs/LargeTradeDetail'}, {'type': 'object', 'required': ['meta'], 'properties': {'meta': {'$ref': '#/$defs/ResponseMeta'}}}]}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_whale_trades
List Whale Trades
Deprecated alias of get_large_trades (#16304), kept live; it calls the deprecated /api/v1/whale-trades path. Get recent large trades from graded prediction market traders. Each trade includes a 0-1 review score, persisted suspicion facts, trader grade, and market context. Cursor-paginated, newest first. Args: - limit (number, 1-100, default 20): Max results per page - cursor (string, optional): Pagination cursor from previous response - min_size (number, default 5000): Minimum trade size in USD - category (string, optional): Filter by market category (case-insensitive) - min_grade (string, optional): Minimum trader grade (S, A, B, C, D, F) - suspicious_only (boolean, optional): Keep only persisted suspicion_score >= 60; false preserves the current result set - min_market_volume_share (number, 0-1, optional): Keep only trades whose market_volume_share is known and at least this; a fraction, so 0.01 is one percent of the market's traded volume - sort (string, optional): "recent" (default, newest first) or "market_volume_share" (biggest share of its market first, over the last 30 days, or from the from bound on the history tools; a cursor is bound to the order it was minted in) - since (string, optional): wt_ id of a trade a previous call returned; answers only the trades recorded after it, in commit order, so a trade recorded late still arrives. Poll with the first trade of the last answer that had trades and deduplicate on id; recent order only Returns: List of whale trades with trader info, market context, size, side, price, current review_score (signal_score is its deprecated twin, same value) and trader grade, point-in-time recorded_review_score (recorded_signal_score is its deprecated twin; null before 2026-08-03) and trader grade_at_trade with grade_at_trade_status (unknown before 2026-09-19), optional suspicion_score, and optional suspicion_track. A null suspicion track means the persisted legacy row has no track label. The page carries data_quality beside data: status, as_of (the oldest clock the page rests on) and field_groups. fresh means tracked and clocked, not current: compare as_of with your own tolerance. unknown means this read cannot date that group, never that it is recent.
Read only Idempotent
Input schema 
{'type': 'object', 'properties': {'sort': {'enum': ['recent', 'market_volume_share'], 'type': 'string', 'default': 'recent', 'description': "Order of the page. recent is newest first. market_volume_share ranks by each trade's share of its market's traded volume, biggest first, a trade whose share is unavailable last, over the last 30 days. A cursor is bound to the order it was minted in"}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Max results (1-100, default 20)'}, 'since': {'type': 'string', 'description': 'wt_ id of a trade a previous call returned: answer only the trades recorded after it, in commit order, so a trade recorded late still arrives and none is skipped. Poll with the first trade of the last answer that had trades and deduplicate on id. Recent order only'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor from previous response'}, 'category': {'type': 'string', 'description': 'Filter by market category (case-insensitive)'}, 'min_size': {'type': 'number', 'default': 5000, 'minimum': 0, 'description': 'Minimum trade size in USD (default 5000)'}, 'min_grade': {'enum': ['S', 'A', 'B', 'C', 'D', 'F'], 'type': 'string', 'description': 'Minimum trader grade'}, 'suspicious_only': {'type': 'boolean', 'default': False, 'description': 'Keep only rows with persisted suspicion_score >= 60'}, 'min_market_volume_share': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': "Keep only trades whose market_volume_share is known and at least this. A fraction, not a percent: 0.01 is one percent of the market's traded volume. A trade whose share is unavailable is never returned by a non-zero value"}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'LargeTrade': {'type': 'object', 'required': ['id', 'traded_at', 'size_usd', 'side', 'outcome', 'token_id', 'price', 'review_score', 'signal_score', 'recorded_review_score', 'recorded_signal_score', 'suspicion_score', 'suspicion_track', 'trader', 'market'], 'properties': {'id': {'type': 'string'}, 'side': {'enum': ['BUY', 'SELL'], 'type': 'string'}, 'price': {'type': 'number'}, 'market': {'type': 'object', 'required': ['id', 'condition_id', 'title'], 'properties': {'id': {'type': 'string'}, 'slug': {'type': 'string'}, 'title': {'type': 'string'}, 'category': {'type': 'string'}, 'condition_id': {'type': 'string'}}}, 'trader': {'type': 'object', 'required': ['id', 'address', 'grade_at_trade', 'grade_at_trade_status'], 'properties': {'id': {'type': 'string'}, 'grade': {'type': 'string'}, 'address': {'type': 'string'}, 'username': {'type': 'string'}, 'grade_at_trade': {'anyOf': [{'enum': ['S', 'A', 'B', 'C', 'D', 'F'], 'type': 'string'}, {'type': 'null'}]}, 'grade_at_trade_status': {'enum': ['graded', 'ungraded', 'unknown'], 'type': 'string'}}}, 'outcome': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'size_usd': {'type': 'number'}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'traded_at': {'type': 'string', 'format': 'date-time'}, 'review_score': {'type': 'number'}, 'signal_score': {'type': 'number', 'deprecated': True}, 'suspicion_score': {'anyOf': [{'type': 'integer', 'maximum': 100, 'minimum': 0}, {'type': 'null'}]}, 'suspicion_track': {'anyOf': [{'enum': ['whale', 'fresh_conviction', 'sliced_position'], 'type': 'string'}, {'type': 'null'}]}, 'market_volume_share': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'recorded_review_score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'recorded_signal_score': {'anyOf': [{'type': 'number', 'deprecated': True}, {'type': 'null'}]}}}, 'DataQuality': {'type': 'object', 'required': ['status', 'field_groups'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'status': {'enum': ['fresh', 'partial', 'unknown', 'untracked', 'unavailable'], 'type': 'string'}, 'field_groups': {'type': 'array', 'items': {'$ref': '#/$defs/DataQualityGroup'}}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'DataQualityGroup': {'type': 'object', 'required': ['group', 'owner', 'status'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'group': {'type': 'string'}, 'owner': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'enum': ['fresh', 'partial', 'unknown', 'untracked', 'unavailable'], 'type': 'string'}}}}, 'anyOf': [{'type': 'object', 'required': ['data', 'has_more', 'next_cursor', 'data_quality', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/LargeTrade'}}, 'meta': {'$ref': '#/$defs/ResponseMeta'}, 'total': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'data_quality': {'$ref': '#/$defs/DataQuality'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
get_whale_trades_history
Replay Historical Whale Trades
Deprecated alias of get_large_trades_history (#16304), kept live; it calls the deprecated /api/v1/whale-trades/history path. Replay historical whale trades from local whale_alerts rows. Supports cursor pagination plus condition, trader, category, grade, platform, suspicion, market-share, and RFC3339 from/to filters, and a market_volume_share sort. Args: - limit (number, 1-100, default 20) - cursor (string, optional): Pagination cursor with wth_ prefix - min_size (number, optional): Minimum trade size in USD - condition_id (string, optional): Exact raw provider condition_id - trader (string, optional): Wallet, alias, or username - category (string, optional) - min_grade (string, optional): S, A, B, C, D, or F; filters on today's grade, not the grade at trade time - suspicious_only (boolean, optional): Keep only persisted suspicion_score >= 60 - platform (string, optional): polymarket or all - from/to (string, optional): RFC3339 traded_at bounds - min_market_volume_share (number, 0-1, optional): Keep only trades whose market_volume_share is known and at least this; a fraction, so 0.01 is one percent of the market's traded volume - sort (string, optional): "recent" (default, newest first) or "market_volume_share" (biggest share of its market first, over the last 30 days, or from the from bound on the history tools; a cursor is bound to the order it was minted in) Returns: Historical whale trades with replay metadata, current review_score (signal_score is its deprecated twin, same value) and trader grade, point-in-time recorded_review_score (recorded_signal_score is its deprecated twin; null before 2026-08-03) and trader grade_at_trade with grade_at_trade_status (unknown before 2026-09-19), optional suspicion_score, and optional suspicion_track. A null suspicion track means the persisted legacy row has no track label. The page carries data_quality beside data: status, as_of (the oldest clock the page rests on) and field_groups. fresh means tracked and clocked, not current: compare as_of with your own tolerance. unknown means this read cannot date that group, never that it is recent.
Read only Idempotent
Input schema 
{'type': 'object', 'properties': {'to': {'type': 'string', 'format': 'date-time', 'description': 'Exclusive traded_at upper bound'}, 'from': {'type': 'string', 'format': 'date-time', 'description': 'Inclusive traded_at lower bound'}, 'sort': {'enum': ['recent', 'market_volume_share'], 'type': 'string', 'default': 'recent', 'description': "Order of the page. recent is newest first. market_volume_share ranks by each trade's share of its market's traded volume, biggest first, a trade whose share is unavailable last, over from, or the last 30 days when from is omitted. A cursor is bound to the order it was minted in"}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Max results (1-100, default 20)'}, 'cursor': {'type': 'string', 'description': 'Pagination cursor from previous response'}, 'trader': {'type': 'string', 'description': 'Trader wallet, alias, or username'}, 'category': {'type': 'string', 'description': 'Filter by market category'}, 'min_size': {'type': 'number', 'default': 5000, 'minimum': 0, 'description': 'Minimum trade size in USD'}, 'platform': {'enum': ['polymarket', 'all'], 'type': 'string', 'description': 'Filter by provider platform'}, 'min_grade': {'enum': ['S', 'A', 'B', 'C', 'D', 'F'], 'type': 'string', 'description': 'Minimum trader grade'}, 'condition_id': {'type': 'string', 'description': 'Exact raw provider condition_id'}, 'suspicious_only': {'type': 'boolean', 'default': False, 'description': 'Keep only rows with persisted suspicion_score >= 60'}, 'min_market_volume_share': {'type': 'number', 'maximum': 1, 'minimum': 0, 'description': "Keep only trades whose market_volume_share is known and at least this. A fraction, not a percent: 0.01 is one percent of the market's traded volume. A trade whose share is unavailable is never returned by a non-zero value"}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'LargeTrade': {'type': 'object', 'required': ['id', 'traded_at', 'size_usd', 'side', 'outcome', 'token_id', 'price', 'review_score', 'signal_score', 'recorded_review_score', 'recorded_signal_score', 'suspicion_score', 'suspicion_track', 'trader', 'market'], 'properties': {'id': {'type': 'string'}, 'side': {'enum': ['BUY', 'SELL'], 'type': 'string'}, 'price': {'type': 'number'}, 'market': {'type': 'object', 'required': ['id', 'condition_id', 'title'], 'properties': {'id': {'type': 'string'}, 'slug': {'type': 'string'}, 'title': {'type': 'string'}, 'category': {'type': 'string'}, 'condition_id': {'type': 'string'}}}, 'trader': {'type': 'object', 'required': ['id', 'address', 'grade_at_trade', 'grade_at_trade_status'], 'properties': {'id': {'type': 'string'}, 'grade': {'type': 'string'}, 'address': {'type': 'string'}, 'username': {'type': 'string'}, 'grade_at_trade': {'anyOf': [{'enum': ['S', 'A', 'B', 'C', 'D', 'F'], 'type': 'string'}, {'type': 'null'}]}, 'grade_at_trade_status': {'enum': ['graded', 'ungraded', 'unknown'], 'type': 'string'}}}, 'outcome': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'size_usd': {'type': 'number'}, 'token_id': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'traded_at': {'type': 'string', 'format': 'date-time'}, 'review_score': {'type': 'number'}, 'signal_score': {'type': 'number', 'deprecated': True}, 'suspicion_score': {'anyOf': [{'type': 'integer', 'maximum': 100, 'minimum': 0}, {'type': 'null'}]}, 'suspicion_track': {'anyOf': [{'enum': ['whale', 'fresh_conviction', 'sliced_position'], 'type': 'string'}, {'type': 'null'}]}, 'market_volume_share': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'recorded_review_score': {'anyOf': [{'type': 'number'}, {'type': 'null'}]}, 'recorded_signal_score': {'anyOf': [{'type': 'number', 'deprecated': True}, {'type': 'null'}]}}}, 'DataQuality': {'type': 'object', 'required': ['status', 'field_groups'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'status': {'enum': ['fresh', 'partial', 'unknown', 'untracked', 'unavailable'], 'type': 'string'}, 'field_groups': {'type': 'array', 'items': {'$ref': '#/$defs/DataQualityGroup'}}}}, 'DataQualityGroup': {'type': 'object', 'required': ['group', 'owner', 'status'], 'properties': {'as_of': {'type': 'string', 'format': 'date-time'}, 'group': {'type': 'string'}, 'owner': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'enum': ['fresh', 'partial', 'unknown', 'untracked', 'unavailable'], 'type': 'string'}}}, 'LargeTradeHistoryMeta': {'type': 'object', 'required': ['request_id', 'cached', 'source', 'completeness'], 'properties': {'cached': {'type': 'boolean'}, 'source': {'type': 'object', 'required': ['kind', 'table', 'provider_fetch_at_request_time'], 'properties': {'kind': {'type': 'string', 'const': 'local_replay'}, 'table': {'type': 'string', 'const': 'whale_alerts'}, 'provider_fetch_at_request_time': {'type': 'boolean', 'const': False}}}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'completeness': {'type': 'object', 'required': ['status', 'reason'], 'properties': {'reason': {'type': 'string'}, 'status': {'type': 'string', 'const': 'best_effort'}}}}}}, 'anyOf': [{'type': 'object', 'required': ['data', 'has_more', 'next_cursor', 'data_quality', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/LargeTrade'}}, 'meta': {'$ref': '#/$defs/LargeTradeHistoryMeta'}, 'total': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'data_quality': {'$ref': '#/$defs/DataQuality'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
list_games
List covered games
The fixture list: one coherent game per row, so an agent never has to assemble a game from market searches and team-name matching. Each row carries both sides with their provider ids and live scores, the UTC kickoff, the provider's own status, the esports series format, and every linked Polymarket market with its condition_id and outcome token ids. Ordered by kickoff, then event_slug; games whose kickoff the provider has not published sort last. Args: - sport (string, optional): canonical bucket, case-insensitive, with - and _ read as a space (table-tennis and Table Tennis are one bucket). Omitted means every covered sport - league (string, optional): league tag as coverage.leagues spells it (nfl, epl, cs2), case-insensitive - status (string, optional): scheduled, live, paused, ended, postponed, cancelled, suspended, delayed, or unknown - starts_after / starts_before (string, optional): RFC 3339 kickoff bounds; a game with no published kickoff is excluded whenever either bound is set - limit (number, 1-100, default 20) - cursor (string, optional): opaque gms_v1_ cursor from next_cursor. It pins the page position, not a snapshot: the catalog is live, so a game added or removed between pages moves with it Returns: data, has_more, next_cursor, as_of, coverage and meta. Read coverage before reading an empty page: it names the sports and leagues this deployment serves and any scope whose source was unavailable for this read, so an unserved sport is never confused with a quiet night. A sport or status this deployment does not serve returns an empty page, not an error. status.state keeps postponed, cancelled, suspended and delayed distinct from a plain 'not live', and a kickoff in the past is never read as live on its own. Scores are the provider's own strings, because a set score and a run total are not both integers. Carries no price, no sharp-money split and no holder identity; those stay on get_market_snapshot, get_sharp_money_flows and get_pre_game_sides.
Read only Idempotent
Input schema 
{'type': 'object', 'properties': {'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Max results (1-100, default 20)'}, 'sport': {'type': 'string', 'description': 'Canonical sport bucket, case-insensitive, with - and _ read as a space; omitted means every covered sport. A bucket this deployment does not serve returns an empty page'}, 'cursor': {'type': 'string', 'description': 'Opaque gms_v1_ cursor from next_cursor; it pins the page position (kickoff and event_slug), not a snapshot'}, 'league': {'type': 'string', 'description': 'League tag as coverage.leagues spells it: nfl, epl, cs2. Case-insensitive'}, 'status': {'enum': ['scheduled', 'live', 'paused', 'ended', 'postponed', 'cancelled', 'suspended', 'delayed', 'unknown'], 'type': 'string', 'description': 'Keep only games in this state'}, 'starts_after': {'type': 'string', 'format': 'date-time', 'description': 'RFC 3339 instant; keep only games whose kickoff is at or after it'}, 'starts_before': {'type': 'string', 'format': 'date-time', 'description': 'RFC 3339 instant; keep only games whose kickoff is at or before it. Must be at or after starts_after'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'Game': {'type': 'object', 'required': ['object', 'event_slug', 'status', 'competitors', 'draw_offered', 'markets', 'freshness', 'coverage', 'url'], 'properties': {'url': {'type': 'string'}, 'sport': {'type': 'string'}, 'title': {'type': 'string'}, 'league': {'type': 'string'}, 'object': {'type': 'string', 'const': 'game'}, 'status': {'$ref': '#/$defs/GameStatus'}, 'game_id': {'type': 'string'}, 'markets': {'type': 'array', 'items': {'$ref': '#/$defs/GameMarket'}}, 'coverage': {'$ref': '#/$defs/GameCoverage'}, 'freshness': {'$ref': '#/$defs/GameFreshness'}, 'event_slug': {'type': 'string'}, 'competitors': {'type': 'array', 'items': {'$ref': '#/$defs/GameCompetitor'}}, 'draw_offered': {'type': 'boolean'}, 'scheduled_at': {'type': 'string', 'format': 'date-time'}, 'series_format': {'type': 'string'}}}, 'GameMarket': {'type': 'object', 'required': ['id', 'condition_id', 'platform'], 'properties': {'id': {'type': 'string'}, 'side': {'enum': ['home', 'away', 'draw', 'other'], 'type': 'string'}, 'slug': {'type': 'string'}, 'prices': {'$ref': '#/$defs/GameMarketPrices'}, 'platform': {'enum': ['polymarket'], 'type': 'string'}, 'outcome_no': {'type': 'string'}, 'outcome_yes': {'type': 'string'}, 'condition_id': {'type': 'string'}, 'outcome_token_ids': {'type': 'array', 'items': {'type': 'string'}}, 'sports_market_type': {'type': 'string'}}}, 'GameStatus': {'type': 'object', 'required': ['state', 'ended'], 'properties': {'live': {'type': 'boolean'}, 'clock': {'type': 'string'}, 'ended': {'type': 'boolean'}, 'state': {'enum': ['scheduled', 'live', 'paused', 'ended', 'postponed', 'cancelled', 'suspended', 'delayed', 'unknown'], 'type': 'string'}, 'period': {'type': 'string'}, 'match_status': {'enum': ['scheduled', 'in_progress', 'halftime', 'penalty_shootout', 'delayed', 'suspended', 'final', 'final_overtime', 'final_shootout', 'awarded', 'forfeit', 'not_necessary', 'postponed', 'cancelled', 'unknown'], 'type': 'string'}, 'provider_status': {'type': 'string'}}}, 'GameCoverage': {'type': 'object', 'required': ['scores', 'competitors', 'schedule'], 'properties': {'scores': {'enum': ['available', 'unavailable'], 'type': 'string'}, 'schedule': {'enum': ['available', 'unavailable'], 'type': 'string'}, 'competitors': {'enum': ['provider_ids', 'labels', 'unavailable'], 'type': 'string'}}}, 'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'GameFreshness': {'type': 'object', 'required': ['source', 'source_status', 'source_availability', 'source_freshness', 'delayed'], 'properties': {'source': {'enum': ['live', 'upcoming'], 'type': 'string'}, 'delayed': {'type': 'boolean'}, 'source_status': {'enum': ['ok', 'unavailable'], 'type': 'string'}, 'scores_source_at': {'type': 'string', 'format': 'date-time'}, 'source_freshness': {'enum': ['fresh', 'stale', 'unknown', 'not_applicable'], 'type': 'string'}, 'scores_observed_at': {'type': 'string', 'format': 'date-time'}, 'source_age_seconds': {'type': 'integer'}, 'source_observed_at': {'type': 'string', 'format': 'date-time'}, 'source_availability': {'enum': ['available', 'unavailable', 'not_applicable'], 'type': 'string'}}}, 'GamesCoverage': {'type': 'object', 'required': ['sports', 'leagues', 'sources_unavailable'], 'properties': {'sports': {'type': 'array', 'items': {'type': 'string'}}, 'leagues': {'type': 'array', 'items': {'type': 'string'}}, 'sources_unavailable': {'type': 'array', 'items': {'type': 'string'}}}}, 'GameCompetitor': {'type': 'object', 'required': ['name'], 'properties': {'logo': {'type': 'string'}, 'name': {'type': 'string'}, 'score': {'type': 'string'}, 'record': {'type': 'string'}, 'provider_id': {'type': 'string'}}}, 'GameMarketPrices': {'type': 'object', 'required': ['provider', 'observed_at', 'observation_source'], 'properties': {'provider': {'$ref': '#/$defs/GameMarketProviderPrices'}, 'observed_at': {'type': ['string', 'null'], 'format': 'date-time'}, 'observation_source': {'enum': ['board_snapshot', 'clob_display'], 'type': 'string'}}}, 'GameMarketPricePaired': {'type': 'object', 'required': ['state', 'competitor_a', 'competitor_b', 'competitor_a_is_yes', 'binding_provenance'], 'properties': {'state': {'type': 'string', 'const': 'paired'}, 'competitor_a': {'$ref': '#/$defs/GameMarketPriceCompetitor'}, 'competitor_b': {'$ref': '#/$defs/GameMarketPriceCompetitor'}, 'binding_provenance': {'$ref': '#/$defs/GameMarketPriceBindingProvenance'}, 'competitor_a_is_yes': {'type': 'boolean'}}}, 'GameMarketPriceInvalid': {'type': 'object', 'required': ['state', 'reason'], 'properties': {'state': {'type': 'string', 'const': 'invalid'}, 'reason': {'enum': ['team_cardinality', 'outcome_cardinality', 'price_cardinality', 'non_finite_price', 'out_of_range_price', 'non_complementary_prices', 'ambiguous_identity', 'final_identity_mismatch'], 'type': 'string'}, 'binding_provenance': {'$ref': '#/$defs/GameMarketPriceBindingProvenance'}, 'competitor_a_is_yes': {'type': 'boolean'}, 'competitor_a_provider_id': {'type': 'integer', 'format': 'int64'}, 'competitor_b_provider_id': {'type': 'integer', 'format': 'int64'}}}, 'GameMarketProviderPrices': {'oneOf': [{'$ref': '#/$defs/GameMarketPricePaired'}, {'$ref': '#/$defs/GameMarketPriceIncomplete'}, {'$ref': '#/$defs/GameMarketPriceInvalid'}], 'discriminator': {'mapping': {'paired': '#/components/schemas/GameMarketPricePaired', 'invalid': '#/components/schemas/GameMarketPriceInvalid', 'incomplete': '#/components/schemas/GameMarketPriceIncomplete'}, 'propertyName': 'state'}}, 'GameMarketPriceCompetitor': {'type': 'object', 'required': ['label', 'price', 'price_provenance'], 'properties': {'label': {'type': 'string'}, 'price': {'type': 'number', 'maximum': 1, 'minimum': 0}, 'provider_id': {'type': 'integer', 'format': 'int64'}, 'price_provenance': {'enum': ['gamma_outcome_prices', 'clob_display'], 'type': 'string'}}}, 'GameMarketPriceIncomplete': {'type': 'object', 'required': ['state', 'reason'], 'properties': {'state': {'type': 'string', 'const': 'incomplete'}, 'reason': {'enum': ['outcome_prices_missing', 'outcome_price_leg_missing', 'zero_price_sentinel', 'display_price_pair_unavailable', 'outcome_identity_unavailable', 'final_score_unavailable'], 'type': 'string'}, 'binding_provenance': {'$ref': '#/$defs/GameMarketPriceBindingProvenance'}, 'competitor_a_is_yes': {'type': 'boolean'}, 'competitor_a_provider_id': {'type': 'integer', 'format': 'int64'}, 'competitor_b_provider_id': {'type': 'integer', 'format': 'int64'}}}, 'GameMarketPriceBindingProvenance': {'enum': ['provider_ids', 'exact_labels', 'containment_labels', 'elimination'], 'type': 'string'}}, 'anyOf': [{'type': 'object', 'required': ['data', 'has_more', 'next_cursor', 'as_of', 'coverage', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/Game'}}, 'meta': {'$ref': '#/$defs/ResponseMeta'}, 'as_of': {'type': 'string', 'format': 'date-time'}, 'coverage': {'$ref': '#/$defs/GamesCoverage'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
list_webhooks
List Webhook Endpoints
Read-only list of webhook endpoints owned by the authenticated API key user. This does not create, update, verify, rotate, or delete webhook endpoints. Args: none Returns: List of webhook endpoint configuration records.
Read only Idempotent
Input schema 
{'type': 'object', 'properties': {}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'WebhookStatus': {'enum': ['pending_verification', 'active', 'disabled'], 'type': 'string'}, 'WebhookEndpoint': {'type': 'object', 'required': ['id', 'object', 'name', 'url', 'event_types', 'trade_filters', 'status', 'verified_at', 'verification_token_expires_at', 'failure_count', 'created_at', 'updated_at', 'retry_policy', 'secret_rotation'], 'properties': {'id': {'type': 'integer', 'format': 'int64'}, 'url': {'type': 'string', 'format': 'uri'}, 'name': {'type': 'string'}, 'object': {'type': 'string', 'const': 'webhook'}, 'status': {'$ref': '#/$defs/WebhookStatus'}, 'created_at': {'type': 'string', 'format': 'date-time'}, 'updated_at': {'type': 'string', 'format': 'date-time'}, 'event_types': {'type': 'array', 'items': {'$ref': '#/$defs/WebhookEventType'}}, 'verified_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}, 'retry_policy': {'$ref': '#/$defs/WebhookRetryPolicy'}, 'verification': {'$ref': '#/$defs/WebhookVerification'}, 'failure_count': {'type': 'integer'}, 'trade_filters': {'$ref': '#/$defs/LargeTradeSubscriptionFilters'}, 'signing_secret': {'type': 'string'}, 'secret_rotation': {'$ref': '#/$defs/WebhookSecretRotation'}, 'verification_token_expires_at': {'type': 'string', 'format': 'date-time'}}}, 'WebhookEventType': {'enum': ['large_trade_inserted_v2', 'large_trades_inserted', 'whale_trades_inserted', 'live_sports_updated', 'trader_synced', 'whale_trader_synced', 'large_positions_updated', 'wallet_grade_changed', 'suspicious_trade_flagged', 'insider_radar_flag_raised', 'sharp_money_flow_detected', 'smart_money_flow_detected', 'export_job_ready', 'export_job_failed', 'export_job_expired', 'export_job_cancelled'], 'type': 'string'}, 'WebhookRetryPolicy': {'type': 'object', 'required': ['max_attempts', 'terminal_status', 'retry_horizon_seconds', 'disable_after_consecutive_failures'], 'properties': {'max_attempts': {'type': 'integer', 'const': 8}, 'terminal_status': {'type': 'string', 'const': 'dead_letter'}, 'retry_horizon_seconds': {'type': 'integer', 'const': 7380}, 'disable_after_consecutive_failures': {'type': 'integer', 'const': 8}}}, 'WebhookVerification': {'type': 'object', 'required': ['token', 'expires_at'], 'properties': {'token': {'type': 'string'}, 'expires_at': {'type': 'string', 'format': 'date-time'}}}, 'WebhookSecretRotation': {'type': 'object', 'required': ['status', 'overlap_expires_at'], 'properties': {'status': {'enum': ['idle', 'pending', 'overlap'], 'type': 'string'}, 'overlap_expires_at': {'anyOf': [{'type': 'string', 'format': 'date-time'}, {'type': 'null'}]}}}, 'LargeTradeSubscriptionFilters': {'type': 'object', 'properties': {'wallet': {'type': 'string', 'pattern': '^0x[a-fA-F0-9]{40}$'}, 'min_grade': {'enum': ['S', 'A', 'B', 'C', 'D', 'F'], 'type': 'string'}, 'condition_id': {'type': 'string'}, 'min_size_usd': {'type': 'string', 'pattern': '^[0-9]+(\\.[0-9]{1,6})?$'}}, 'additionalProperties': False}}, 'anyOf': [{'type': 'object', 'required': ['data', 'has_more', 'next_cursor', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/WebhookEndpoint'}}, 'meta': {'$ref': '#/$defs/ResponseMeta'}, 'total': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
search_content
Search Editorial Content
Search 0xinsider's editorial content by keyword. Returns matching learn articles, glossary entries, comparisons, research, and trading strategies with their canonical URLs. Args: - q (string, required): Search query, 1-256 characters before whitespace trimming - limit (number, 1-50, default 10): Max results Returns: List of matching content items with content_id, kind, slug, title, excerpt, and url.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'maxLength': 256, 'minLength': 1, 'description': 'Search query (1-256 characters before whitespace trimming, non-empty after trimming)'}, 'limit': {'type': 'integer', 'default': 10, 'maximum': 50, 'minimum': 1, 'description': 'Max results (1-50, default 10)'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'ContentSearchResult': {'type': 'object', 'required': ['content_id', 'kind', 'slug', 'title', 'excerpt', 'url'], 'properties': {'url': {'type': 'string'}, 'kind': {'enum': ['learn', 'glossary', 'comparison', 'research', 'strategy'], 'type': 'string'}, 'slug': {'type': 'string'}, 'title': {'type': 'string'}, 'excerpt': {'type': 'string'}, 'content_id': {'type': 'string'}}}}, 'anyOf': [{'type': 'object', 'required': ['data', 'has_more', 'next_cursor', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/ContentSearchResult'}}, 'meta': {'$ref': '#/$defs/ResponseMeta'}, 'total': {'type': 'integer'}, 'has_more': {'type': 'boolean', 'const': False}, 'next_cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
search_markets
Search Markets
Search prediction markets by keyword. Returns matching markets with status, category, and platform. Use this to find condition_id values needed by get_market_flow. Supports cursor pagination: pass next_cursor from the previous page with the same q, status and category to read the next page; stop when has_more is false. Args: - q (string, required): Search query - limit (number, 1-100, default 20): Max results per page - cursor (string, optional): Pagination cursor from the previous response's next_cursor - status (string, optional): Filter by status: "active", "closed", or "all" (default "all") - category (string, optional): Filter by category Returns: data (matching markets with id, condition_id, title, slug, category, platform, status), has_more, next_cursor.
Read only Idempotent
Input schema 
{'type': 'object', 'required': ['q'], 'properties': {'q': {'type': 'string', 'maxLength': 512, 'minLength': 1, 'description': 'Search query (1-512 characters before whitespace trimming, non-empty after trimming)'}, 'limit': {'type': 'integer', 'default': 20, 'maximum': 100, 'minimum': 1, 'description': 'Max results per page (1-100, default 20)'}, 'cursor': {'type': 'string', 'description': "Pagination cursor from the previous response's next_cursor; send it with the same q, status and category"}, 'status': {'enum': ['active', 'closed', 'all'], 'type': 'string', 'default': 'all', 'description': 'Filter by market status'}, 'category': {'type': 'string', 'description': 'Filter by category'}}, 'additionalProperties': False}
Output schema 
{'type': 'object', '$defs': {'ResponseMeta': {'type': 'object', 'required': ['request_id', 'cached', 'cost'], 'properties': {'cost': {'type': 'integer'}, 'cached': {'type': 'boolean'}, 'request_id': {'type': 'string'}, 'cache_age_s': {'type': 'integer'}, 'ranking_as_of': {'type': 'string', 'format': 'date-time'}, 'ranking_source': {'enum': ['live', 'db_only'], 'type': 'string'}, 'directional_source': {'enum': ['live', 'degraded'], 'type': 'string'}, 'ranking_generation': {'type': 'integer'}, 'category_skill_scope': {'type': 'string', 'const': 'observed_goldsky_primary_taker_fill'}, 'category_skill_source': {'enum': ['live', 'partial', 'degraded', 'unavailable'], 'type': 'string'}, 'category_skill_platform': {'type': 'string', 'const': 'polymarket'}, 'category_skill_model_version': {'type': 'string'}, 'category_skill_status_counts': {'type': 'object', 'required': ['live', 'insufficient', 'stale', 'unknown', 'degraded'], 'properties': {'live': {'type': 'integer', 'minimum': 0}, 'stale': {'type': 'integer', 'minimum': 0}, 'unknown': {'type': 'integer', 'minimum': 0}, 'degraded': {'type': 'integer', 'minimum': 0}, 'insufficient': {'type': 'integer', 'minimum': 0}}}, 'category_skill_source_coverage': {'enum': ['partial_whale_threshold_fills', 'graded_wallet_fills'], 'type': 'string'}, 'category_skill_taxonomy_version': {'type': 'string'}, 'category_skill_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_observation_started_at': {'type': 'string', 'format': 'date-time'}, 'category_skill_enriched_base_payload_hash': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'category_skill_model_operationally_degraded': {'type': 'boolean'}}}, 'MarketSearchResult': {'type': 'object', 'required': ['id', 'condition_id', 'title', 'slug', 'category', 'platform', 'status'], 'properties': {'id': {'type': 'string'}, 'slug': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'title': {'type': 'string'}, 'status': {'enum': ['active', 'closed'], 'type': 'string'}, 'category': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}, 'platform': {'anyOf': [{'enum': ['polymarket'], 'type': 'string'}, {'type': 'null'}]}, 'condition_id': {'type': 'string'}}}}, 'anyOf': [{'type': 'object', 'required': ['data', 'has_more', 'next_cursor', 'meta'], 'properties': {'data': {'type': 'array', 'items': {'$ref': '#/$defs/MarketSearchResult'}}, 'meta': {'$ref': '#/$defs/ResponseMeta'}, 'total': {'type': 'integer'}, 'has_more': {'type': 'boolean'}, 'next_cursor': {'anyOf': [{'type': 'string'}, {'type': 'null'}]}}, 'additionalProperties': False}, {'type': 'object', 'required': ['error'], 'properties': {'error': {'type': 'object', 'required': ['code'], 'properties': {'code': {'type': 'string'}, 'param': {'type': 'string'}, 'reason': {'type': 'string'}, 'status': {'type': 'integer', 'minimum': 0}, 'doc_url': {'type': 'string'}, 'retry_at': {'type': 'string'}, 'request_id': {'type': 'string'}, 'retry_after_seconds': {'type': 'integer', 'minimum': 0}}, 'additionalProperties': False}}, 'additionalProperties': False}]}
History

Recent tool changes

Changed
get_pick_of_the_day_archive
Oct. 2, 2026, 2:41 a.m.
Added
get_pick_of_the_day_ledger_entry
Oct. 2, 2026, 2:41 a.m.
Changed
get_pick_of_the_day
Oct. 2, 2026, 2:41 a.m.
Changed
get_trader_pnl
Oct. 2, 2026, 2:41 a.m.
Changed
get_trending_wallets
Oct. 2, 2026, 2:41 a.m.
Changed
get_large_positions
Oct. 2, 2026, 2:41 a.m.
Changed
get_platforms
Oct. 2, 2026, 2:41 a.m.
Changed
get_coverage
Oct. 2, 2026, 2:41 a.m.
Changed
get_trader_export_snapshot
Oct. 2, 2026, 2:41 a.m.
Changed
get_report
Oct. 2, 2026, 2:41 a.m.
Changed
get_monthly_report_snapshot
Oct. 2, 2026, 2:41 a.m.
Changed
get_weekly_report_snapshot
Oct. 2, 2026, 2:41 a.m.
Changed
get_daily_report_snapshot
Oct. 2, 2026, 2:41 a.m.
Changed
get_webhook
Oct. 2, 2026, 2:41 a.m.
Changed
list_webhooks
Oct. 2, 2026, 2:41 a.m.
Changed
get_event_replay_since
Oct. 2, 2026, 2:41 a.m.
Changed
explore_markets
Oct. 2, 2026, 2:41 a.m.
Changed
search_content
Oct. 2, 2026, 2:41 a.m.
Changed
search_markets
Oct. 2, 2026, 2:41 a.m.
Changed
get_position_timeline_by_id
Oct. 2, 2026, 2:41 a.m.
Changed
get_position_timeline
Oct. 2, 2026, 2:41 a.m.
Changed
get_positions
Oct. 2, 2026, 2:41 a.m.
Changed
get_insider_radar_flag
Oct. 2, 2026, 2:41 a.m.
Changed
get_insider_radar
Oct. 2, 2026, 2:41 a.m.
Changed
get_suspicious_trade
Oct. 2, 2026, 2:41 a.m.
Changed
get_suspicious_trades
Oct. 2, 2026, 2:41 a.m.
Changed
get_market_snapshot
Oct. 2, 2026, 2:41 a.m.
Changed
get_smart_money_flows
Oct. 2, 2026, 2:41 a.m.
Changed
get_sharp_money_flows
Oct. 2, 2026, 2:41 a.m.
Changed
batch_get_market_intel
Oct. 2, 2026, 2:41 a.m.
Discover

Similar MCP servers

AlpineDataWorks Intelligence Server

com.alpinedataworks/adw-intelligence-server

Provides economic, market, supply-chain, real-estate, energy, consumer, labor, and other scored intelligence indices with histori…

Stratalize Finance

com.stratalize/finance

Provides financial, macroeconomic, banking, credit, commodities, M&A, ESG, labor, and regulatory benchmarks for analysis and plan…

Valuein — SEC EDGAR Fundamentals & Smart-Money Data

io.github.valuein/mcp-sec-edgar

Provides point-in-time SEC EDGAR fundamentals, filings, ownership signals, financial analysis, valuation models, research reports…

equibles

io.github.daniel3303/equibles

Provides equity and market research tools covering SEC filings, company financials, portfolios, prices, options, macroeconomic da…

DFX Real Estate Intelligence

io.github.Capital-W-Holdings/us-property-parcel-real-estate-debt

Provides US commercial real estate, parcel, debt maturity, bank CRE exposure, private capital, investor, ownership, occupancy, an…

simplefunctions

io.github.spfunctions/simplefunctions

Provides prediction-market data, thesis analysis, market signals, portfolio tracking, and automated intent-based trading workflow…

EventTrader MCP

com.cymetica/event-trader-mcp

Provides prediction-market research and trading capabilities, including real-time event-market data, CLOB execution paths, fund i…

Signal8

ai.signal8/mcp

Provides SEC filings, dilution data, insider and institutional ownership, and political-trade data.