Preflight copy-trading a wallet
preflight_copyRead-onlyIdempotent
COPY / WATCH / VETO verdict for copy-trading a Polymarket wallet, with the numbers behind it (fee-inclusive copier ROI from a fixed $5-entry / +2c-slippage simulation, win rate, entry-price buckets, category mix). Wallets not yet computed return QUEUED free of charge - typically ready in minutes (retry_after_seconds tells you when); worst case about an hour. Price: $0.10 per call via x402 or 5 credits with a bearer token; sandbox: true is free.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wallet | No | Polymarket wallet address (0x + 40 hex). Required for live calls; optional with sandbox: true. | |
| sandbox | No | true = free deterministic example response, never charged. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| name | No | Last pseudonym seen on the tape. | |
| note | No | ||
| paid | No | 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 | No | ||
| wallet | No | ||
| window | No | ||
| reasons | No | ||
| sandbox | No | True when the response is the free deterministic sandbox example. | |
| verdict | Yes | 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 | No | ||
| n_resolved | No | ||
| active_days | No | ||
| computed_at | No | ||
| win_rate_pct | No | ||
| last_trade_at | No | ||
| both_sides_pct | No | Share of markets where the wallet bought BOTH outcomes (farming smell). | |
| first_trade_at | No | ||
| avg_entry_price | No | ||
| n_first_entries | No | Distinct (market, outcome) first BUY entries in the window; crypto up/down markets excluded. | |
| category_mix_pct | No | ||
| clips_per_entry_avg | No | Iceberg signal - how many fills the wallet splits one entry into. | |
| entry_price_buckets | No | ||
| retry_after_seconds | No | QUEUED only. | |
| roi_fee_inclusive_pct | No | Slippage basis minus explicit 2026 taker fees (rate*p*(1-p)). | |
| roi_slippage_basis_pct | No | $5/entry at whale price +2c slippage, held to resolution. |