AI Agent Guide
Syzy's AI agent can explore markets, analyze data, and execute on-chain trades via natural language. Use the dashboard chat or build your own agent with the x402 API.
Try the Agent Chat
Connect your wallet and start chatting — no setup required
Getting Started
Two ways to use the Syzy agent — the dashboard chat or the REST API.
Connect Wallet
Open the Agent Chat and connect your Solana wallet (Phantom or Solflare).
Switch to Live Mode
Toggle Live mode in the chat input and fund your session wallet with USDC.
Start Chatting
Ask anything in natural language. The agent handles tool selection and on-chain execution.
What You Can Ask
The agent understands natural language commands across these categories.
Explore Markets
Trade & Predict
Analyze & Monitor
Privacy & ZK
Example Conversation
A sample interaction showing market exploration and trading via the Agent Chat.
// The Agent Chat handles everything for you:
// 1. Connect your Solana wallet
// 2. Switch to "Live" mode in the chat
// 3. Fund your session with USDC
// 4. Start chatting — the agent executes on-chain
// Example conversation:
You: "Show me active crypto markets"
Agent: Found 42 markets. Top by volume:
1. Will BTC reach $200K by 2027? — YES: 0.45 / NO: 0.55
2. Will ETH reach $10K by Q2? — YES: 0.62 / NO: 0.38
3. Will SOL flip ETH mcap? — YES: 0.12 / NO: 0.88
You: "Place 0.5 SOL on YES for the BTC market"
Agent: Placing prediction... ✓
Tokens received: 1.11 YES
Effective price: 0.45 SOL/token
x402 cost: $0.025
Tx: 5vGh...Available Tools
The agent automatically selects the right tool based on your request.
Read Tools — Free
get_marketsList active prediction markets with odds, volume, and categories
get_market_detailsGet full details for a specific market by ID — odds, reserves, oracle config
get_portfolioView your current positions, P&L, and payout estimates
get_price_feedGet real-time oracle price feed for a token (Switchboard)
system_healthCheck platform health, version, network, and market count
Write Tools — x402 Payment
create_marketCreate a new on-chain prediction market with oracle integration
place_predictionBuy YES or NO tokens on a market with privacy commitment
resolve_marketTrigger oracle-based resolution for an expired market
get_merkle_proofGenerate ZK Merkle inclusion proof for shielded positions
How x402 Payments Work
The agent handles payments automatically via the x402 protocol. Here's the flow:
Live Mode
Switch the agent to Live mode using the toggle in the chat input bar.
Fund Session
Deposit USDC to your session wallet using the budget panel in the sidebar.
Chat Naturally
Ask the agent to trade, create markets, or resolve — it picks the right tool.
Auto-Pay
When a paid tool is needed, the agent deducts USDC from your session balance automatically.
Confirmation
You see the cost and transaction result inline in the chat. No hidden fees.
Withdraw
Remaining funds can be withdrawn back to your wallet at any time.
Build Your Own Agent
Use the x402 REST API to build custom agents that trade on Syzy programmatically.
import { wrapFetch } from "@x402/fetch";
import { createSvmSigner } from "@x402/svm";
import { Keypair } from "@solana/web3.js";
const API = "https://api.oyrade.com";
const keypair = Keypair.fromSecretKey(/* funded wallet */);
const x402Fetch = wrapFetch(fetch, createSvmSigner(keypair));
// Your agent can call any x402 endpoint programmatically
// List markets (free)
const markets = await fetch(`${API}/api/v1/markets`);
const { data } = await markets.json();
// Place a prediction ($0.01 + 3% of amount)
const res = await x402Fetch(`${API}/api/v1/markets/${id}/predict`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
outcome: "YES",
amount: 0.5,
commitment_hash: "a1b2c3d4...f6a1b2",
}),
});Tips & Best Practices
Be Specific
Include market IDs, token symbols, and amounts. "Place 0.5 SOL on YES for market 7xKp" works better than "bet on crypto."
Explore First
Read tools are free. Ask to list markets, check odds, and view your portfolio before making paid trades.
Privacy by Default
The agent uses commitment hashes and ephemeral keypairs automatically. Your wallet is never exposed in transactions.
Check Before Resolving
Resolution costs $0.05. Ask the agent to check if a market has expired and the oracle price is available first.