API

The same live data the site renders, as JSON. Free, no key, CORS-open GETs. Base URL: https://foreteller.world

curl -s https://foreteller.world/api/leaderboard?limit=5 | jq '.foretellers[].wallet'

GET/api/leaderboard?limit=25&window=7d

Ranked foretellers. window=24h for last-day realized PnL.

{"foretellers":[{"wallet":"6FTh…","score":83,"roi":6.65,"pnl":11701,"n":93,"delta":2}]}

GET/api/trader/:wallet

Full profile: stats, rank, settled history, open positions, recent activity.

{"rank":1,"stats":{"score":83,"roi":6.65,"pnl":11701},"open":[…],"recent":[…]}

GET/api/markets?limit=100

Markets with volume, trades, traders, resolved state.

{"markets":[{"id":"H75T…","title":"ARG vs MEX: ARG wins","volume":42100,"trades":726}]}

GET/api/market/:id

One market: live YES price, price history series, top traders, recent trades.

{"yesPrice":0.66,"series":[…],"topTraders":[…],"winner":null}

GET/api/signals?limit=40

Live trade tape, newest first, with trader scores.

{"signals":[{"wallet":"4Vxq…","kind":"buy","side":"yes","size":500,"price":0.81,"sig":"…"}]}

GET/api/movers

Biggest YES-odds swings in the last hour.

{"movers":[{"title":"BTC Up","from":0.41,"to":0.62,"delta":0.21}]}

GET/api/stats

Network totals: all-time, 7d window, 24h, categories, top markets.

{"cumulative":{"volume":803512,"trades":115800},"day":{"volume":168000}}

GET/api/sync

Index health: backfill state, window coverage %, seconds since last trade.

{"syncing":false,"coverage":100,"newestAgo":7}

Be reasonable with polling (the site itself polls every 4-5s). For push instead of pull, the Telegram bot streams the same events. Methodology behind every number: /methodology.