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.
Get your free API key at dashboard.predexon.com to start trading programmatically.
Overview
Predexon Trading API provides an interface for trading on prediction markets. Accounts don’t manage their own wallets — the API handles wallet creation, key management, and transaction signing on their behalf.Base URLs
| Surface | Base URL | Purpose |
|---|---|---|
| Trading API | https://trade.predexon.com | Place orders, manage accounts, funds, fees |
| Data API | https://api.predexon.com | Market data, prices, trading history (see Data API docs) |
Supported Venues
Polymarket
Polygon blockchain. Collateral: USDC.e. Limit and market orders.
Predict.fun
BNB Smart Chain. Collateral: USDT (BEP-20). Limit and market orders.
Opinion
BNB Smart Chain. Collateral: USDT. Limit and market orders.
Limitless
Base. Collateral: USDC. Limit and market orders.
Two API paths
There are two parallel path prefixes. New integrations should use/api/accounts.
| Path | Identifier | Status |
|---|---|---|
/api/accounts/{accountId} | accountId | Recommended. Normalized request/response shapes, supports all three venues, explicit per-venue enablement. |
/api/users/{userId} | userId | Legacy. Auto-provisions Polymarket + Predict wallets at create time. Flat request/response shapes. Continues to work unchanged. |
market bag (tokenId, marketId, ticker, outcome). Required fields differ by venue — see Place Order for the per-venue matrix.
Authentication
All requests require an API key passed via thex-api-key header:
Error Handling
All errors return a JSON body with anerror field:
| Status | Description | Action |
|---|---|---|
| 400 | Bad request — invalid parameters or insufficient funds | Fix the request and retry |
| 401 | Unauthorized — missing or invalid API key | Check your x-api-key header |
| 403 | Forbidden — account not owned by this API key | Verify the account belongs to your key |
| 404 | Not found — account or resource doesn’t exist | Check the ID |
| 409 | Conflict — concurrent modification (fee policy) | Retry the request |
| 5xx | Internal server error | Retry with exponential backoff |
5xx errors with exponential backoff. Do not retry 4xx errors — they indicate a problem with the request.
Next Steps
Quickstart
Place your first trade in 5 minutes
How It Works
Understand wallet management and order execution
Funding & Withdrawals
Deposit and withdraw funds
Placing Trades
Order types, venues, and the full trading workflow
