io.github.0xinsider/mcp

Est-ce que io.github.0xinsider/mcp est sûr ?

Au dernier audit MCP Hub, le serveur MCP « io.github.0xinsider/mcp » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 55 outils

• batch_get_market_flow≈ 1852 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • timeframe · string · optionnel · 1h | 4h | 24h | 7d
    Shared lookback window
  • condition_ids · array · requis
    Raw provider condition_id values

  Exemple d'appel

  {"name": "batch_get_market_flow", "arguments": {"condition_ids": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• batch_get_market_intel≈ 1899 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • timeframe · string · optionnel · 1h | 4h | 24h | 7d
    Shared lookback window
  • condition_ids · array · requis
    Raw provider condition_id values

  Exemple d'appel

  {"name": "batch_get_market_intel", "arguments": {"condition_ids": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• batch_get_traders≈ 3630 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • expand · array · optionnel
    Shared heavy fields to include for every trader item; trust adds per-field provenance for grade, P&L, and stats
  • traders · array · requis
    Wallet addresses or known usernames

  Exemple d'appel

  {"name": "batch_get_traders", "arguments": {"traders": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• explore_markets≈ 2949 tokens

  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.

  Paramètres, retour & exemple (7)

  Paramètres

  • q · string · optionnel
    Keyword search against market titles, up to 64 characters before whitespace trimming
  • sort · string · optionnel · trending | hot | expiring | large_trades | whales | volume | newest
    Discovery sort order. large_trades ranks by large-trade activity; whales is its deprecated spelling and selects the same order.
  • limit · integer · optionnel
    Max discovery entries (1-48, default 24)
  • cursor · string · optionnel
    Pagination cursor from previous response
  • status · string · optionnel · active | closed | all
    Filter by market status
  • category · string · optionnel
    Filter by provider-native market category
  • platform · string · optionnel · polymarket
    Explore is Polymarket-only; accepted for backward-compatibility and does not change the result set

  Exemple d'appel

  {"name": "explore_markets", "arguments": {"q": "texte", "sort": "trending", "limit": 1, "cursor": "texte", "status": "active", "category": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_combo≈ 2654 tokens

  One Polymarket combo: legs, conjunction result, all-time trade totals, the newest 100 taker fills, lifecycle totals and ingest coverage. Requires a Pro or Max API key. Unlike get_combo_fills it keeps executions priced above 0.95. Null lifecycle or missing leg facts are unknown, never zero. Args: - condition_id (string, required): Combo ID, 0x and 62 lowercase hex characters; not a binary market's condition_id Returns: combo, fills, lifecycle, coverage, access and meta. A malformed ID is a bad_request error and an unknown one not_found.

  Paramètres, retour & exemple (1)

  Paramètres

  • condition_id · string · requis
    Combo ID: 0x and 62 lowercase hex characters, not a binary market's condition_id

  Exemple d'appel

  {"name": "get_combo", "arguments": {"condition_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_combo_fills≈ 2704 tokens

  Live Polymarket combo (multi-leg) taker fills with exact decimal-string economics, wallet identity and grade, legs, conjunction result and ingest coverage. Requires a Pro or Max API key. The listing holds executions priced at most 0.95; get_combo has a combo's complete history. sort recent pages with next_cursor; largest and payout page with next_offset. A continuation can end on an empty page. Args: - result (string, optional): CSV of pending, won, lost; all clears the filter - legs (string, optional): CSV of 2, 3, 4, 5+; all clears the filter - min_stake (integer, optional, default 0): Minimum collateral in whole USDC - min_multiplier (integer, optional, default 0): 0 disables the filter; otherwise 2 to 1000000 shares per dollar at execution - grades (string, optional): CSV of S, A, B, C, D, F; all clears the filter; ungraded wallets never match - sports (string, optional): CSV of sport slugs such as nfl, nba, soccer, esports; all clears the filter; a combo matches when any leg is in a selected sport - sort (string, optional): recent (default, newest first), largest (collateral), or payout (buy-fill shares, sells excluded) - window (string, optional): 24h, 7d or all; defaults to all for recent and 24h for largest and payout - limit (number, 1-200, default 50): Fills per page - cursor (string, optional): next_cursor from the previous recent page - offset (number, 0-5000, optional): next_offset from the previous largest or payout page Returns: data (fills), has_more, next_cursor, next_offset, limit, sort, window, coverage and meta.

  Paramètres, retour & exemple (11)

  Paramètres

  • legs · string · optionnel
    CSV of 2, 3, 4, 5+; all clears the filter. A combo matches any named pick count
  • sort · string · optionnel · recent | largest | payout
    recent (the default) is newest first; largest ranks collateral; payout ranks buy-fill shares and excludes sells
  • limit · integer · optionnel
    Max fills per page (1-200, default 50)
  • cursor · string · optionnel
    next_cursor from the previous page; recent ordering only
  • grades · string · optionnel
    CSV of S, A, B, C, D, F; all clears the filter. Ungraded wallets never match
  • offset · integer · optionnel
    next_offset from the previous page; largest and payout ordering only
  • result · string · optionnel
    CSV of pending, won, lost; all clears the filter
  • sports · string · optionnel
    CSV of sport slugs such as nfl, nba, soccer, esports; all clears the filter. A combo matches when any leg is in a selected sport
  • window · string · optionnel · 24h | 7d | all
    Defaults to all for recent and 24h for largest and payout
  • min_stake · integer · optionnel
    Minimum collateral in whole USDC (default 0)
  • min_multiplier · integer · optionnel
    Minimum shares per dollar at execution: 0 (the default) disables the filter, otherwise 2 to 1000000

  Exemple d'appel

  {"name": "get_combo_fills", "arguments": {"legs": "texte", "sort": "recent", "limit": 1, "cursor": "texte", "grades": "texte", "offset": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_combos_summary≈ 830 tokens

  The stored count of traded Polymarket combos whose YES conjunction is still pending, and when it was computed. Requires a Pro or Max API key. The count refreshes at most every five minutes and is cached for 60 seconds. A null live value is unknown, never zero. Returns: live (count and computed_at, or null) and meta.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_combos_summary", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_coverage≈ 1041 tokens

  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.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_coverage", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_daily_report_snapshot≈ 2102 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • date · string · requis
    UTC report date in YYYY-MM-DD format

  Exemple d'appel

  {"name": "get_daily_report_snapshot", "arguments": {"date": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_edge_hunter≈ 7848 tokens

  Read the Max-only Edge Hunter API at https://0xinsider.com/sports/edge. Pro receives 403 forbidden with reason max_plan_required. One view selector offers board (default), full signals and cohort observations. All views accept kind sports|esports (omission covers both), sports, leagues, market_types, condition_ids, event_slugs, series_slugs and legacy category. Array selections accept 1..100 supplied values before deduplication, including comma-separated values inside a value; repeat REST query keys or supply MCP arrays. Lists match OR; axes match AND. Canonical sports and machine league identities normalize case-insensitively; market types and event/series slugs are exact case-sensitive provider strings. category=NFL selects the Football bucket; leagues=[nfl] selects NFL. Selection precedes the cap or pagination and appears as normalized selection beside the result fields; changed selections cannot share cursors or ETags. Every row carries nullable market_context with nullable league, series_slug, market_type and metadata_updated_at for authoritative filter discovery; metadata_updated_at is the local canonical writer clock, not provider observation time. Selected reads fail closed with 503 read_model_warming if frozen sidecar readiness is absent. Board defaults stay B grade floor, 30 rows and 48-hour horizon; min_grade S/A/B and limit clamp 1..30 are configurable, total is before the cap, with both current outcome quotes. Signals use min_grade default B, horizon default 12/clamp 1..48, limit default 20/clamp 1..100 and cursor, retaining token_id, all ranked/holder/directional/category-skill fields and clocks. Grade floor requires a holder at that grade or better without removing other holders. Observations require cohort wider_holder|in_play|emerging_pile, accept limit/cursor, and retain full observation rows, snapshot_as_of, degraded, source-generation/category funnel diagnostics and REST meta. Required degradation_reasons names each cause with its canonical sport or null for a generation-wide cause. Degradation and coverage input_markets/capacity_limited_markets/emitted_observations/incomplete_holder_markets describe the whole all-sports generation and remain unchanged by selectors. coverage.selected_observations counts matching selected cohort rows before pagination; returned_observations counts this page. Intentional capacity_limited admission does not itself degrade a snapshot, and pagination cannot recover excluded markets. not_configured upcoming supply is not a provider failure. A selected funnel with no failure terminals does not prove the shared generation healthy. A legacy category value that cannot resolve to a sport retains its zero-work empty result: all six counts are zero and reasons are empty without reading the all-sports snapshot, so those values do not establish its health. Observation horizon stays 48h with 12h in-play kickoff lookback and 30s live snapshot ceiling; after one missed refresh, observations serve the last snapshot up to 45s longer with its age in meta.cache_age_s, and a second miss in a row returns 503; funnel accounting is not a league/type/ID selection census. All public views read warmed generations only; missing or stale readiness returns 503 read_model_warming with Retry-After 5. Advanced views use private,no-cache with REST/SDK ETag/304 helpers; board uses private,no-store and has no ETag/pagination. Invalid mode-specific parameters return 400. Price marks are market midpoints, not wallet entry prices; volume is shares. Null/db_only/degraded identify unavailable or weaker evidence. Analytics is not an order instruction.

  Paramètres, retour & exemple (14)

  Paramètres

  • kind · string · optionnel · sports | esports
    All views: sports excludes the Esports bucket; esports selects only Esports. Omit for both. Combines with other selections using AND. Selected reads echo normalized selection and require frozen metadata readiness.
  • view · string · optionnel · board | signals | observations
    Response mode; defaults to board
  • limit · integer · optionnel
    Board cap default 30/clamp 1..30; advanced page default 20/clamp 1..100
  • cohort · string · optionnel · wider_holder | in_play | emerging_pile
    Required for observations; rejected for board/signals
  • cursor · string · optionnel
    Advanced next_cursor, bound to view, all normalized selections and snapshot
  • sports · array · optionnel
    Canonical sport buckets, including Esports and Table Tennis, matched case-insensitively. Unknown names and league aliases such as NFL are rejected in sports; use category for legacy bucket aliases or leagues for exact league selection. Omission covers every sport admitted by the selected view. All views. Repeat this query key or put comma-separated values inside a value. Values normalize, sort and deduplicate; at most 100 supplied values before deduplication. Values within this axis match OR; different selected axes match AND. An empty selection is invalid. Filtering precedes the board cap or advanced pagination and is bound to advanced cursors and ETags.
  • leagues · array · optionnel
    Normalized machine/provider league identities, such as nfl, cfb, nba, epl, cs2, lol, dota2 or valorant. Known wire/tag aliases normalize; other provider keys match exact lowercase identity. This is separate from category: category=NFL selects Football, while leagues=nfl selects NFL only. Read market_context.league for authoritative values. All views. Repeat this query key or put comma-separated values inside a value. Values normalize, sort and deduplicate; at most 100 supplied values before deduplication. Values within this axis match OR; different selected axes match AND. An empty selection is invalid. Filtering precedes the board cap or advanced pagination and is bound to advanced cursors and ETags.
  • category · string · optionnel
    All views; legacy canonical bucket alias. NFL selects Football; use leagues=[nfl] for NFL only.
  • min_grade · string · optionnel · S | A | B
    Board/signals only; holder at this grade or better, default B
  • event_slugs · array · optionnel
    Exact provider event slugs. Use event_slug returned on the row; no title or slug-prefix guessing. All views. Repeat this query key or put comma-separated values inside a value. Values normalize, sort and deduplicate; at most 100 supplied values before deduplication. Values within this axis match OR; different selected axes match AND. An empty selection is invalid. Filtering precedes the board cap or advanced pagination and is bound to advanced cursors and ETags.
  • market_types · array · optionnel
    Exact provider sports_market_type values. This is an open provider taxonomy, distinct from exact market IDs. Read market_context.market_type; missing selected metadata excludes the row. All views. Repeat this query key or put comma-separated values inside a value. Values normalize, sort and deduplicate; at most 100 supplied values before deduplication. Values within this axis match OR; different selected axes match AND. An empty selection is invalid. Filtering precedes the board cap or advanced pagination and is bound to advanced cursors and ETags.
  • series_slugs · array · optionnel
    Exact provider series slugs. Read market_context.series_slug; a missing selected series excludes the row. All views. Repeat this query key or put comma-separated values inside a value. Values normalize, sort and deduplicate; at most 100 supplied values before deduplication. Values within this axis match OR; different selected axes match AND. An empty selection is invalid. Filtering precedes the board cap or advanced pagination and is bound to advanced cursors and ETags.
  • condition_ids · array · optionnel
    Exact market selections. Raw provider condition IDs and the existing mkt_-prefixed aliases normalize to raw IDs. Unknown well-formed IDs return an empty result. All views. Repeat this query key or put comma-separated values inside a value. Values normalize, sort and deduplicate; at most 100 supplied values before deduplication. Values within this axis match OR; different selected axes match AND. An empty selection is invalid. Filtering precedes the board cap or advanced pagination and is bound to advanced cursors and ETags.
  • horizon_hours · integer · optionnel
    Board default 48/signals default 12, clamp 1..48; rejected for observations

  Exemple d'appel

  {"name": "get_edge_hunter", "arguments": {"kind": "sports", "view": "board", "limit": 1, "cohort": "wider_holder", "cursor": "texte", "sports": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_event_replay_since≈ 1986 tokens

  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.

  Paramètres, retour & exemple (7)

  Paramètres

  • limit · integer · optionnel
    Max events (1-100, default 50)
  • cursor · string · optionnel
    Opaque event replay cursor; bound to the filters the walk ran with
  • expand · string · optionnel · trade
    trade: add the public trade read to every event, so no per-event detail call is needed
  • trader · string · optionnel
    Only this wallet's trades: address, trd_ id or username (bound to the cursor)
  • min_size · number · optionnel
    Only trades of at least this size in USD (bound to the cursor)
  • min_grade · string · optionnel · S | A | B | C | D | F
    Only wallets at this grade or better (bound to the cursor)
  • condition_id · string · optionnel
    Only this market's trades: raw condition_id or mkt_ id (bound to the cursor)

  Exemple d'appel

  {"name": "get_event_replay_since", "arguments": {"limit": 1, "cursor": "texte", "expand": "trade", "trader": "texte", "min_size": 1, "min_grade": "S"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_game≈ 2514 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • event_slug · string · requis
    The game's event slug, for example nfl-buf-nyj-2026-09-22; matched case-insensitively

  Exemple d'appel

  {"name": "get_game", "arguments": {"event_slug": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_insider_radar≈ 1478 tokens

  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.

  Paramètres, retour & exemple (5)

  Paramètres

  • mode · string · optionnel · live | stable
    live uses the fresh response cache; stable pins pagination to one published scoring generation
  • limit · integer · optionnel
    Max results (1-100, default 20)
  • cursor · string · optionnel
    Pagination cursor from previous response
  • severity · string · optionnel · flag | watch
    "flag" selects live rows; "watch" returns none because no live watch policy exists
  • min_suspicion · number · optionnel
    Minimum suspicion score (0-100); the live floor of 60 also applies

  Exemple d'appel

  {"name": "get_insider_radar", "arguments": {"mode": "live", "limit": 1, "cursor": "texte", "severity": "flag", "min_suspicion": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_insider_radar_flag≈ 1083 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • id · string · requis
    Suspicious trade ID such as rf_123 or 123

  Exemple d'appel

  {"name": "get_insider_radar_flag", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_large_positions≈ 1628 tokens

  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.

  Paramètres, retour & exemple (6)

  Paramètres

  • limit · integer · optionnel
    Max results (1-100, default 20)
  • cursor · string · optionnel
    Opaque pagination cursor from previous response
  • category · string · optionnel
    Filter by provider-backed market category
  • min_size · number · optionnel
    Minimum position value in USD
  • min_grade · string · optionnel · S | A | B | C | D | F
    Minimum trader grade
  • condition_id · string · optionnel
    Scope to one market (raw provider condition_id or mkt_-prefixed). Polymarket-only; an unknown id returns an empty list.

  Exemple d'appel

  {"name": "get_large_positions", "arguments": {"limit": 1, "cursor": "texte", "category": "texte", "min_size": 1, "min_grade": "S", "condition_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_large_trade≈ 1976 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • id · string · requis
    Large trade ID such as wt_123 or 123

  Exemple d'appel

  {"name": "get_large_trade", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_large_trade_counterparty_executions≈ 1605 tokens

  Page the counterparty executions of one large trade past the first page get_large_trade embeds in counterparty_analysis. Reads the immutable snapshot that response names; a stale or changed snapshot fails with reason cursor_expired, so read get_large_trade again and restart. Args: - id (string, required): Large trade ID such as wt_123 or 123 - snapshot_id (string, required): counterparty_analysis.snapshot_id from get_large_trade - cursor (string, optional): executions_next_cursor from get_large_trade or from the previous page - limit (number, 1-100, default 100): Executions per page Returns: executions (each with its first makers page and makers_next_cursor), executions_next_cursor, execution counts, status and meta.

  Paramètres, retour & exemple (4)

  Paramètres

  • id · string · requis
    Large trade ID such as wt_123 or 123
  • limit · integer · optionnel
    Max executions per page (1-100, default 100)
  • cursor · string · optionnel
    executions_next_cursor from get_large_trade or from the previous page
  • snapshot_id · string · requis
    counterparty_analysis.snapshot_id from get_large_trade

  Exemple d'appel

  {"name": "get_large_trade_counterparty_executions", "arguments": {"id": "texte", "snapshot_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_large_trade_counterparty_makers≈ 1398 tokens

  Page the maker wallets of one counterparty execution past the first page its execution embeds. Percentages keep the whole execution as their denominator across pages. Args: - id (string, required): Large trade ID such as wt_123 or 123 - execution_id (string, required): execution_id of the execution - snapshot_id (string, required): counterparty_analysis.snapshot_id from get_large_trade - cursor (string, optional): makers_next_cursor from the execution or next_cursor from the previous page - limit (number, 1-100, default 100): Makers per page Returns: items (makers), next_cursor, execution_id, snapshot_id and meta.

  Paramètres, retour & exemple (5)

  Paramètres

  • id · string · requis
    Large trade ID such as wt_123 or 123
  • limit · integer · optionnel
    Max makers per page (1-100, default 100)
  • cursor · string · optionnel
    makers_next_cursor from the execution, or next_cursor from the previous page
  • snapshot_id · string · requis
    counterparty_analysis.snapshot_id from get_large_trade
  • execution_id · string · requis
    execution_id of one counterparty execution

  Exemple d'appel

  {"name": "get_large_trade_counterparty_makers", "arguments": {"id": "texte", "snapshot_id": "texte", "execution_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_large_trades≈ 2301 tokens

  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.

  Paramètres, retour & exemple (9)

  Paramètres

  • sort · string · optionnel · recent | market_volume_share
    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 · integer · optionnel
    Max results (1-100, default 20)
  • since · string · optionnel
    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 · string · optionnel
    Pagination cursor from previous response
  • category · string · optionnel
    Filter by market category (case-insensitive)
  • min_size · number · optionnel
    Minimum trade size in USD (default 5000)
  • min_grade · string · optionnel · S | A | B | C | D | F
    Minimum trader grade
  • suspicious_only · boolean · optionnel
    Keep only rows with persisted suspicion_score >= 60
  • min_market_volume_share · number · optionnel
    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

  Exemple d'appel

  {"name": "get_large_trades", "arguments": {"sort": "recent", "limit": 1, "since": "texte", "cursor": "texte", "category": "texte", "min_size": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_large_trades_history≈ 2076 tokens

  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.

  Paramètres, retour & exemple (13)

  Paramètres

  • to · string · optionnel
    Exclusive traded_at upper bound
  • from · string · optionnel
    Inclusive traded_at lower bound
  • sort · string · optionnel · recent | market_volume_share
    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 · integer · optionnel
    Max results (1-100, default 20)
  • cursor · string · optionnel
    Pagination cursor from previous response
  • trader · string · optionnel
    Trader wallet, alias, or username
  • category · string · optionnel
    Filter by market category
  • min_size · number · optionnel
    Minimum trade size in USD
  • platform · string · optionnel · polymarket | all
    Filter by provider platform
  • min_grade · string · optionnel · S | A | B | C | D | F
    Minimum trader grade
  • condition_id · string · optionnel
    Exact raw provider condition_id
  • suspicious_only · boolean · optionnel
    Keep only rows with persisted suspicion_score >= 60
  • min_market_volume_share · number · optionnel
    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

  Exemple d'appel

  {"name": "get_large_trades_history", "arguments": {"to": "texte", "from": "texte", "sort": "recent", "limit": 1, "cursor": "texte", "trader": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_leaderboard≈ 1332 tokens

  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.

  Paramètres, retour & exemple (4)

  Paramètres

  • limit · integer · optionnel
    Max results (1-100, default 20)
  • cursor · string · optionnel
    Pagination cursor from previous response
  • category · string · optionnel
    Filter by category slug
  • strategy · string · optionnel · accumulator | algo_trader | arbitrageur | category_focused | directional | diversified | event_driven | high_activity
    Filter by strategy type

  Exemple d'appel

  {"name": "get_leaderboard", "arguments": {"limit": 1, "cursor": "texte", "category": "texte", "strategy": "accumulator"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_market_candles≈ 1182 tokens

  OHLC price candles for a market's outcome tokens from the stored Polymarket CLOB price history, the series the market chart draws, for open and resolved markets. The stored series is daily: a 1d candle usually holds one point, so its open, high, low and close are that day's close, and 1w aggregates the daily closes. No intraday detail is invented. Args: - condition_id (string, required): Raw provider condition_id or the mkt_-prefixed market id - resolution (string, optional): 1d (default, UTC day) or 1w (ISO week from Monday 00:00 UTC) - from (integer, optional): Exclusive lower bound, unix seconds - to (integer, optional): Inclusive upper bound, unix seconds; from must not be after to Returns: condition_id, resolution, and outcomes, each with its token_id and candles, plus meta.

  Paramètres, retour & exemple (4)

  Paramètres

  • to · integer · optionnel
    Inclusive upper bound in unix seconds; from must not be after to
  • from · integer · optionnel
    Exclusive lower bound in unix seconds
  • resolution · string · optionnel · 1d | 1w
    1d (the default) buckets by UTC day, 1w by ISO week from Monday 00:00 UTC
  • condition_id · string · requis
    Raw provider condition_id or the mkt_-prefixed market id

  Exemple d'appel

  {"name": "get_market_candles", "arguments": {"condition_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_market_flow≈ 1615 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • timeframe · string · optionnel · 1h | 4h | 24h | 7d
    Lookback window (default 24h)
  • condition_id · string · requis
    Market condition ID

  Exemple d'appel

  {"name": "get_market_flow", "arguments": {"condition_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_market_holders≈ 2606 tokens

  The S, A and B graded wallets holding one Polymarket market, from a complete provider holder scan: shares, Polymarket's currentValue for the leg, grade, win record in the market's category, and badges. A wallet holding both outcomes is listed once on its net side. Ordered by current value. The roster is at most 60 seconds old over a provider walk at most 180 seconds old; scan.fetched_at is its only timestamp. An incomplete scan is an error with a retry time, never a shorter list. C, D, F and ungraded wallets are never listed and are counted only in scan.wallet_count. Counts differ from get_positions by design: a live scan, the graded cohort, and no 100 USD size floor. Args: - condition_id (string, required): Raw provider condition_id or the mkt_-prefixed market id - outcome (string, optional): yes, no, or all (default) - min_grade (string, optional): S keeps S, A keeps S and A, B (default) keeps S, A and B - limit (number, 1-100, default 20): Holders per page - cursor (string, optional): next_cursor from the previous page, bound to the same market and filters Returns: data (holders), has_more, next_cursor, total, market, scan, totals and meta.

  Paramètres, retour & exemple (5)

  Paramètres

  • limit · integer · optionnel
    Max holders per page (1-100, default 20)
  • cursor · string · optionnel
    next_cursor from the previous page; it is bound to the same market and filters
  • outcome · string · optionnel · yes | no | all
    Keep holders netting one side; all (the default) lists both
  • min_grade · string · optionnel · S | A | B
    Narrow the graded cohort: S keeps S, A keeps S and A, B (the default) keeps S, A and B
  • condition_id · string · requis
    Raw provider condition_id or the mkt_-prefixed market id

  Exemple d'appel

  {"name": "get_market_holders", "arguments": {"condition_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_market_intel≈ 1622 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • timeframe · string · optionnel · 1h | 4h | 24h | 7d
    Lookback window (default 24h)
  • condition_id · string · requis
    Market condition ID

  Exemple d'appel

  {"name": "get_market_intel", "arguments": {"condition_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_market_snapshot≈ 2440 tokens

  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 - expand (string[], optional): "trust" adds per-field provenance (source, freshness, reconciliation, completeness) for current_price and spread_bps Returns: Market identity, outcomes, liquidity, sports context, and freshness states, plus trust when expanded.

  Paramètres, retour & exemple (2)

  Paramètres

  • expand · array · optionnel
    Optional heavy fields to include: trust adds provenance for current_price and spread_bps
  • condition_id · string · requis
    Raw provider condition_id

  Exemple d'appel

  {"name": "get_market_snapshot", "arguments": {"condition_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_monthly_report_snapshot≈ 2102 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • month · string · requis
    UTC report month in YYYY-MM format

  Exemple d'appel

  {"name": "get_monthly_report_snapshot", "arguments": {"month": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_pick_of_the_day≈ 4214 tokens

  Get today's published Pick of the Day selections and their recorded facts. Pro opens five selections in total: the explicitly designated free selection plus the first four non-free selections in publication order. Max opens every available daily selection, up to twenty. Read entitled `picks` in `publication_order` order; use stable decimal-string `pick_id` for identity, not deprecated `pick_rank`. `is_free_selection` designates account access; `supersedes_pick_id` is deprecated and always null. `locked_picks` lists extra unresolved slots with only pick_rank and required_tier=max; game identity, identifying clocks and backed facts are omitted. Each full pick carries the matchup, backed side (pick_outcome_label), recorded publication price and return on the flat $1,000 stake (`stake_usd`, `return_usd`; `return_per_100` keeps the literal $100 basis), available holder facts, top grade, CLV capture status and backend-provided thesis. `scheduled_picks` contains entitled scheduled slots with release_at and kickoff; unauthorized slots appear in identity-free locked_picks instead. No market identity is revealed before publication. Withdrawn picks are omitted from current and dated recommendations, the archive and its statistics, even after market settlement. The public ledger retains every published commitment under its original identity and proof bytes. When no active pick is available, the tool returns reason pick_not_released and retry_at. Schedule the next read from the returned retry guidance or an entitled scheduled slot's release_at instead of polling. An entitled published pick whose holder proof is not readable appears in `proof_pending_picks` (pick_rank, release_at, kickoff, retry_at), while `picks` contains readable picks. The tool returns read_model_warming only when no entitled published pick has readable proof. If only Max-locked selections have published, a successful state=none response carries picks=[], pick_count=0, locked_picks and an upgrade action. For automated entry, require a present, matching, unexpired entry_authorization. Honor its returned max_entry_price and expires_at, quote a current executable book for the actual stake and retain any stricter local limits. Fees are separate; authorization guarantees neither liquidity nor execution. Args: none Returns: The published pick set for the current product day (America/New_York), or a pick_not_released error with retry_at.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_pick_of_the_day", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_pick_of_the_day_archive≈ 2117 tokens

  Get the Pick of the Day track record: each published pick that has not been withdrawn, with its outcome (win, loss, void or pending), recorded publication price, unit score and CLV fields, plus the rolling hit rate (wins / decided; void and pending excluded) and flat-$1,000-stake profit and ROI (`hit_rate.stake_usd` names the stake). The actual API key tier controls unresolved access: Pro opens five selections in total, the designated free selection plus the first four non-free selections in publication order; Max opens every available daily selection, up to twenty. Every resolved outcome (win/loss/void) is public. Unentitled pending rows retain only slot/date/outcome and required_tier with backed_side_locked=true; matchup, category, league, image, publication clock and backed facts are omitted. The archive retains the included historical picks, losses included. Withdrawn recommendations are omitted from archive rows and every aggregate, including the cumulative series, even after market settlement. The public ledger retains every published commitment under its original pick_id and proof bytes. 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).

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_pick_of_the_day_archive", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_pick_of_the_day_ledger_entry≈ 2374 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • pick_id · string · requis
    Stable positive database row id as decimal text

  Exemple d'appel

  {"name": "get_pick_of_the_day_ledger_entry", "arguments": {"pick_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_platforms≈ 1083 tokens

  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.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_platforms", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_position_timeline≈ 1300 tokens

  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 warm-tier traders, the wallets we sync most often, 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.

  Paramètres, retour & exemple (5)

  Paramètres

  • limit · integer · optionnel
    Max events (1-100, default 20)
  • cursor · string · optionnel
    Pagination cursor from previous response
  • address · string · optionnel
    Trader identity: 0x wallet, username, trd_-prefixed traders.id, or bare integer traders.id
  • trader_id · integer · optionnel
    Internal traders.id alias
  • condition_id · string · requis
    Market condition ID

  Exemple d'appel

  {"name": "get_position_timeline", "arguments": {"condition_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_position_timeline_by_id≈ 1122 tokens

  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.

  Paramètres, retour & exemple (4)

  Paramètres

  • limit · integer · optionnel
    Max events (1-100, default 20)
  • cursor · string · optionnel
    Pagination cursor from previous response
  • trader_id · integer · requis
    Internal traders.id alias
  • condition_id · string · requis
    Market condition ID

  Exemple d'appel

  {"name": "get_position_timeline_by_id", "arguments": {"trader_id": 1, "condition_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_positions≈ 2354 tokens

  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.

  Paramètres, retour & exemple (9)

  Paramètres

  • side · string · optionnel · yes | no
    Filter by binary outcome side
  • limit · integer · optionnel
    Max results (1-100, default 20)
  • cursor · string · optionnel
    Pagination cursor from previous response
  • wallet · array · optionnel
    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 · string · optionnel
    Filter by provider-backed market category
  • min_size · number · optionnel
    Minimum current position value in USD; defaults to 100, or to 0 when wallet is present
  • min_grade · string · optionnel · S | A | B | C | D | F
    Minimum trader grade
  • consistency · string · optionnel · live | snapshot
    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 · string · optionnel
    Scope to one market: raw provider condition_id or mkt_-prefixed market id

  Exemple d'appel

  {"name": "get_positions", "arguments": {"side": "yes", "limit": 1, "cursor": "texte", "wallet": [], "category": "texte", "min_size": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_report≈ 2238 tokens

  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).

  Paramètres, retour & exemple (2)

  Paramètres

  • period · string · requis
    Period token: daily YYYY-MM-DD, weekly YYYY-WW or a from,to YYYY-MM-DD pair, monthly YYYY-MM
  • granularity · string · requis · daily | weekly | monthly
    Report granularity selector

  Exemple d'appel

  {"name": "get_report", "arguments": {"period": "texte", "granularity": "daily"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_sharp_money_flows≈ 1575 tokens

  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.

  Paramètres, retour & exemple (7)

  Paramètres

  • limit · integer · optionnel
    Max results (1-100, default 20)
  • cursor · string · optionnel
    Pagination cursor with smf_ prefix
  • category · string · optionnel
    Filter by provider-backed market category
  • platform · string · optionnel · polymarket | all
    Platform filter (default all)
  • direction · string · optionnel · YES | NO
    Filter by net flow direction
  • min_grade · string · optionnel · S | A | B | C | D | F
    Minimum trader grade (default B = S/A/B)
  • timeframe · string · optionnel · 1h | 4h | 24h | 7d
    Lookback window (default 24h)

  Exemple d'appel

  {"name": "get_sharp_money_flows", "arguments": {"limit": 1, "cursor": "texte", "category": "texte", "platform": "polymarket", "direction": "YES", "min_grade": "S"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_smart_money_flows≈ 1607 tokens

  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.

  Paramètres, retour & exemple (7)

  Paramètres

  • limit · integer · optionnel
    Max results (1-100, default 20)
  • cursor · string · optionnel
    Pagination cursor with smf_ prefix
  • category · string · optionnel
    Filter by provider-backed market category
  • platform · string · optionnel · polymarket | all
    Platform filter (default all)
  • direction · string · optionnel · YES | NO
    Filter by net flow direction
  • min_grade · string · optionnel · S | A | B | C | D | F
    Minimum trader grade (default B = S/A/B)
  • timeframe · string · optionnel · 1h | 4h | 24h | 7d
    Lookback window (default 24h)

  Exemple d'appel

  {"name": "get_smart_money_flows", "arguments": {"limit": 1, "cursor": "texte", "category": "texte", "platform": "polymarket", "direction": "YES", "min_grade": "S"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_suspicious_trade≈ 1052 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • id · string · requis
    Suspicious trade ID such as rf_123 or 123

  Exemple d'appel

  {"name": "get_suspicious_trade", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_suspicious_trades≈ 1449 tokens

  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.

  Paramètres, retour & exemple (5)

  Paramètres

  • mode · string · optionnel · live | stable
    live uses the fresh response cache; stable pins pagination to one published scoring generation
  • limit · integer · optionnel
    Max results (1-100, default 20)
  • cursor · string · optionnel
    Pagination cursor from previous response
  • severity · string · optionnel · flag | watch
    "flag" selects live rows; "watch" returns none because no live watch policy exists
  • min_suspicion · number · optionnel
    Minimum suspicion score (0-100); the live floor of 60 also applies

  Exemple d'appel

  {"name": "get_suspicious_trades", "arguments": {"mode": "live", "limit": 1, "cursor": "texte", "severity": "flag", "min_suspicion": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_trader≈ 3594 tokens

  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" - max_age_s (integer, optional, 0 or more): Freshness ceiling in seconds. The call answers only when data_quality.status is fresh and data_quality.as_of is no older than this; otherwise it fails with reason freshness_ceiling_unsatisfied (HTTP 409). Nothing is refreshed to meet it 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.

  Paramètres, retour & exemple (3)

  Paramètres

  • expand · array · optionnel
    Optional heavy fields to include
  • address · string · requis
    Ethereum wallet address (0x...) or trader username
  • max_age_s · integer · optionnel
    Freshness ceiling in seconds: answer only when data_quality.status is fresh and data_quality.as_of is no older than this, otherwise fail with freshness_ceiling_unsatisfied

  Exemple d'appel

  {"name": "get_trader", "arguments": {"address": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_trader_categories≈ 1390 tokens

  One wallet's win record in every canonical category it has a settled market in: wins, decided (wins plus losses) and win_rate per category, busiest first. The Esports record also lists each esports game it has a settled market in. The basis is every settled market at any size, so it differs from get_trader's categories expansion, which applies a 20 USD notional floor and an entry-price rule; neither corrects the other. A category with fewer decided markets than min_decided_for_win_rate keeps its counts with win_rate null and status not_enough_data. An absent category means no record, never a 0% record. Args: - address (string, required): Wallet address (0x...), username, or trd_-prefixed trader id - category (string, optional): One canonical category through the shared rollup: soccer and EPL reach Soccer, every esports label reaches Esports, football is American football. A game is not a filter: ask for esports and read games Returns: records, min_decided_for_win_rate, basis, computed_at and meta. A trader with no settled market returns empty records; an unknown address is a not_found error.

  Paramètres, retour & exemple (2)

  Paramètres

  • address · string · requis
    Wallet address (0x...), username, or trd_-prefixed trader id
  • category · string · optionnel
    One canonical category through the shared rollup: soccer and EPL reach Soccer, every esports label reaches Esports, football is American football. A value matching no record returns empty records

  Exemple d'appel

  {"name": "get_trader_categories", "arguments": {"address": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_trader_context≈ 3574 tokens

  One structured context object for a trader: the full get_trader profile plus position_summary (sync coverage and realized and unrealized P&L rollups with an as_of open-position clock), data_as_of and a freshness_note on what the point-in-time snapshot covers. position_summary is absent when the trader is not tracked locally or native net economics is unavailable. A wallet address with no trader yet returns sync_status "unknown" on the nested trader; a username or trader id that matches no trader is a not_found error. Args: - address (string, required): Wallet address (0x...), username, or trd_-prefixed trader id Returns: trader, position_summary, data_as_of, freshness_note and meta.

  Paramètres, retour & exemple (1)

  Paramètres

  • address · string · requis
    Wallet address (0x...), username, or trd_-prefixed trader id

  Exemple d'appel

  {"name": "get_trader_context", "arguments": {"address": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_trader_export_snapshot≈ 1628 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • address · string · requis
    Trader wallet address, known username-style lookup, or trd_-prefixed trader ID emitted by the API. Bare integer database IDs are not accepted

  Exemple d'appel

  {"name": "get_trader_export_snapshot", "arguments": {"address": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_trader_grade_at≈ 1267 tokens

  The grade a trader was visibly recorded with at a past instant, from prospective grade observations: what the wallet's grade was when a trade or decision happened, never a reconstruction. status is graded, ungraded or unknown; use grade only when status is graded. Before available_from (the first recorded observation), after deletion, or in a grade-transition gap, status is unknown and grade is null. observation carries observed_at, published_by and model provenance, which older observations leave null. Never substitute a current grade. Args: - address (string, required): Wallet address (0x...), username, or trd_-prefixed trader id - as_of (string, required): RFC3339 instant, such as the trade or decision time; future instants are refused Returns: status, grade, available_from, observation and meta.

  Paramètres, retour & exemple (2)

  Paramètres

  • as_of · string · requis
    RFC3339 instant whose recorded grade is read, such as the trade or decision time; future instants are refused
  • address · string · requis
    Wallet address (0x...), username, or trd_-prefixed trader id

  Exemple d'appel

  {"name": "get_trader_grade_at", "arguments": {"as_of": "texte", "address": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_trader_pnl≈ 2337 tokens

  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.

  Paramètres, retour & exemple (4)

  Paramètres

  • to · string · optionnel
    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 · string · optionnel
    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 · string · requis
    Wallet address (0x...), username, or trd_-prefixed trader id
  • sections · array · optionnel
    Which sections of the object to return; omit for all five. A section left out is absent from the result, never null or empty

  Exemple d'appel

  {"name": "get_trader_pnl", "arguments": {"address": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_trending_wallets≈ 1401 tokens

  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.

  Paramètres, retour & exemple (3)

  Paramètres

  • limit · integer · optionnel
    Max results (1-50, default 20; the provider board caps the ranked set at 50)
  • cursor · string · optionnel
    Opaque pagination cursor from previous response
  • window · string · optionnel · 7d | 30d
    Trailing window (default 7d)

  Exemple d'appel

  {"name": "get_trending_wallets", "arguments": {"limit": 1, "cursor": "texte", "window": "7d"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_webhook≈ 1481 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • id · integer · requis
    Webhook endpoint id

  Exemple d'appel

  {"name": "get_webhook", "arguments": {"id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_weekly_report_snapshot≈ 2224 tokens

  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.

  Paramètres, retour & exemple (3)

  Paramètres

  • to · string · optionnel
    UTC source-range end in YYYY-MM-DD format
  • from · string · optionnel
    UTC source-range start in YYYY-MM-DD format
  • week · string · optionnel
    ISO week selector in YYYY-WW format

  Exemple d'appel

  {"name": "get_weekly_report_snapshot", "arguments": {"to": "texte", "from": "texte", "week": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_whale_trade≈ 2018 tokens

  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.

  Paramètres, retour & exemple (1)

  Paramètres

  • id · string · requis
    Large trade ID such as wt_123 or 123

  Exemple d'appel

  {"name": "get_whale_trade", "arguments": {"id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_whale_trades≈ 2328 tokens

  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.

  Paramètres, retour & exemple (9)

  Paramètres

  • sort · string · optionnel · recent | market_volume_share
    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 · integer · optionnel
    Max results (1-100, default 20)
  • since · string · optionnel
    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 · string · optionnel
    Pagination cursor from previous response
  • category · string · optionnel
    Filter by market category (case-insensitive)
  • min_size · number · optionnel
    Minimum trade size in USD (default 5000)
  • min_grade · string · optionnel · S | A | B | C | D | F
    Minimum trader grade
  • suspicious_only · boolean · optionnel
    Keep only rows with persisted suspicion_score >= 60
  • min_market_volume_share · number · optionnel
    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

  Exemple d'appel

  {"name": "get_whale_trades", "arguments": {"sort": "recent", "limit": 1, "since": "texte", "cursor": "texte", "category": "texte", "min_size": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_whale_trades_history≈ 2110 tokens

  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.

  Paramètres, retour & exemple (13)

  Paramètres

  • to · string · optionnel
    Exclusive traded_at upper bound
  • from · string · optionnel
    Inclusive traded_at lower bound
  • sort · string · optionnel · recent | market_volume_share
    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 · integer · optionnel
    Max results (1-100, default 20)
  • cursor · string · optionnel
    Pagination cursor from previous response
  • trader · string · optionnel
    Trader wallet, alias, or username
  • category · string · optionnel
    Filter by market category
  • min_size · number · optionnel
    Minimum trade size in USD
  • platform · string · optionnel · polymarket | all
    Filter by provider platform
  • min_grade · string · optionnel · S | A | B | C | D | F
    Minimum trader grade
  • condition_id · string · optionnel
    Exact raw provider condition_id
  • suspicious_only · boolean · optionnel
    Keep only rows with persisted suspicion_score >= 60
  • min_market_volume_share · number · optionnel
    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

  Exemple d'appel

  {"name": "get_whale_trades_history", "arguments": {"to": "texte", "from": "texte", "sort": "recent", "limit": 1, "cursor": "texte", "trader": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_games≈ 3143 tokens

  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_edge_hunter.

  Paramètres, retour & exemple (7)

  Paramètres

  • limit · integer · optionnel
    Max results (1-100, default 20)
  • sport · string · optionnel
    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 · string · optionnel
    Opaque gms_v1_ cursor from next_cursor; it pins the page position (kickoff and event_slug), not a snapshot
  • league · string · optionnel
    League tag as coverage.leagues spells it: nfl, epl, cs2. Case-insensitive
  • status · string · optionnel · scheduled | live | paused | ended | postponed | cancelled | suspended | delayed
    Keep only games in this state
  • starts_after · string · optionnel
    RFC 3339 instant; keep only games whose kickoff is at or after it
  • starts_before · string · optionnel
    RFC 3339 instant; keep only games whose kickoff is at or before it. Must be at or after starts_after

  Exemple d'appel

  {"name": "list_games", "arguments": {"limit": 1, "sport": "texte", "cursor": "texte", "league": "texte", "status": "scheduled", "starts_after": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_webhooks≈ 1503 tokens

  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.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "list_webhooks", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_content≈ 997 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • q · string · requis
    Search query (1-256 characters before whitespace trimming, non-empty after trimming)
  • limit · integer · optionnel
    Max results (1-50, default 10)

  Exemple d'appel

  {"name": "search_content", "arguments": {"q": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• search_markets≈ 1203 tokens

  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.

  Paramètres, retour & exemple (5)

  Paramètres

  • q · string · requis
    Search query (1-512 characters before whitespace trimming, non-empty after trimming)
  • limit · integer · optionnel
    Max results per page (1-100, default 20)
  • cursor · string · optionnel
    Pagination cursor from the previous response's next_cursor; send it with the same q, status and category
  • status · string · optionnel · active | closed | all
    Filter by market status
  • category · string · optionnel
    Filter by category

  Exemple d'appel

  {"name": "search_markets", "arguments": {"q": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://api.0xinsider.com/api/v1/mcp