Struct PredictClient 

pub struct PredictClient { /* private fields */ }

Client for interacting with predict.fun

Implementations

impl PredictClient

pub fn new( chain_id: u64, private_key: &str, api_base_url: String, api_key: Option<String>, ) -> Result<Self>

Create a new PredictClient with full trading capability

pub fn new_with_predict_account( chain_id: u64, privy_private_key: &str, predict_account: &str, api_base_url: String, api_key: Option<String>, ) -> Result<Self>

Create a new PredictClient with Predict Smart Wallet (Kernel) signing

pub fn new_readonly( chain_id: u64, api_base_url: String, api_key: Option<String>, ) -> Result<Self>

Create a read-only PredictClient for market data operations

pub fn can_sign(&self) -> bool

Check if this client has signing capability

pub fn uses_predict_account(&self) -> bool

Check if this client uses Predict Account (Kernel) signing

pub fn predict_account(&self) -> Option<String>

Get the Predict Account address if configured

pub async fn authenticate(&self) -> Result<String>

Authenticate with Predict API and obtain a JWT token

Flow:

1. GET /v1/auth/message → dynamic message to sign
2. Sign message with wallet private key (EIP-191 personal sign)
3. POST /v1/auth → submit signature → receive JWT

The JWT is required for authenticated WebSocket subscriptions (e.g., predictWalletEvents/{jwt} for order fill notifications).

pub async fn authenticate_and_store(&self) -> Result<String>

Authenticate and store the JWT token for subsequent REST API requests

This calls authenticate() and stores the resulting JWT so that add_auth_headers() will include Authorization: Bearer {jwt} on all requests.

pub fn jwt_token(&self) -> Option<String>

Get the stored JWT token (if authenticated)

pub async fn get_markets(&self) -> Result<Vec<PredictMarket>>

Fetch all markets from Predict

pub async fn get_orderbook(&self, market_id: &str) -> Result<PredictOrderBook>

Fetch orderbook for a specific market

pub async fn place_limit_order( &self, token_id: &str, side: Side, price: Decimal, quantity: Decimal, is_neg_risk: bool, is_yield_bearing: bool, fee_rate_bps: u64, ) -> Result<PlaceOrderResponse>

Place a limit order on Predict

Builds, signs, and submits a limit order to the Predict API. Returns the order ID and hash on success.

pub async fn cancel_orders( &self, order_ids: &[String], ) -> Result<RemoveOrdersResponse>

Cancel orders by their IDs

Removes orders from the Predict orderbook. Note: This removes orders from the orderbook but does not cancel on-chain.

Arguments

• order_ids - Order IDs to cancel (max 100)

pub async fn get_open_orders(&self) -> Result<Vec<PredictOrder>>

Fetch open orders for this account

Returns all orders with status OPEN for the authenticated user.

pub async fn get_positions(&self) -> Result<Vec<PredictPosition>>

Fetch positions (token balances) for this account

pub fn signer_address(&self) -> Result<String>

Get the signer address

pub fn chain_id(&self) -> ChainId

Get the chain ID

pub fn api_key(&self) -> Option<&str>

Get the API key (if set)

pub fn order_builder(&self) -> &OrderBuilder

Get the order builder

pub fn api_base_url(&self) -> &str

Get the API base URL

pub async fn get_category(&self, slug: &str) -> Result<PredictCategory>

Fetch a category by slug from Predict

pub async fn get_category_optional( &self, slug: &str, ) -> Result<Option<PredictCategory>>

Fetch a category by slug, returning None if not found

pub async fn set_approvals( &self, is_neg_risk: bool, is_yield_bearing: bool, ) -> Result<()>

Set all necessary on-chain approvals for trading.

This must be called once before placing orders. It sets:

• ERC-1155 approval on Conditional Tokens for the CTF Exchange
• ERC-20 approval on USDT for the CTF Exchange
• Neg Risk Adapter approval (if is_neg_risk)

pub async fn split_positions( &self, condition_id: &str, amount: f64, is_neg_risk: bool, is_yield_bearing: bool, ) -> Result<String>

Split USDT into UP/DOWN outcome tokens for a market.

When a predict_account is configured, splits via Kernel so tokens land on the predict_account (which is the order maker). When using direct EOA, splits directly.