Skip to main content

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.

Known issue (resolves Monday, May 4, 2026): Polymarket wallet provisioning is currently failing for newly created accounts and users. Existing accounts and their wallets are unaffected and continue to trade normally. Predict, Opinion, and Limitless are unaffected.
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

SurfaceBase URLPurpose
Trading APIhttps://trade.predexon.comPlace orders, manage accounts, funds, fees
Data APIhttps://api.predexon.comMarket 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.
PathIdentifierStatus
/api/accounts/{accountId}accountIdRecommended. Normalized request/response shapes, supports all three venues, explicit per-venue enablement.
/api/users/{userId}userIdLegacy. Auto-provisions Polymarket + Predict wallets at create time. Flat request/response shapes. Continues to work unchanged.
On the accounts path, identify markets with a 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 the x-api-key header:
curl -X POST \
  -H "x-api-key: YOUR_API_KEY" \
  https://trade.predexon.com/api/accounts/create
Each API key can create multiple accounts. Accounts are owned by the API key that created them — you can only access your own.

Error Handling

All errors return a JSON body with an error field:
{ "error": "Insufficient balance" }
StatusDescriptionAction
400Bad request — invalid parameters or insufficient fundsFix the request and retry
401Unauthorized — missing or invalid API keyCheck your x-api-key header
403Forbidden — account not owned by this API keyVerify the account belongs to your key
404Not found — account or resource doesn’t existCheck the ID
409Conflict — concurrent modification (fee policy)Retry the request
5xxInternal server errorRetry with exponential backoff
Retry 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