Onboarding

Set the on-chain approvals Predict.fun needs

Predict.fun has no server-side credentials to provision — orders are signed at submission time. This endpoint does the one-time on-chain setup instead: it approves USDT and ConditionalTokens across all four (yieldBearing × negRisk) market variants, gas-sponsored on BSC. A wallet must run this once before its first Predict.fun order; the executor does not approve per trade. Idempotent. Variants already approved are no-ops. A wallet that was only partially approved re-submits just the missing variants on the next call, so retrying is safe.

Error shape. This endpoint returns the minimal {"error": "...", "code": "..."} body (OrderSimpleErrorResponse), NOT the structured error_details envelope used by the Polymarket and Opinion equivalents. Codes: INSUFFICIENT_SCOPE, PLATFORM_API_ACCESS_DISABLED, RATE_LIMITED, INVALID_USER_ID, DATABASE_ERROR. Rate limited at 5 requests/minute per user (bucket clob-provisioning, shared with the other heavy-provisioning endpoints), fail-closed, and checked BEFORE the ownership query so a flood cannot load the database. Each allowed call can launch up to 12 sponsored BSC approvals. Auth & scope. Requires trade:execute for predictfun, wallet ownership, and the mutation gate.

post/exchanges/predictfun/enable-trading

Request

  • Base URL
    https://execution.kairos.trade
  • Auth
    API key in header X-Client-Id and API key in header X-Api-Key and API key in header X-Api-Secret

Request body

wallet_addressstring required

BSC EOA to enable. Must be owned by the authenticated caller.

Response

Approvals set (or already present).

successboolean required
messagestring required
tx_hashesobject required

Per-variant approval transaction hashes, keyed by variant label (e.g. plain-binary, yield-negrisk). A variant already approved is a no-op and contributes no entry.

Changes

No recorded changes to this operation across all 1 revision of this API.