mcp

{'type': 'object', 'properties': {}, 'additionalProperties': False}

{'type': 'object', 'required': ['ok'], 'properties': {'ok': {'type': 'boolean'}, 'how': {'type': 'string', 'description': 'How to buy a pack (x402 payment on POST /api/credits).'}, 'why': {'type': 'string', 'description': 'Why credits exist (fast header auth vs per-call on-chain settle).'}, 'pack': {'type': 'object', 'description': 'Pack terms: {usd, credits, valid_days}.'}, 'costs': {'type': 'object', 'description': 'Per-endpoint credit costs: preflight_trade / leaderboard / red_list = 1; preflight_copy = 5.'}, 'balance': {'type': 'integer', 'description': 'Remaining credits for the wallet behind the bearer token. Present only with a valid token.'}, 'expires': {'type': 'string', 'description': 'Credit expiry (12 months from purchase). Present only with a valid token.'}}}

{'type': 'object', 'properties': {'sandbox': {'type': 'boolean', 'description': 'true = free deterministic example response, never charged.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['ok', 'wallets'], 'properties': {'ok': {'type': 'boolean'}, 'note': {'type': 'string'}, 'paid': {'type': 'object', 'properties': {'network': {'type': 'string', 'description': 'CAIP-2 network id, eip155:8453 (Base).'}, 'receipt': {'type': ['string', 'null'], 'description': 'Basescan link for the settlement.'}, 'transaction': {'type': 'string', 'description': 'On-chain settlement transaction hash.'}, 'credits_used': {'type': 'integer'}, 'price_paid_usdc': {'type': 'string', 'description': 'USDC settled for this call, decimal string (e.g. "0.02").'}, 'credits_remaining': {'type': 'integer'}}, 'description': 'Payment record. Per-call x402 lane: price_paid_usdc / transaction / network / receipt. Credit lane: credits_used / credits_remaining. Absent on sandbox and free QUEUED responses.'}, 'method': {'type': 'string'}, 'window': {'type': 'string', 'description': 'Human-readable audit window.'}, 'sandbox': {'type': 'boolean', 'description': 'True when the response is the free deterministic sandbox example.'}, 'wallets': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'verdict'], 'properties': {'name': {'type': 'string', 'description': 'Polymarket display name (public pseudonym).'}, 'reasons': {'type': 'array', 'items': {'type': 'string'}}, 'verdict': {'enum': ['COPY', 'WATCH', 'VETO'], 'type': 'string'}, 'oos_trades': {'type': 'integer', 'description': 'Number of mirrored trades in the out-of-sample month. Present when the OOS sample size drove the verdict; distinct from copied_trades, which counts the in-sample window.'}, 'win_rate_pct': {'type': 'number'}, 'copied_trades': {'type': 'integer', 'description': 'Number of mirrored trades in the in-sample window.'}, 'oos_validated': {'type': 'boolean', 'description': 'True if the wallet survived the out-of-sample month.'}, 'roi_fee_inclusive_pct': {'type': 'number', 'description': 'Simulated copier ROI with explicit 2026 taker fees, first-entry mirror $5/trade, 2c slippage.'}, 'roi_slippage_basis_pct': {'type': 'number', 'description': 'Simulated copier ROI net of the 2c slippage floor, before explicit taker fees.'}}}, 'description': 'Wallets rated COPY or WATCH.'}, 'universe': {'type': 'string', 'description': 'The selection funnel behind the ratings.'}, 'computed_at': {'type': 'string'}}}

{'type': 'object', 'properties': {'wallet': {'type': 'string', 'description': 'Polymarket wallet address (0x + 40 hex). Required for live calls; optional with sandbox: true.'}, 'sandbox': {'type': 'boolean', 'description': 'true = free deterministic example response, never charged.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['ok', 'verdict'], 'properties': {'ok': {'type': 'boolean'}, 'name': {'type': ['string', 'null'], 'description': 'Last pseudonym seen on the tape.'}, 'note': {'type': 'string'}, 'paid': {'type': 'object', 'properties': {'network': {'type': 'string', 'description': 'CAIP-2 network id, eip155:8453 (Base).'}, 'receipt': {'type': ['string', 'null'], 'description': 'Basescan link for the settlement.'}, 'transaction': {'type': 'string', 'description': 'On-chain settlement transaction hash.'}, 'credits_used': {'type': 'integer'}, 'price_paid_usdc': {'type': 'string', 'description': 'USDC settled for this call, decimal string (e.g. "0.02").'}, 'credits_remaining': {'type': 'integer'}}, 'description': 'Payment record. Per-call x402 lane: price_paid_usdc / transaction / network / receipt. Credit lane: credits_used / credits_remaining. Absent on sandbox and free QUEUED responses.'}, 'method': {'type': 'string'}, 'wallet': {'type': 'string'}, 'window': {'type': 'object', 'properties': {'to': {'type': 'string'}, 'days': {'type': 'integer'}, 'from': {'type': 'string'}}}, 'reasons': {'type': 'array', 'items': {'type': 'string'}}, 'sandbox': {'type': 'boolean', 'description': 'True when the response is the free deterministic sandbox example.'}, 'verdict': {'enum': ['COPY', 'WATCH', 'VETO', 'NO_COVERAGE', 'QUEUED'], 'type': 'string', 'description': 'COPY only for out-of-sample-validated wallets; in-sample verdicts are capped at WATCH. VETO = negative fee-inclusive copier ROI or both-sides farming. NO_COVERAGE = below the 10-first-entry floor. QUEUED = not computed yet (free) - typically ready in minutes (retry_after_seconds tells you when); worst case about an hour.'}, 'n_pending': {'type': 'integer'}, 'n_resolved': {'type': 'integer'}, 'active_days': {'type': 'integer'}, 'computed_at': {'type': 'string'}, 'win_rate_pct': {'type': ['number', 'null']}, 'last_trade_at': {'type': ['string', 'null']}, 'both_sides_pct': {'type': 'number', 'description': 'Share of markets where the wallet bought BOTH outcomes (farming smell).'}, 'first_trade_at': {'type': ['string', 'null']}, 'avg_entry_price': {'type': ['number', 'null']}, 'n_first_entries': {'type': 'integer', 'description': 'Distinct (market, outcome) first BUY entries in the window; crypto up/down markets excluded.'}, 'category_mix_pct': {'type': 'object', 'additionalProperties': {'type': 'number'}}, 'clips_per_entry_avg': {'type': 'number', 'description': 'Iceberg signal - how many fills the wallet splits one entry into.'}, 'entry_price_buckets': {'type': 'object', 'additionalProperties': {'type': 'integer'}}, 'retry_after_seconds': {'type': 'integer', 'description': 'QUEUED only.'}, 'roi_fee_inclusive_pct': {'type': ['number', 'null'], 'description': 'Slippage basis minus explicit 2026 taker fees (rate*p*(1-p)).'}, 'roi_slippage_basis_pct': {'type': ['number', 'null'], 'description': '$5/entry at whale price +2c slippage, held to resolution.'}}, 'description': 'Copy-trading profile for one wallet (rolling 90-day window, recomputed nightly). QUEUED responses carry only verdict/wallet/reasons/retry_after_seconds and are always free.'}

{'type': 'object', 'properties': {'usd': {'type': 'number', 'description': 'Order size in USD. Default 100, max 10000.'}, 'side': {'enum': ['BUY', 'SELL'], 'type': 'string', 'description': 'Order side. Default BUY.'}, 'slug': {'type': 'string', 'description': 'Market or event slug (a polymarket.com/event/<slug> URL works too). Use with outcome.'}, 'outcome': {'type': 'string', 'description': 'Outcome name, e.g. Yes / No / candidate name (partial match OK for multi-outcome events).'}, 'sandbox': {'type': 'boolean', 'description': 'true = free deterministic example response, never charged.'}, 'token_id': {'type': 'string', 'description': 'CLOB token id - alternative to slug + outcome.'}, 'max_book_age_s': {'type': 'number', 'description': 'Threshold override: maximum acceptable order-book age in seconds. Default 60.'}, 'max_slippage_c': {'type': 'number', 'description': 'Threshold override: slippage in cents above which the verdict degrades from OK to CAUTION. Default 1.0.'}, 'veto_slippage_c': {'type': 'number', 'description': 'Threshold override: slippage in cents at which the verdict becomes VETO. Default 3.0.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['ok', 'verdict'], 'properties': {'ok': {'type': 'boolean'}, 'meta': {'type': 'object', 'description': 'Method, audience and thresholds used. Present on live-book responses (absent on sandbox examples).'}, 'note': {'type': 'string'}, 'paid': {'type': 'object', 'properties': {'network': {'type': 'string', 'description': 'CAIP-2 network id, eip155:8453 (Base).'}, 'receipt': {'type': ['string', 'null'], 'description': 'Basescan link for the settlement.'}, 'transaction': {'type': 'string', 'description': 'On-chain settlement transaction hash.'}, 'credits_used': {'type': 'integer'}, 'price_paid_usdc': {'type': 'string', 'description': 'USDC settled for this call, decimal string (e.g. "0.02").'}, 'credits_remaining': {'type': 'integer'}}, 'description': 'Payment record. Per-call x402 lane: price_paid_usdc / transaction / network / receipt. Credit lane: credits_used / credits_remaining. Absent on sandbox and free QUEUED responses.'}, 'order': {'type': 'object', 'properties': {'usd': {'type': 'number'}, 'side': {'enum': ['BUY', 'SELL'], 'type': 'string'}}, 'description': 'The order as understood by the endpoint.'}, 'market': {'type': 'object', 'properties': {'slug': {'type': ['string', 'null']}, 'outcome': {'type': ['string', 'null']}, 'question': {'type': ['string', 'null']}, 'token_id': {'type': 'string'}}, 'description': 'The market the verdict was computed for.'}, 'numbers': {'type': 'object', 'properties': {'best_price': {'type': 'number', 'description': 'Best available price on the relevant side of the book.'}, 'fee_category': {'type': 'string', 'description': 'Fee schedule category applied to this market.'}, 'expected_vwap': {'type': 'number', 'description': 'Volume-weighted average fill price for the requested size.'}, 'safe_size_usd': {'type': 'number', 'description': 'Largest order size that would still pass the OK thresholds on this book.'}, 'taker_fee_usd': {'type': 'number', 'description': 'Total taker fee for this order under the 2026 schedule.'}, 'book_age_seconds': {'type': 'number', 'description': 'Age of the order-book snapshot used.'}, 'visible_depth_usd': {'type': 'number', 'description': 'Visible depth on the relevant side, in USD.'}, 'order_vs_depth_pct': {'type': 'number', 'description': 'Order size as a percentage of visible depth.'}, 'expected_slippage_cents': {'type': 'number', 'description': 'expected_vwap minus best_price, in cents per share.'}, 'fee_drag_cents_per_share': {'type': 'number', 'description': 'Taker fee in cents per share (rate * p * (1-p)).'}}}, 'reasons': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Reasons, each carrying the number that triggered it.'}, 'sandbox': {'type': 'boolean', 'description': 'True when the response is the free deterministic sandbox example.'}, 'verdict': {'enum': ['OK', 'CAUTION', 'VETO'], 'type': 'string', 'description': 'Deterministic verdict on executing this order now, at this size, on this book. Not a prediction of the market outcome.'}}}

{'type': 'object', 'properties': {'sandbox': {'type': 'boolean', 'description': 'true = free deterministic example response, never charged.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['ok', 'wallets'], 'properties': {'ok': {'type': 'boolean'}, 'note': {'type': 'string'}, 'paid': {'type': 'object', 'properties': {'network': {'type': 'string', 'description': 'CAIP-2 network id, eip155:8453 (Base).'}, 'receipt': {'type': ['string', 'null'], 'description': 'Basescan link for the settlement.'}, 'transaction': {'type': 'string', 'description': 'On-chain settlement transaction hash.'}, 'credits_used': {'type': 'integer'}, 'price_paid_usdc': {'type': 'string', 'description': 'USDC settled for this call, decimal string (e.g. "0.02").'}, 'credits_remaining': {'type': 'integer'}}, 'description': 'Payment record. Per-call x402 lane: price_paid_usdc / transaction / network / receipt. Credit lane: credits_used / credits_remaining. Absent on sandbox and free QUEUED responses.'}, 'method': {'type': 'string'}, 'window': {'type': 'string', 'description': 'Human-readable audit window.'}, 'sandbox': {'type': 'boolean', 'description': 'True when the response is the free deterministic sandbox example.'}, 'wallets': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'verdict'], 'properties': {'name': {'type': 'string', 'description': 'Polymarket display name (public pseudonym).'}, 'reasons': {'type': 'array', 'items': {'type': 'string'}}, 'verdict': {'enum': ['COPY', 'WATCH', 'VETO'], 'type': 'string'}, 'oos_trades': {'type': 'integer', 'description': 'Number of mirrored trades in the out-of-sample month. Present when the OOS sample size drove the verdict; distinct from copied_trades, which counts the in-sample window.'}, 'win_rate_pct': {'type': 'number'}, 'copied_trades': {'type': 'integer', 'description': 'Number of mirrored trades in the in-sample window.'}, 'oos_validated': {'type': 'boolean', 'description': 'True if the wallet survived the out-of-sample month.'}, 'roi_fee_inclusive_pct': {'type': 'number', 'description': 'Simulated copier ROI with explicit 2026 taker fees, first-entry mirror $5/trade, 2c slippage.'}, 'roi_slippage_basis_pct': {'type': 'number', 'description': 'Simulated copier ROI net of the 2c slippage floor, before explicit taker fees.'}}}, 'description': 'Wallets rated VETO - copying them lost money for the simulated copier.'}, 'universe': {'type': 'string', 'description': 'The selection funnel behind the ratings.'}, 'computed_at': {'type': 'string'}}}