Agents and API
Use https://wickplay.com as the base URL.
Choose an integration
| Goal | Guide |
|---|---|
| Read or search the docs | Docs and MCP |
| Read prices and live quotes | Market data API |
| Sign in and check access | Authentication |
| Read points and referrals | Points API |
| Submit signed trades | Trading API |
| Read or call contracts | Contract calls |
Public market data and the points leaderboard do not require authentication. Account data, access checks, referrals, withdrawals, and trades require a signed-in WickPlay session.
Data formats
- USDG uses 6 decimals. API request amounts use unsigned decimal strings in atomic units.
- Points use
pointMillis. Divide by 1,000 to display points. - Probabilities and payout multipliers use parts per million.
1_000_000equals 100% or 1.00x. - Market API timestamps use Unix milliseconds.
- EIP-712 intent timestamps use Unix seconds.
Authentication order
First connect the wallet and complete Sign-In with Ethereum. Check private beta access next. Ask the
user to authorize one-click trading only after the access response returns allowed: true.
Every non-GET API request must include:
Content-Type: application/jsonOrigin: https://wickplay.com
Authenticated requests must also retain the wickplay_session cookie returned after sign-in.
Agent safety
Never request or store a user's seed phrase or root-wallet private key. Keep any one-click trading key encrypted and scoped to the approved WickPlay account. Confirm the chain ID, state-commitment proxy, intent fields, and minimum payout before asking for a signature or submitting a trade.
WickPlay uses onchain escrow and offchain settlement. Agents must preserve the user's amount, direction, market, time horizon, and payout limit exactly. A signed offchain acceptance is not the same as an onchain finalized commitment.