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.

This guide uses the accounts path (/api/accounts/*). If you’re on the legacy /api/users/* path, see the legacy endpoints — they still work but won’t be shown here.
Known issue (resolves Monday, May 4, 2026): Polymarket wallet provisioning is currently failing for newly created accounts. Step 2 (Enable Polymarket) will not reach active until the fix lands. Existing accounts are unaffected. Predict, Opinion, and Limitless work normally — you can complete this guide on those venues in the meantime.

​
Prerequisites

Get your free API key at dashboard.predexon.com before starting.

​
Step 1: Create an account

Accounts are created empty — no venues are provisioned automatically.
Python
import requests

HEADERS = {"x-api-key": "YOUR_API_KEY", "Content-Type": "application/json"}
BASE = "https://trade.predexon.com"

account = requests.post(f"{BASE}/api/accounts/create", headers=HEADERS).json()
account_id = account["accountId"]
print(f"Created account: {account_id}")
Save the accountId — you’ll need it for all subsequent calls.

​
Step 2: Enable a venue

Call POST /enable for each venue the account should trade on. Returns status: "provisioning" while the wallet is being set up; poll Get Account until the venue’s status becomes active.
Python
import time

# Enable Polymarket
requests.post(
    f"{BASE}/api/accounts/{account_id}/enable",
    headers=HEADERS,
    json={"venue": "polymarket"},
)

# Poll until ready
while True:
    info = requests.get(f"{BASE}/api/accounts/{account_id}", headers=HEADERS).json()
    if info["venues"].get("polymarket", {}).get("status") == "active":
        wallet = info["venues"]["polymarket"]["address"]
        print(f"Polymarket wallet ready: {wallet}")
        break
    time.sleep(2)
Repeat for predict or opinion as needed.

​
Step 3: Fund the wallet

Send the venue’s collateral token to the wallet address returned in Step 2.
VenueTokenChainContract
PolymarketUSDC.ePolygon (137)0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174
PredictUSDT (BEP-20)BSC (56)0x55d398326f99059fF775485246999027B3197955
OpinionUSDT (BEP-20)BSC (56)0x55d398326f99059fF775485246999027B3197955
LimitlessUSDC (native)Base (8453)0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
Send the exact token on the exact chain. Wrong-chain deposits may result in lost funds. For Polymarket, see the Bridge API to fund from Ethereum, Solana, or Bitcoin.

​
Step 4: Find a market

Get the venue-specific identifiers (tokenId, marketId, etc.) from the Data API.
Python
markets = requests.get(
    "https://api.predexon.com/v2/polymarket/markets",
    headers={"x-api-key": "YOUR_API_KEY"},
    params={"status": "active", "sort": "volume", "limit": 1},
).json()

market = markets["markets"][0]
token_id = market["outcomes"][0]["tokenId"]  # "Yes" side
print(f"Trading: {market['question']}  tokenId={token_id}")

​
Step 5: Place an order

Identify the market with a market bag. Required fields differ by venue — see Place Order for the per-venue matrix.
Python
order = requests.post(
    f"{BASE}/api/accounts/{account_id}/orders",
    headers=HEADERS,
    json={
        "venue": "polymarket",
        "market": {"tokenId": token_id, "outcome": "Yes"},
        "side": "buy",
        "type": "limit",
        "size": "10",
        "price": "0.50",
    },
).json()
print(f"Order {order['orderId']} — status: {order['status']}")
The response uses the account shape: a market bag instead of a flat marketIdentifier, filled in place of sizeMatched, and a normalized status (open | filled | cancelled | expired | pending | failed).

​
Step 6: Check positions

Python
positions = requests.get(
    f"{BASE}/api/accounts/{account_id}/positions", headers=HEADERS,
).json()
for p in positions["positions"]:
    print(f"{p['title']} — {p['outcome']}  size={p['size']}  pnl={p['pnl']}")
The response includes _meta with per-plane status. Use it to detect partial failures if one venue is temporarily unreachable.

​
Next Steps

Placing Trades

Order types, venues, and the full trading workflow

Funding & Withdrawals

Deposits, bridging, and withdrawals

Fees & Monetization

Set up partner fees to earn revenue

How It Works

Understand the custody and execution model