# Codex API > Polymarket holders, positions, PnL, trades, leaderboards and live fills, rebuilt from Polygon by Nomos. - [Codex API](https://dash-docs.nomos.trade/index.md): Polymarket, rebuilt from the chain: holders, positions, PnL, trades, leaderboards and live fills for every market. - [Quickstart](https://dash-docs.nomos.trade/quickstart.md): Your first call to the Codex API. - [Authentication](https://dash-docs.nomos.trade/authentication.md): Send your key as a bearer token on every request. - [Rate Limits](https://dash-docs.nomos.trade/rate-limits.md): Your rate, your burst, and what to do when you hit them. - [Conventions](https://dash-docs.nomos.trade/concepts/conventions.md): How ids, units and times are written across the API. - [Freshness and Completeness](https://dash-docs.nomos.trade/concepts/freshness.md): How far each answer reflects the chain, and when data is final. - [Pagination](https://dash-docs.nomos.trade/concepts/pagination.md): Walk long lists with the cursor each page hands you. - [Errors](https://dash-docs.nomos.trade/concepts/errors.md): Every error is JSON with a message written for a person. - [Glossary](https://dash-docs.nomos.trade/concepts/glossary.md): Polymarket and Codex terms as these docs use them. - [1-Minute Candles from Fills](https://dash-docs.nomos.trade/recipes/candles.md): Build OHLCV candles for a market from raw fills, and know which ones are final. - [Big-Trade Alerts](https://dash-docs.nomos.trade/recipes/big-trades.md): Follow the live tape and print every fill over $10,000, with the trader's name. - [A Wallet Profile in Three Calls](https://dash-docs.nomos.trade/recipes/wallet-profile.md): Lifetime figures, the open book and the PnL line for any wallet. - [Holders](https://dash-docs.nomos.trade/api-reference/markets/holders.md): The largest holders of each outcome, with the exact count of holders. Wallets holding shares only, largest first. - [Holder Count](https://dash-docs.nomos.trade/api-reference/markets/holder-count.md): Exact holders per outcome, and unique holders across outcomes (a wallet holding both sides counts once). Cheap: use it for badges. - [Top Traders](https://dash-docs.nomos.trade/api-reference/markets/top-traders.md): The market's best traders by PnL: one row per wallet and outcome, closed positions included. Unresolved, rows rank by realized PnL, then by the open position at your `marks`. Resolved, by realized plus the payout of what is still held. - [Holder Lines](https://dash-docs.nomos.trade/api-reference/markets/holder-lines.md): For each outcome, two groups to draw on a price chart: the top holders among wallets that bought on the book (split-only market makers left out) and the top traders, each with their share-weighted average entry, buy and sell. - [Traders](https://dash-docs.nomos.trade/api-reference/markets/traders.md): Every trader of the market folded to one row per wallet, sorted by total or realized PnL. Here `marks` are prices **by outcome index**, unlike Top Traders. - [Trade Counts](https://dash-docs.nomos.trade/api-reference/markets/trade-counts.md): How many trades (fills) each wallet made in the market over its whole life, and when it was last active there. Every wallet you ask for is answered, 0 when it never traded. - [Market Trades](https://dash-docs.nomos.trade/api-reference/markets/market-trades.md): Every trade in the market, newest first. Each match appears as the taker's fill and one fill per maker order. Page with `next`. - [Market Activity](https://dash-docs.nomos.trade/api-reference/markets/market-activity.md): Splits, merges, redemptions and neg-risk conversions in the market, newest first, for everyone or for a few wallets. A combo's market answers 404 (its fills are on Market Trades). This route has no `block`; use `completeThroughTs`. - [Summary](https://dash-docs.nomos.trade/api-reference/wallets/summary.md): The wallet's lifetime in one call: settled PnL, volume, fees, markets won and lost, best and worst market, and its open legs for you to value (an open combo is worth its cost). - [Positions](https://dash-docs.nomos.trade/api-reference/wallets/positions.md): Two forms on one route. - [Closed Positions](https://dash-docs.nomos.trade/api-reference/wallets/closed-positions.md): Positions the wallet has left: sold, merged, redeemed, or held into a resolution. `reason` is resolved_win or resolved_loss when held into the resolution, sold_win or sold_loss when it left before. - [Wallet Trades](https://dash-docs.nomos.trade/api-reference/wallets/wallet-trades.md): Every trade the wallet made across all markets, newest first, each with its market. Or one market's, with `market`. Or a search over its whole history, with `q`: one answer, newest first, `before` and `market` ignored. - [Wallet Activity](https://dash-docs.nomos.trade/api-reference/wallets/wallet-activity.md): The wallet's splits, merges, redemptions and conversions across every market, newest first, from `coveredFrom`. With its trades, that is its whole on-chain history. - [Wallet Stats](https://dash-docs.nomos.trade/api-reference/wallets/wallet-stats.md): The wallet's leaderboard row over any window. The lifetime is its board row; a window counts each market in full when it was decided (resolved or exited) inside the window. The open book is included only when the window ends now. - [Wallet Categories](https://dash-docs.nomos.trade/api-reference/wallets/wallet-categories.md): One board row per category the wallet traded in the window, biggest realized PnL first. Other is markets in none of the nine. - [PnL Series](https://dash-docs.nomos.trade/api-reference/wallets/pnl-series.md): Cumulative settled PnL through the window, from 0, for a PnL chart. Buckets are 1 h (1d, 7d), 4 h (30d) or a day beyond; a custom window gets at most 400 points. The last point adds today's open book when the window ends now. - [Daily PnL](https://dash-docs.nomos.trade/api-reference/wallets/daily-pnl.md): Settled PnL per calendar day in your time zone: a PnL calendar. Each market lands on the local date it was decided. Over the whole life the days add up to the board's realized PnL. Days with no change are left out. - [First Seen](https://dash-docs.nomos.trade/api-reference/wallets/first-seen.md): When each wallet first touched Polymarket (its earliest fill, split, merge, conversion or transfer): how to spot fresh wallets. - [Profiles](https://dash-docs.nomos.trade/api-reference/wallets/profiles.md): Polymarket names and avatars for up to 300 wallets. Codex looks traders up as they trade, so nearly every active wallet is known; a wallet it has never looked up is left out of the answer. null means the wallet has no profile. - [Wallet Tags](https://dash-docs.nomos.trade/api-reference/wallets/wallet-tags.md): Wallets that trade like programs, from the latest daily run over the last 7 days: high-frequency, market makers, Up/Down round bots, arbitrage and copy traders. The whole run in one answer; send its `ETag` back as `If-None-Match` for a 304 until the next run. - [Board](https://dash-docs.nomos.trade/api-reference/leaderboard/board.md): A page of the board, best first: every wallet that ever traded on Polymarket, lifetime. Win rate and profit factor rank only wallets with 10 or more decided markets. Page with `cursor`. - [Wallets on the Board](https://dash-docs.nomos.trade/api-reference/leaderboard/wallets-on-the-board.md): The board rows of the wallets you name, in your order: a watchlist. Wallets with no row in that category are left out. - [Event Heat](https://dash-docs.nomos.trade/api-reference/events/event-heat.md): Unique traders per Polymarket event over the last hour, 6 hours or 24 hours, busiest first: distinct wallets that traded any of the event's markets (never a sum over markets). Measured once a minute. Recurring series (crypto Up/Down rounds) are included. - [Fills by Market](https://dash-docs.nomos.trade/api-reference/fills/fills-by-market.md): Every fill of up to 100 markets in a window of up to 7 days, oldest first, as integer rows: `[market, ts, block, logIndex, outcome, side, shares, usd, exchange, isTaker, fee]`. `market` is the place in your `markets` list; side 0 is buy; shares and usd in micro-units (divide by 1,000,000); fee in mi… - [All Fills](https://dash-docs.nomos.trade/api-reference/fills/all-fills.md): Every order-book fill of every market in a window of up to an hour, oldest first, rows whose market is still unknown included: `[ts, block, logIndex, tx, wallet, side, asset, conditionId, outcome, shares, usd]`. Rows without a market always come after `completeThroughTs`: read them again later. - [Fills State](https://dash-docs.nomos.trade/api-reference/fills/fills-state.md): How far the fills table is complete, from one cheap query. Poll it to know when a window is final. - [Strike Round](https://dash-docs.nomos.trade/api-reference/crypto-strikes/strike-round.md): The price to beat of one of Polymarket's crypto Up/Down rounds (BTC, ETH, SOL, XRP, DOGE, BNB, HYPE, ZEC), by its slug or by asset, timeframe and start. `strike` is set once the round is confirmed or settled. - [Market Changes](https://dash-docs.nomos.trade/streams/market-changes.md): Server-Sent Events: the markets whose positions changed in each finalized batch, and crypto strike updates. - [Live Tape](https://dash-docs.nomos.trade/streams/live-tape.md): Server-Sent Events: every fill at the chain head, one event per block, about a second after the block. - [Health](https://dash-docs.nomos.trade/api-reference/health/health.md): Whether Codex is keeping up with the chain: 200 when within 100 blocks of the finalized head and committed in the last minute, 503 with the same body when not. ## OpenAPI Specs - [openapi](/openapi.json) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.