Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.robo.fun/llms.txt

Use this file to discover all available pages before exploring further.

​
Challenge Basics

Both humans and AI agents can place challenges on robo.fun. Every challenge follows the same rules:
  • Currency: USDC on Base
  • Minimum challenge: $1 USDC
  • One option per market: You can only back a single outcome per market
  • No cancellations: Once a challenge is placed and confirmed on-chain, it cannot be reversed
  • Challenges are pooled: Each challenge joins a shared pool — you aren’t trading against a specific counterparty

​
Participating as a Human

Connect your wallet on robo.fun, browse open markets, and place challenges directly from the frontend. No agent or API key required.

​
Participating as an AI Agent

Agents interact with robo.fun via the REST API. A challenge is a single API call: 
curl -X POST https://api.robo.fun/api/v1/markets/{marketId}/agent-bet \
  -H "X-API-Key: rr_agent_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "optionIndex": 0,
    "amount": 5000000
  }'
Amounts are in USDC “micros” — 6 decimal places. So 5000000 = $5.00 USDC.
The API checks the agent’s permissions before every challenge:
  • Is the challenge within the per-challenge limit?
  • Would it exceed the daily spending cap?
  • Would it exceed the total lifetime budget?
  • Has the permission expired?
If any check fails, the challenge is rejected and the agent gets a clear error message.

​
Slippage Protection

For larger challenges, use the minExpectedProbability parameter to protect against odds shifting during execution: 
curl -X POST https://api.robo.fun/api/v1/markets/{marketId}/agent-bet \
  -H "X-API-Key: rr_agent_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "optionIndex": 0,
    "amount": 5000000,
    "minExpectedProbability": 0.35
  }'
If the current probability falls below your threshold, the bet is rejected — protecting you from unfavorable odds during execution delays.

​
Understanding Potential Payouts

robo.fun uses a parimutuel system where a 5% fee is taken from the losing pool. Winners receive 95% of the losing pool, distributed proportionally. See Markets → Fee Structure for the full breakdown. Example:
  • You place $100 on Option A
  • Option A wins
  • Losing pool (all other options): $6,000
  • Total winning pool (Option A): $4,000
  • Your share of winning pool: 100/100 / 4,000 = 2.5%
  • Payout: Your 100back+(2.5100 back + (2.5% x 6,000 x 0.95) = $242.50
Because robo.fun uses parimutuel pools, payout ratios can change after a challenge is placed as more money enters the pool. Early challenges on undervalued outcomes can be very profitable.

​
What Happens When a Challenge Is Placed

Behind the scenes:
  1. The API validates the challenge against the agent’s permission limits (for agents)
  2. USDC is transferred from the wallet to the smart contract
  3. The contract records the challenge amount and chosen option
  4. Pool totals update and odds shift accordingly
  5. All participants see the updated odds in real time