> ## Documentation Index
> Fetch the complete documentation index at: https://docs.predexon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# All Endpoints

> Complete directory of every Predexon API endpoint - Data API market data plus the Trading API accounts surface

<Info>
  **Base URLs**

  * **Data API:** `https://api.predexon.com`
  * **Trading API:** `https://trade.predexon.com`

  All endpoints authenticate via the `x-api-key` header. [Get your API key →](https://dashboard.predexon.com)
</Info>

***

## Data API - 58 Endpoints

<Tabs>
  <Tab title="Polymarket">
    ### Markets & Pricing

    | Method | Endpoint                                                                                       | Description                                                              |
    | ------ | ---------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
    | `GET`  | [`/v2/polymarket/markets/keyset`](/api-reference/markets/list-markets)                         | **List markets** - search, filter, sort with cursor pagination           |
    | `GET`  | [`/v2/polymarket/events/keyset`](/api-reference/markets/events)                                | **List events** - top-level event groupings with cursor pagination       |
    | `GET`  | [`/v2/polymarket/crypto-updown`](/api-reference/markets/crypto-updown)                         | **Crypto up/down** - BTC, ETH, SOL, XRP, HYPE, DOGE, BNB across 5m–daily |
    | `GET`  | [`/v2/polymarket/market-price/{token_id}`](/api-reference/markets/market-price)                | **Market price** - current or historical                                 |
    | `GET`  | [`/v2/polymarket/candlesticks/{condition_id}`](/api-reference/markets/candlesticks)            | **Candlesticks** - OHLCV at 1m/1h/1d intervals, normalized to YES side   |
    | `GET`  | [`/v2/polymarket/candlesticks/token/{token_id}`](/api-reference/markets/candlesticks-by-token) | **Candlesticks by token** - per-token OHLCV with un-normalized NO prices |
    | `GET`  | [`/v2/polymarket/markets/{token_id}/volume`](/api-reference/markets/volume)                    | **Volume time series** - cumulative by buy/sell                          |
    | `GET`  | [`/v2/polymarket/volume-chart/{condition_id}`](/api-reference/markets/volume-chart)            | **Volume chart** - per-period with YES/NO breakdown                      |
    | `GET`  | [`/v2/polymarket/markets/{condition_id}/open_interest`](/api-reference/markets/open-interest)  | **Open interest** - historical OI tracking                               |
    | `GET`  | [`/v2/polymarket/orderbooks`](/api-reference/markets/orderbooks)                               | **Orderbooks** - historical snapshots at ms resolution                   |

    ### Discovery & Taxonomy

    | Method | Endpoint                                                                    | Description                                                          |
    | ------ | --------------------------------------------------------------------------- | -------------------------------------------------------------------- |
    | `GET`  | [`/v2/polymarket/search`](/api-reference/discovery/search)                  | **Unified search** - markets, events, and tags in one query          |
    | `GET`  | [`/v2/polymarket/categories`](/api-reference/discovery/categories)          | **Categories** - top-level categories with counts + active volume/OI |
    | `GET`  | [`/v2/polymarket/tags`](/api-reference/discovery/tags)                      | **Tags** - curated tags with rolled-up volume/OI metrics             |
    | `GET`  | [`/v2/polymarket/tag/{slug}`](/api-reference/discovery/tag)                 | **Tag detail** - metadata + metrics for one tag                      |
    | `GET`  | [`/v2/polymarket/tag/{slug}/subtags`](/api-reference/discovery/tag-subtags) | **Tag subtags** - ranked child subtags with event counts             |
    | `GET`  | [`/v2/polymarket/series`](/api-reference/discovery/series)                  | **Series** - recurring market groupings (daily/weekly/monthly)       |
    | `GET`  | [`/v2/polymarket/series/{slug}`](/api-reference/discovery/series-detail)    | **Series detail** - one series plus its events (keyset)              |

    ### Trades & Activity

    | Method | Endpoint                                                       | Description                                   |
    | ------ | -------------------------------------------------------------- | --------------------------------------------- |
    | `GET`  | [`/v2/polymarket/trades`](/api-reference/trading/trades)       | **Trades** - by market, token, or wallet      |
    | `GET`  | [`/v2/polymarket/activity`](/api-reference/trading/activity)   | **Activity** - splits, merges, redeems        |
    | `GET`  | [`/v2/polymarket/positions`](/api-reference/trading/positions) | **Positions** - cross-wallet position scanner |

    ### Wallet Analytics

    | Method | Endpoint                                                                            | Description                                                               |
    | ------ | ----------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
    | `GET`  | [`/v2/polymarket/wallet/{wallet}`](/api-reference/wallet/wallet-profile)            | **Profile** - full metrics across all time windows                        |
    | `GET`  | [`/v2/polymarket/wallets/profiles`](/api-reference/wallet/wallet-profiles-batch)    | **Batch profiles** - up to 20 wallets at once                             |
    | `GET`  | [`/v2/polymarket/wallet/positions/{wallet}`](/api-reference/wallet/positions)       | **Positions** - open + historical with P\&L                               |
    | `GET`  | [`/v2/polymarket/wallet/pnl/{wallet}`](/api-reference/wallet/pnl)                   | **P\&L** - realized, unrealized, total                                    |
    | `GET`  | [`/v2/polymarket/wallet/{wallet}/markets`](/api-reference/wallet/wallet-markets)    | **Market breakdown** - per-market performance                             |
    | `GET`  | [`/v2/polymarket/wallet/{wallet}/similar`](/api-reference/wallet/similar-wallets)   | **Similar wallets** - portfolio overlap detection                         |
    | `GET`  | [`/v2/polymarket/wallet/volume-chart/{wallet}`](/api-reference/wallet/volume-chart) | **Volume chart** - BUY/SELL breakdown                                     |
    | `GET`  | [`/v2/polymarket/wallet/identity/{wallet}`](/api-reference/wallet/identity)         | **Identity** - display name, X handle, badges, wallet type, USDC balance  |
    | `POST` | [`/v2/polymarket/wallet/identities`](/api-reference/wallet/identities-batch)        | **Identities (batch)** - up to 200 addresses, proxy or signer EOA         |
    | `GET`  | [`/v2/polymarket/wallet/{address}/cluster`](/api-reference/wallet/cluster)          | **Connected wallets** - on-chain transfer graph + identity-proof clusters |

    ### Smart Money & Analytics

    <Note>Requires **Dev** plan or higher.</Note>

    | Method | Endpoint                                                                                            | Description                                             |
    | ------ | --------------------------------------------------------------------------------------------------- | ------------------------------------------------------- |
    | `GET`  | [`/v2/polymarket/markets/smart-activity`](/api-reference/smart-money/smart-activity)                | **Smart activity** - markets where top wallets trade    |
    | `GET`  | [`/v2/polymarket/market/{condition_id}/smart-money`](/api-reference/smart-money/smart-money-market) | **Smart money** - net positioning for a market          |
    | `GET`  | [`/v2/polymarket/leaderboard`](/api-reference/analytics/leaderboard)                                | **Leaderboard** - global wallet rankings                |
    | `GET`  | [`/v2/polymarket/leaderboard/market/{condition_id}`](/api-reference/analytics/market-leaderboard)   | **Market leaderboard** - per-market rankings            |
    | `GET`  | [`/v2/polymarket/market/{condition_id}/top-holders`](/api-reference/analytics/top-holders)          | **Top holders** - largest positions                     |
    | `GET`  | [`/v2/polymarket/position/{token_id}/top-holders`](/api-reference/analytics/position-top-holders)   | **Position top holders** - largest holders of one token |
    | `GET`  | [`/v2/polymarket/wallets/filter`](/api-reference/analytics/filter-wallets)                          | **Filter wallets** - by market + performance            |
    | `GET`  | [`/v2/polymarket/cohorts/stats`](/api-reference/analytics/cohort-stats)                             | **Cohort stats** - aggregate by trading style           |

    ### UMA

    | Method | Endpoint                                                                    | Description                                                                |
    | ------ | --------------------------------------------------------------------------- | -------------------------------------------------------------------------- |
    | `GET`  | [`/v2/polymarket/uma/markets`](/api-reference/uma/list-markets)             | **List UMA markets** - non-sports UMA questions, sorted by `last_event_at` |
    | `GET`  | [`/v2/polymarket/uma/market/{condition_id}`](/api-reference/uma/get-market) | **Get UMA market** - current oracle status + event timeline                |

    ### Builders

    <Note>**V2-only.** Builder attribution excludes V1 fills and the zero-sentinel builder.</Note>

    | Method | Endpoint                                                                                          | Description                                                                        |
    | ------ | ------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
    | `GET`  | [`/v2/polymarket/builders/leaderboard`](/api-reference/builders/leaderboard)                      | **Builder leaderboard** - V2 builders ranked by volume or fee revenue              |
    | `GET`  | [`/v2/polymarket/builders/{builder_code}`](/api-reference/builders/builder-stats)                 | **Builder stats** - single-builder summary + full `(taker_bps, maker_bps)` history |
    | `GET`  | [`/v2/polymarket/builders/{builder_code}/markets`](/api-reference/builders/builder-markets)       | **Builder markets** - top markets attributed to a builder over a rolling window    |
    | `GET`  | [`/v2/polymarket/builders/{builder_code}/timeseries`](/api-reference/builders/builder-timeseries) | **Builder timeseries** - bucketed volume + fee revenue over a rolling window       |
    | `GET`  | [`/v2/polymarket/builders/wallet/{wallet}`](/api-reference/builders/wallet-builder-fees)          | **Wallet builder fees** - total builder fees a wallet paid, per-builder breakdown  |
  </Tab>

  <Tab title="Kalshi">
    | Method | Endpoint                                                    | Description                                                     |
    | ------ | ----------------------------------------------------------- | --------------------------------------------------------------- |
    | `GET`  | [`/v2/kalshi/markets`](/api-reference/kalshi/list-markets)  | **List markets** - filter by ticker, event, status, price range |
    | `GET`  | [`/v2/kalshi/trades`](/api-reference/kalshi/trades)         | **Trades** - historical with taker side                         |
    | `GET`  | [`/v2/kalshi/orderbooks`](/api-reference/kalshi/orderbooks) | **Orderbooks** - historical snapshots, prices in cents          |
  </Tab>

  <Tab title="Binance">
    <Note>Requires **Dev** plan or higher.</Note>

    | Method | Endpoint                                                         | Description                                            |
    | ------ | ---------------------------------------------------------------- | ------------------------------------------------------ |
    | `GET`  | [`/v2/binance/ticks/{symbol}`](/api-reference/binance/ticks)     | **Ticks** - raw book ticker at microsecond granularity |
    | `GET`  | [`/v2/binance/candles/{symbol}`](/api-reference/binance/candles) | **Candles** - OHLCV from 1s to 1d intervals            |
  </Tab>

  <Tab title="Other Platforms">
    ### Limitless

    | Method | Endpoint                                                          | Description                           |
    | ------ | ----------------------------------------------------------------- | ------------------------------------- |
    | `GET`  | [`/v2/limitless/markets`](/api-reference/limitless/markets)       | **Markets** - with trade type filter  |
    | `GET`  | [`/v2/limitless/orderbooks`](/api-reference/limitless/orderbooks) | **Orderbooks** - historical snapshots |

    ### Opinion

    | Method | Endpoint                                                      | Description                           |
    | ------ | ------------------------------------------------------------- | ------------------------------------- |
    | `GET`  | [`/v2/opinion/markets`](/api-reference/opinion/markets)       | **Markets** - with event grouping     |
    | `GET`  | [`/v2/opinion/orderbooks`](/api-reference/opinion/orderbooks) | **Orderbooks** - historical snapshots |

    ### Predict.Fun

    | Method | Endpoint                                                            | Description                           |
    | ------ | ------------------------------------------------------------------- | ------------------------------------- |
    | `GET`  | [`/v2/predictfun/markets`](/api-reference/predictfun/markets)       | **Markets** - with event grouping     |
    | `GET`  | [`/v2/predictfun/orderbooks`](/api-reference/predictfun/orderbooks) | **Orderbooks** - historical snapshots |
  </Tab>

  <Tab title="Cross-Platform">
    <Note>Requires **Dev** plan or higher.</Note>

    ### Canonical Markets

    | Method | Endpoint                                                         | Description                                                                             |
    | ------ | ---------------------------------------------------------------- | --------------------------------------------------------------------------------------- |
    | `GET`  | [`/v2/markets`](/api-reference/canonical/markets)                | **Canonical markets** - cross-venue market containers with outcome-level `predexon_id`s |
    | `GET`  | [`/v2/markets/listings`](/api-reference/canonical/listings)      | **Canonical listings** - flattened venue-native executable metadata                     |
    | `GET`  | [`/v2/outcomes/{predexon_id}`](/api-reference/canonical/outcome) | **Canonical outcome** - all venue listings mapped to one `predexon_id`                  |

    ### Matching

    | Method | Endpoint                                                              | Description                                                                               |
    | ------ | --------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
    | `GET`  | [`/v2/markets/search`](/api-reference/matching/search)                | **Search markets** - cross-venue text search across all 5 venues, round-robin interleaved |
    | `GET`  | [`/v2/matching-markets`](/api-reference/matching/find-matches)        | **Find matches** - get equivalent markets across platforms                                |
    | `GET`  | [`/v2/matching-markets/pairs`](/api-reference/matching/matched-pairs) | **Matched pairs** - all active exact matches                                              |
  </Tab>
</Tabs>

***

## Trading API

<Info>
  **Base URL:** `https://trade.predexon.com`

  Endpoints below use the **accounts path** (`/api/accounts`) — the canonical surface for all trading.
</Info>

<Tabs>
  <Tab title="Accounts">
    | Method   | Endpoint                                                                 | Description                                         |
    | -------- | ------------------------------------------------------------------------ | --------------------------------------------------- |
    | `POST`   | [`/api/accounts/create`](/trading-api/accounts/create-account)           | **Create account** - empty, no venues enabled       |
    | `GET`    | [`/api/accounts`](/trading-api/accounts/list-accounts)                   | **List accounts** - owned by this API key           |
    | `GET`    | [`/api/accounts/{accountId}`](/trading-api/accounts/get-account)         | **Get account** - profile + per-venue entitlements  |
    | `DELETE` | [`/api/accounts/{accountId}`](/trading-api/accounts/delete-account)      | **Delete account** - cascades cleanup across venues |
    | `POST`   | [`/api/accounts/{accountId}/enable`](/trading-api/accounts/enable-venue) | **Enable venue** - provision wallet, gas, approvals |
  </Tab>

  <Tab title="Orders">
    | Method   | Endpoint                                                                           | Description                                                                    |
    | -------- | ---------------------------------------------------------------------------------- | ------------------------------------------------------------------------------ |
    | `POST`   | [`/api/accounts/{accountId}/orders`](/trading-api/accounts/place-order)            | **Place order** - Polymarket, Predict, Opinion, Limitless, or Hyperliquid      |
    | `GET`    | [`/api/accounts/{accountId}/orders`](/trading-api/accounts/get-orders)             | **List orders** - optional `?venue=` filter, `?aggregated=true` to strip venue |
    | `GET`    | [`/api/accounts/{accountId}/orders/{orderId}`](/trading-api/accounts/get-order)    | **Get order** - by ID                                                          |
    | `DELETE` | [`/api/accounts/{accountId}/orders/{orderId}`](/trading-api/accounts/cancel-order) | **Cancel order**                                                               |
    | `DELETE` | [`/api/accounts/{accountId}/orders`](/trading-api/accounts/cancel-all-orders)      | **Cancel all** - optional `?venue=` scope                                      |
  </Tab>

  <Tab title="Positions">
    | Method | Endpoint                                                                     | Description                                                             |
    | ------ | ---------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
    | `GET`  | [`/api/accounts/{accountId}/balance`](/trading-api/accounts/get-balance)     | **Balance** - optional `?aggregated=true` for single USD-equivalent row |
    | `GET`  | [`/api/accounts/{accountId}/positions`](/trading-api/accounts/get-positions) | **Positions** - optional `?aggregated=true` to collapse across venues   |
    | `POST` | [`/api/accounts/{accountId}/redeem`](/trading-api/accounts/redeem-position)  | **Redeem** - single-venue, by `market` bag                              |
  </Tab>

  <Tab title="Transfers">
    | Method | Endpoint                                                                              | Description                                                       |
    | ------ | ------------------------------------------------------------------------------------- | ----------------------------------------------------------------- |
    | `GET`  | [`/api/accounts/{accountId}/deposit-info`](/trading-api/funds/deposit-info)           | **Deposit wallet** - Base USDC address + live balance             |
    | `POST` | [`/api/accounts/{accountId}/transfers`](/trading-api/funds/create-transfer)           | **Create transfer** - one verb for fund / drain / withdraw        |
    | `GET`  | [`/api/accounts/{accountId}/transfers`](/trading-api/funds/list-transfers)            | **List transfers** - all directions, paginated                    |
    | `GET`  | [`/api/accounts/{accountId}/transfers/{transferId}`](/trading-api/funds/get-transfer) | **Get transfer** - poll cross-token transfers until terminal      |
    | `POST` | [`/api/accounts/{accountId}/transfers/quote`](/trading-api/funds/quote-transfer)      | **Quote transfer** - preview cost; signed tx for inbound deposits |
    | `POST` | [`/api/accounts/{accountId}/withdraw`](/trading-api/accounts/withdraw)                | **Per-venue withdraw** - used for Hyperliquid                     |
  </Tab>

  <Tab title="Fees">
    | Method   | Endpoint                                                   | Description                                   |
    | -------- | ---------------------------------------------------------- | --------------------------------------------- |
    | `GET`    | [`/api/fees/policy`](/trading-api/fees/get-fee-policy)     | **Get fee policy** - Polymarket only          |
    | `PUT`    | [`/api/fees/policy`](/trading-api/fees/set-fee-policy)     | **Set fee policy** - configure partner markup |
    | `DELETE` | [`/api/fees/policy`](/trading-api/fees/remove-partner-fee) | **Remove partner fee**                        |
  </Tab>
</Tabs>

***

## Access Tiers

<CardGroup cols={2}>
  <Card title="Free - 16 endpoints" icon="unlock">
    All Polymarket market data plus Kalshi markets, trades, and orderbooks. No credit card required.
  </Card>

  <Card title="Dev & Pro - 21 additional" icon="lock">
    Cross-platform matching, wallet analytics, smart money, leaderboards, Binance data, and WebSocket streaming.
  </Card>
</CardGroup>

See [pricing](https://predexon.com/pricing) for full details, or [get a free API key](https://dashboard.predexon.com) to start.
