# PredictFunScan

> For full documentation, glossary, methodology, and FAQ, see [llms-full.txt](https://predictfunscan.com/llms-full.txt).

> PredictFunScan is a Bloomberg Terminal-style analytics and intelligence platform for Predict.Fun, a prediction market built on BNB Chain (BSC) using USDT as collateral. It indexes ~96,000 trader wallets, ~32,000 markets, and ~6.2 million trade events. The platform provides trader profiles with PnL tracking, market analytics, wallet intelligence badges (Sharp / Whale / Sniper / Degen / New trader), live trade feeds, and biggest-mover leaderboards. Data is sourced from Predict.Fun's authoritative GraphQL endpoint (graphql.predict.fun), its REST trade-matches API, and on-chain BSC market resolution.

## Core Pages

- [Markets](https://predictfunscan.com/markets): All active and resolved Predict.Fun prediction markets. Filter by category, sort by volume or liquidity, view event-grouped markets.
- [Trader Search](https://predictfunscan.com/search): Search the full indexed set of ~96K Predict.Fun trader wallets by address or username. View PnL, positions, trade history, win rates, and wallet badges.
- [Leaderboards](https://predictfunscan.com/leaderboards): Site engagement leaderboard for PredictFunScan users.
- [Movers](https://predictfunscan.com/movers): Surfaces wallets with the largest recent PnL changes across the indexed population.

## URL Patterns

PredictFunScan uses stable, indexable URLs for every trader and market:

- `https://predictfunscan.com/address/:wallet` — trader profile page (EOA or Predict.Fun proxy wallet)
- `https://predictfunscan.com/pf/market/:slug` — Predict.Fun market detail page
- `https://predictfunscan.com/markets` — markets browsing hub
- `https://predictfunscan.com/leaderboards` — site engagement leaderboard
- `https://predictfunscan.com/search` — trader and market search
- `https://predictfunscan.com/movers` — biggest PnL movers

## Wallet Intelligence Badges

Every indexed wallet is evaluated against trade-pattern heuristics and may receive one or more of:

- **Sharp** — consistently profitable, well-calibrated trader
- **Whale** — high-volume trader by USDT cost basis
- **Sniper** — wallet that frequently enters early on resolving markets
- **Degen** — high-frequency, high-variance trading pattern
- **New trader** — recently active wallet without sufficient history for other classifications

## Data & Methodology

- **Per-wallet stats** (PnL, volume, position counts): Predict.Fun's authoritative GraphQL API (`graphql.predict.fun`)
- **Per-trade matches**: Predict.Fun REST API
- **Market resolution**: on-chain BSC via the ConditionalTokens contract at `0xf64b0b318aaf83bd9071110af24d24445719a07f`
- **Trader badges and enrichment**: proprietary indexing pipeline run on Supabase edge functions

Predict.Fun is a Gnosis-CTF-forked prediction market on BNB Chain (chainId 56). Collateral is USDT (`0x55d398326f99059ff775485246999027b3197955`). Outcome shares are ERC-1155 tokens minted by the ConditionalTokens contract. Trades clear through the CTF Exchange at `0x8a289d458f5a134ba40015085a8f50ffb681b41d`.

## API Access

A public REST API for third-party agents and developers is **in development**. The site currently exposes structured data via JSON-LD on every market and trader page (FAQPage, Dataset, BreadcrumbList, WebPage schemas) which AI crawlers can extract directly.

## Contact

- Website: https://predictfunscan.com