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.

​
Overview

The Predexon Trading API uses a managed wallet model. When an account enables a venue, the API provisions a wallet for that venue on the correct chain. You never handle private keys, manage gas, or sign transactions yourself.

​
How It Works

​
Wallet creation

On the accounts path, wallet provisioning is explicit:
  1. POST /api/accounts/create creates an empty account.
  2. POST /api/accounts/{accountId}/enable with { "venue": "polymarket" | "predict" | "opinion" | "limitless" } provisions a wallet for that venue, funds gas, and sets token approvals.
  3. Poll GET /api/accounts/{accountId} — each enabled venue’s status moves from provisioning to active, and the on-chain address is populated.
VenueChainCollateral
PolymarketPolygonUSDC.e
Predict.funBSCUSDT (BEP-20)
OpinionBSCUSDT (BEP-20)
LimitlessBaseUSDC (native)
The legacy /api/users/create endpoint auto-enables Polymarket and Predict in one call and returns polymarketWalletAddress / predictWalletAddress directly. See the legacy reference.

​
Key security via Turnkey

Private keys are managed by Turnkey, a hardware-backed key management infrastructure.
  • Keys are generated and stored in secure enclaves
  • Keys never leave the enclaves
  • Predexon never has access to private keys
  • All transaction signing happens server-side automatically

​
What the API handles

ConcernManaged By
Key generationAutomatic on venue enablement
Transaction signingServer-side via Turnkey
Gas feesHandled by platform
Nonce managementHandled by platform

​
Deposit Flow

Each venue has its own deposit method. Fetch the wallet address via Get Account → venues[venue].address, then send the right token on the right chain. Polymarket — two options:
  1. Send USDC.e directly to the Polymarket wallet on Polygon.
  2. Use the Bridge API to deposit from Ethereum, Arbitrum, Base, Solana, or Bitcoin. Funds are automatically converted to USDC.e.
Predict.fun / Opinion — send USDT (BEP-20) directly to the wallet on BSC. No bridge is available or needed for these venues. Limitless — send native USDC on Base directly to the wallet. No bridge is available or needed.
Sending the wrong token or using the wrong chain will result in lost funds. Always verify the token standard and chain before depositing.

​
Withdrawal Flow

Call POST /api/accounts/{accountId}/withdraw with the venue, amount, destination address, and chain. The API signs and submits the transaction on-chain and returns a transactionHash. Before withdrawing:
  1. Cancel open orders (Predict, Opinion, and Limitless lock collateral on resting buy orders).
  2. Redeem any resolved winning positions.
  3. Verify available balance with Get Balance.

​
Security Boundaries

  • Each API key can only access accounts it created.
  • Attempting to access another API key’s account returns 403 Forbidden.
  • Wallet addresses are unique per account per venue.