# 0xinsider API

- [0xinsider API](https://docs.0xinsider.com/index.md): Build with Polymarket wallet grades, market activity, daily picks, and large-trade data.
- [Start without a key](https://docs.0xinsider.com/sandbox.md): Try the API with sample data, exercise errors and pagination, then switch to live data.
- [Quickstart](https://docs.0xinsider.com/quickstart.md): Try a sample request, get an API key, and read a live trader profile and market activity.
- [Authentication](https://docs.0xinsider.com/authentication.md): Create a key, send it in the Authorization header, and choose the right scopes.
- [Rate limits](https://docs.0xinsider.com/rate-limits.md): Read your request allowances and handle rate limits without repeated polling.
- [Errors](https://docs.0xinsider.com/errors.md): Read API errors, fix invalid requests, and retry only when the response says to.
- [Python client](https://docs.0xinsider.com/integrations/python-client.md): Call the 0xinsider API from Python with typed methods, error handling, pagination, and a keyless sandbox.
- [Go client](https://docs.0xinsider.com/integrations/go-client.md): Call the 0xinsider API from Go with typed responses, request deadlines, and a keyless sandbox.
- [TypeScript client](https://docs.0xinsider.com/integrations/typescript-client.md): Call the 0xinsider API with typed responses, pagination, stream recovery, and webhook verification.
- [Rust client](https://docs.0xinsider.com/integrations/rust-client.md): Call the 0xinsider API from Rust with typed async responses, bounded retries, and a keyless sandbox.
- [CLI](https://docs.0xinsider.com/integrations/cli.md): Read 0xinsider data as JSON from your terminal with a sign-in or an API key.
- [MCP server](https://docs.0xinsider.com/integrations/mcp.md): Give an AI client read-only access to 0xinsider data through a local or hosted MCP server.
- [Webhooks](https://docs.0xinsider.com/guides/webhooks.md): Receive event notifications on your server, verify their signatures, and recover failed deliveries.
- [Auto-buy the Pick of the Day](https://docs.0xinsider.com/guides/auto-buy-the-pick.md): Set up potd-trader, check a dry run, and choose when it can buy picks on your Polymarket account.
- [Wallet grades](https://docs.0xinsider.com/concepts/grades.md): Understand wallet grades, what changes them, and how to filter by grade.
- [Scores](https://docs.0xinsider.com/concepts/signal-scoring.md): Choose the score that matches your question about a wallet, a trade, or a market.
- [Risk and performance metrics](https://docs.0xinsider.com/concepts/quant-metrics.md): Compare wallet performance, risk, and copyability with quant_metrics.
- [Wallet trading styles](https://docs.0xinsider.com/concepts/strategy-types.md): Read observable trading patterns, check their limits, and filter wallets by style.
- [Polymarket coverage](https://docs.0xinsider.com/concepts/platforms.md): Check supported API features and understand the platform fields and filters.
- [Data sources and freshness](https://docs.0xinsider.com/concepts/trust-metadata.md): Check where a value came from, when it was updated, and whether it is complete.
- [Pagination](https://docs.0xinsider.com/concepts/pagination.md): Read list results page by page and restart safely when a cursor expires.
- [Numbers and missing values](https://docs.0xinsider.com/concepts/number-formatting.md): Use display numbers, exact decimal values, and missing fields correctly.
- [Optional fields](https://docs.0xinsider.com/concepts/expand.md): Request extra trader details, price sources, or full trades with the expand parameter.
- [API reference](https://docs.0xinsider.com/api-reference/introduction.md): Learn how to authenticate, read responses, use IDs, and handle limits across the API.
- [Objects](https://docs.0xinsider.com/api-reference/objects.md): Look up response objects, field types, and which fields can be missing or null.
- [API discovery](https://docs.0xinsider.com/api-reference/endpoint/get-api-discovery.md): Get the API routes and the URLs for its OpenAPI document and documentation.
- [Register an agent](https://docs.0xinsider.com/api-reference/endpoint/register-agent.md): Create a sandbox key and get the URLs for example data and live access.
- [Coverage](https://docs.0xinsider.com/api-reference/endpoint/get-coverage.md): Check which Polymarket data the API supports without an API key.
- [Platforms (deprecated)](https://docs.0xinsider.com/api-reference/endpoint/get-platforms.md): Read the deprecated alias of coverage with the same parameters and data.
- [OpenAPI spec](https://docs.0xinsider.com/api-reference/endpoint/redirect-api-openapi-spec.md): Get a redirect to the canonical OpenAPI document without an API key.
- [Trader](https://docs.0xinsider.com/api-reference/endpoint/get-trader.md): Get a wallet's grade, profit and loss, win rate, and rank, with optional detail.
- [Trader context](https://docs.0xinsider.com/api-reference/endpoint/get-trader-context.md): Get a wallet profile and position summary together, with timestamps for their data.
- [Trader context as Markdown](https://docs.0xinsider.com/api-reference/endpoint/get-trader-context-markdown.md): Read a wallet profile and position summary as a Markdown brief.
- [Trader category records](https://docs.0xinsider.com/api-reference/endpoint/get-trader-category-records.md): Get a wallet's settled win and loss counts by category and esports game.
- [Trader grade at a past time](https://docs.0xinsider.com/api-reference/endpoint/get-trader-grade-at.md): Get the wallet grade that was confirmed visible at a past decision time.
- [Batch traders](https://docs.0xinsider.com/api-reference/endpoint/batch-get-traders.md): Get up to 25 wallet profiles in one request, with a result for each requested wallet.
- [Trader P&L](https://docs.0xinsider.com/api-reference/endpoint/get-trader-pnl.md): Get a wallet's daily profit and loss history, period statistics, and drawdowns.
- [Position timeline](https://docs.0xinsider.com/api-reference/endpoint/get-position-timeline.md): Get a wallet's recorded fills in one market, with running share and entry-price calculations.
- [Position timeline by trader](https://docs.0xinsider.com/api-reference/endpoint/get-trader-position-timeline.md): Get a wallet's recorded fills in one market through the alternative timeline path.
- [Large positions](https://docs.0xinsider.com/api-reference/endpoint/list-large-positions.md): Find positions worth at least $50,000 with detected activity in the last 24 hours.
- [Trader export snapshot](https://docs.0xinsider.com/api-reference/endpoint/get-trader-export-snapshot.md): Check a trader export's date range, coverage, estimated size, and limits before submitting it.
- [Submit a whale dataset](https://docs.0xinsider.com/api-reference/endpoint/submit-whale-dataset.md): Export recorded large trades across markets for a fixed time range.
- [Read a whale dataset job](https://docs.0xinsider.com/api-reference/endpoint/get-whale-dataset-status.md): Check a dataset export's progress and get its manifest when ready.
- [Download a whale dataset](https://docs.0xinsider.com/api-reference/endpoint/download-whale-dataset.md): Get a temporary download link for a completed dataset export.
- [Cancel a whale dataset job](https://docs.0xinsider.com/api-reference/endpoint/cancel-whale-dataset.md): Cancel a queued dataset export or ask a running export to stop.
- [Submit a trader export](https://docs.0xinsider.com/api-reference/endpoint/submit-trader-export.md): Create a trader export job in JSON, NDJSON, or CSV format.
- [Trader export status](https://docs.0xinsider.com/api-reference/endpoint/get-trader-export-status.md): Check a trader export's state, progress, and next action.
- [Download a trader export](https://docs.0xinsider.com/api-reference/endpoint/download-trader-export.md): Get a temporary download link for a completed trader export.
- [Cancel a trader export](https://docs.0xinsider.com/api-reference/endpoint/cancel-trader-export.md): Cancel a queued trader export or ask a running export to stop.
- [Leaderboard](https://docs.0xinsider.com/api-reference/endpoint/get-leaderboard.md): Find S, A, and B wallets ranked by score, with category and strategy filters.
- [Trending wallets](https://docs.0xinsider.com/api-reference/endpoint/list-trending-wallets.md): Find wallets on Polymarket's weekly or monthly P&L leaderboard.
- [Positions](https://docs.0xinsider.com/api-reference/endpoint/get-positions.md): List current open positions across markets, or filter them to up to 25 wallets.
- [List games](https://docs.0xinsider.com/api-reference/endpoint/list-games.md): List games with both competitors, kickoff times, status, and linked Polymarket markets.
- [Game](https://docs.0xinsider.com/api-reference/endpoint/get-game.md): Get one game with its competitors, status, and linked Polymarket markets.
- [Search markets](https://docs.0xinsider.com/api-reference/endpoint/search-markets.md): Find Polymarket markets by words in their titles.
- [Explore markets](https://docs.0xinsider.com/api-reference/endpoint/explore-markets.md): Browse Polymarket markets by category, status, or sort order.
- [Sharp money flows](https://docs.0xinsider.com/api-reference/endpoint/sharp-money-flows.md): Find markets ranked by the size of net trade flow from graded wallets.
- [Smart money flows](https://docs.0xinsider.com/api-reference/endpoint/smart-money-flows.md): Read ranked market flows through the deprecated smart-money route.
- [Market flow](https://docs.0xinsider.com/api-reference/endpoint/get-market-flow.md): Get a market's large-trade flow and up to 5 positions held by S, A, and B wallets.
- [Batch market flow](https://docs.0xinsider.com/api-reference/endpoint/batch-get-market-flow.md): Get trade flow for up to 25 Polymarket markets in the order you request them.
- [Market intel (deprecated)](https://docs.0xinsider.com/api-reference/endpoint/get-market-intel.md): Read the deprecated alias of market flow with the same parameters and data.
- [Batch market intel (deprecated)](https://docs.0xinsider.com/api-reference/endpoint/batch-get-market-intel.md): Read the deprecated alias of batch market flow with the same parameters and data.
- [Market snapshot](https://docs.0xinsider.com/api-reference/endpoint/get-market-snapshot.md): Get a market's identity, prices, liquidity, sports context, and freshness information.
- [Market context as Markdown](https://docs.0xinsider.com/api-reference/endpoint/get-market-context-markdown.md): Read a market snapshot as Markdown with source and freshness information.
- [Market holders](https://docs.0xinsider.com/api-reference/endpoint/get-market-holders.md): List S, A, and B wallets holding a market, with their position values and category records.
- [Market candles](https://docs.0xinsider.com/api-reference/endpoint/get-market-candles.md): Get daily or weekly price candles for a Polymarket market.
- [Pre-game sides](https://docs.0xinsider.com/api-reference/endpoint/get-pre-game-sides.md): Find upcoming markets where S, A, and B wallets hold most of their money on one side.
- [Pre-game side observations](https://docs.0xinsider.com/api-reference/endpoint/get-pre-game-side-observations.md): Inspect measured market groups that are excluded from the pre-game sides ranking.
- [Sports edge signals (deprecated)](https://docs.0xinsider.com/api-reference/endpoint/get-sports-edge-signals.md): Read the deprecated alias of pre-game sides with the same parameters and data.
- [Sports edge observations (deprecated)](https://docs.0xinsider.com/api-reference/endpoint/get-sports-edge-observations.md): Read the deprecated alias of pre-game side observations with the same parameters and data.
- [Search content](https://docs.0xinsider.com/api-reference/endpoint/search-content.md): Find 0xinsider articles by a search term.
- [Pick of the Day](https://docs.0xinsider.com/api-reference/endpoint/get-pick-of-the-day.md): Get the current day's published picks, their frozen prices, and modeled $1,000 returns.
- [Pick of the Day archive](https://docs.0xinsider.com/api-reference/endpoint/get-pick-of-the-day-archive.md): Get past picks, their results, and the cumulative record.
- [Pick of the Day ledger](https://docs.0xinsider.com/api-reference/endpoint/get-pick-of-the-day-ledger.md): Read pick commitments and revealed payloads to verify that a settled pick is unchanged.
- [Pick of the Day ledger entry](https://docs.0xinsider.com/api-reference/endpoint/get-pick-of-the-day-ledger-entry.md): Read one pick's commitment, proof state, and revealed payload using its pick ID.
- [Large trades](https://docs.0xinsider.com/api-reference/endpoint/get-large-trades.md): List recent large Polymarket trades with wallet grades and review scores.
- [Large trade](https://docs.0xinsider.com/api-reference/endpoint/get-large-trade.md): Get one large trade and the Polygon order matches and wallets behind it.
- [Large trades history](https://docs.0xinsider.com/api-reference/endpoint/get-large-trades-history.md): Find recorded large trades by time range, market, wallet, or category.
- [Counterparty executions](https://docs.0xinsider.com/api-reference/endpoint/get-large-trade-counterparty-executions.md): Get more order matches for a large trade when its first response contains only a page.
- [Counterparty makers](https://docs.0xinsider.com/api-reference/endpoint/get-large-trade-counterparty-makers.md): Get more maker wallets for one order match of a large trade.
- [Whale trades (deprecated)](https://docs.0xinsider.com/api-reference/endpoint/get-whale-trades.md): Read the deprecated alias of large trades with the same parameters and data.
- [Whale trade (deprecated)](https://docs.0xinsider.com/api-reference/endpoint/get-whale-trade.md): Read the deprecated alias of large trade with the same parameters and data.
- [Whale trades history (deprecated)](https://docs.0xinsider.com/api-reference/endpoint/get-whale-trades-history.md): Read the deprecated alias of large trades history with the same parameters and data.
- [Counterparty executions (deprecated)](https://docs.0xinsider.com/api-reference/endpoint/get-whale-trade-counterparty-executions.md): Read the deprecated alias of counterparty executions with the same parameters and data.
- [Counterparty makers (deprecated)](https://docs.0xinsider.com/api-reference/endpoint/get-whale-trade-counterparty-makers.md): Read the deprecated alias of counterparty makers with the same parameters and data.
- [Suspicious trades](https://docs.0xinsider.com/api-reference/endpoint/get-suspicious-trades.md): List trades flagged for review, ranked by suspicion score.
- [Suspicious trade](https://docs.0xinsider.com/api-reference/endpoint/get-suspicious-trade.md): Get one flagged trade with its stored suspicion score and supporting evidence.
- [Insider Radar](https://docs.0xinsider.com/api-reference/endpoint/get-insider-radar.md): Read the suspicious-trades list through the deprecated Insider Radar route.
- [Insider Radar flag](https://docs.0xinsider.com/api-reference/endpoint/get-insider-radar-flag.md): Read one flagged trade through the deprecated Insider Radar route.
- [Event replay](https://docs.0xinsider.com/api-reference/endpoint/get-event-replay-since.md): Read recorded large-trade events after a saved cursor to recover from an interruption.
- [Stream](https://docs.0xinsider.com/api-reference/endpoint/get-stream.md): Receive live feed events through a Server-Sent Events connection and resume after reconnecting.
- [Account identity](https://docs.0xinsider.com/api-reference/endpoint/get-account-identity.md): Check your credential, account, subscription, and granted scopes.
- [Usage](https://docs.0xinsider.com/api-reference/endpoint/get-usage.md): Check your account's request usage and remaining monthly quota.
- [Webhooks](https://docs.0xinsider.com/api-reference/endpoint/list-webhooks.md): List every webhook endpoint on your account with its status and configuration.
- [Webhook events](https://docs.0xinsider.com/api-reference/endpoint/list-webhook-events.md): List the 16 webhook event types and the payload each one sends.
- [Create a webhook](https://docs.0xinsider.com/api-reference/endpoint/create-webhook.md): Create a webhook endpoint and get the signing secret and token needed to verify it.
- [Webhook](https://docs.0xinsider.com/api-reference/endpoint/get-webhook.md): Get a webhook endpoint's configuration, delivery status, and secret-rotation state.
- [Update a webhook](https://docs.0xinsider.com/api-reference/endpoint/update-webhook.md): Change a webhook's name, URL, subscriptions, or enabled state.
- [Delete a webhook](https://docs.0xinsider.com/api-reference/endpoint/delete-webhook.md): Delete a webhook endpoint, stop its deliveries, and free its URL for reuse.
- [Verify a webhook](https://docs.0xinsider.com/api-reference/endpoint/verify-webhook.md): Activate a webhook after your receiver accepts a signed verification challenge.
- [Start webhook verification](https://docs.0xinsider.com/api-reference/endpoint/create-webhook-verification-attempt.md): Admit a durable signed challenge without waiting for your receiver.
- [Get webhook verification](https://docs.0xinsider.com/api-reference/endpoint/get-webhook-verification-attempt.md): Read the current state and sanitized result of a durable verification attempt.
- [Rotate a webhook secret](https://docs.0xinsider.com/api-reference/endpoint/rotate-webhook-secret.md): Replace a webhook signing secret immediately and return its new value.
- [Prepare a staged webhook secret](https://docs.0xinsider.com/api-reference/endpoint/prepare-webhook-secret.md): Create a new webhook signing secret without changing current deliveries.
- [Activate a staged webhook secret](https://docs.0xinsider.com/api-reference/endpoint/activate-webhook-secret.md): Activate a prepared webhook signing secret with a 1-hour overlap for the previous secret.
- [Retire a staged webhook secret](https://docs.0xinsider.com/api-reference/endpoint/retire-webhook-secret.md): End a webhook's secret overlap after every receiver accepts the new signing secret.
- [Webhook deliveries](https://docs.0xinsider.com/api-reference/endpoint/list-webhook-deliveries.md): Inspect a webhook's deliveries, failures, and scheduled retries.
- [Redeliver a webhook delivery](https://docs.0xinsider.com/api-reference/endpoint/redeliver-webhook-delivery.md): Retry a failed webhook delivery with a new allowance of 8 attempts.
- [Reports](https://docs.0xinsider.com/api-reference/endpoint/get-reports.md): Get a daily, weekly, or monthly summary of recorded large Polymarket trades.
- [Daily report snapshot](https://docs.0xinsider.com/api-reference/endpoint/get-daily-report-snapshot.md): Get a daily summary of recorded large trades, with up to 50 top trades.
- [Weekly report snapshot](https://docs.0xinsider.com/api-reference/endpoint/get-weekly-report-snapshot.md): Get a weekly or custom date-range summary of large trades, with up to 100 top trades.
- [Monthly report snapshot](https://docs.0xinsider.com/api-reference/endpoint/get-monthly-report-snapshot.md): Get a monthly summary of recorded large trades, with up to 200 top trades.
- [Health](https://docs.0xinsider.com/api-reference/endpoint/health.md): Check the API's database, cache, and background-job status without an API key.
- [Remote MCP](https://docs.0xinsider.com/api-reference/endpoint/remote-mcp.md): Call 0xinsider's read-only MCP tools over HTTP from a hosted agent.
- [Remote MCP GET](https://docs.0xinsider.com/api-reference/endpoint/remote-mcp-stream.md): Check the remote MCP GET response, which returns 405 because the server offers no stream.
- [Copy-trade signals](https://docs.0xinsider.com/recipes/copy-trade.md): Build a wallet follow list and identify its recent large trades and Polymarket token IDs.
- [Review suspicious trades](https://docs.0xinsider.com/recipes/insider-scanner.md): Build a review queue from flagged trades, wallet history, market flow, and graded holders.
- [Alert bot](https://docs.0xinsider.com/recipes/alert-bot.md): Send large-trade alerts to Slack and save a checkpoint so the consumer can resume after failure.
- [Review a trader's history](https://docs.0xinsider.com/recipes/backtest.md): Compare a wallet's daily P&L, recorded large trades, and fills in one market.
- [Portfolio tracker](https://docs.0xinsider.com/recipes/portfolio-tracker.md): Read P&L and open positions for a wallet list while keeping missing and stale values visible.
- [API changelog](https://docs.0xinsider.com/changelog.md): Read API, SDK, CLI, MCP, OAuth, and feed changes, with the action each update requires.

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)

## Optional

- [Terminal](https://0xinsider.com)
- [Product changelog](https://0xinsider.com/changelog)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.