Skip to main content

​
Overview

Predexon Trading API manages wallets on behalf of users. Instead of requiring users to handle private keys, manage transaction fees, or sign transactions, the API handles all of this automatically.

Simplified Integration

No wallet SDKs or key management needed in your application

No Gas Management

All transaction fees are handled by the platform

Secure Key Management

Private keys are securely managed - you never handle them

​
How It Works

  1. Your Application calls the Predexon Trading API
  2. Predexon API manages user wallets and executes trades
  3. Venues settle transactions on their respective blockchains (Polygon for Polymarket, BSC for Predict)

​
Wallet Management

When you create a user, the API generates managed wallets for each venue:
VenueDeposit AddressBlockchainCollateral
PolymarketpolymarketWalletAddressPolygonUSDC.e
PredictpredictWalletAddressBSCUSDT (BEP-20)
Send the appropriate stablecoin to the wallet address for the venue you want to trade on. The API handles all transaction signing automatically.

​
Key Security

Private keys are managed by Turnkey, a secure, hardware-backed key management infrastructure:
  • Predexon never has access to private keys - keys are generated and stored in Turnkey’s secure environment
  • Hardware-backed security - keys never leave secure enclaves
  • No key management in your app - all signing happens server-side

​
Order Execution

Both venues use an orderbook model with limit and market orders. Order Types:
  • Limit Orders: Placed on the orderbook at a specific price, wait for a counterparty
  • Market Orders: Execute immediately at the best available price
Execution Model:
  • Orders can be partially filled
  • Open orders can be cancelled
Both venues use the same order statuses: open, filled, cancelled, and expired. Orders may briefly show pending as a transitional state before reaching a terminal status.
PolymarketPredict.fun
Transaction feesHandled by the platformHandled by the platform
FeesOptional partner feeExchange fee that varies by market (automatic)

​
Position Lifecycle

Positions move through three stages:
1

Active

Market is still trading. You can sell your position or monitor P&L.
2

Resolved

Market has settled and outcome is determined. Check if you won or lost.
3

Redeemable

Winning positions can be redeemed via the Redeem endpoint. Returns USDC.e (Polymarket) or USDT (Predict).

​
Security Model

Each API key can only access users it created. Attempting to access another API key’s users returns 403 Forbidden.

​
Comparison to Self-Custody

FeaturePredexonSelf-Custody
Key managementHandled by APIYou manage
Transaction feesHandled by the platformYou pay
Integration complexityREST API callsWallet SDKs + signing
Multi-chain supportUnified APISeparate integrations
WithdrawalAPI callDirect blockchain tx

​
Best Practices

1

Store User IDs

Save the userId from Create User - it’s required for all subsequent operations.
2

Check Balance Before Orders

Always verify sufficient funds with Get Balance before placing orders.
3

Handle Errors Gracefully

Implement retry logic with exponential backoff for transient failures.
4

Monitor Positions

Periodically check positions for resolved markets that can be redeemed.
5

Withdraw Before Deleting

Always withdraw funds before deleting a user - the action is irreversible.

​
Next Steps

Funding & Withdrawals

Deposit funds into your trading wallet

Placing Trades

Order types, venues, and the full trading workflow

Fees & Monetization

Set up partner fees to earn revenue