Integration

Trade prediction markets programmatically or through our conversational interface. Connect automated agents, webhooks, or route orders from the desk.

Getting Started

FLOPPA AI routes orders across prediction-market venues. Developers, trading firms, and power users can integrate via our REST API or conversational bot.

To secure your developer token, please email us with:

Which prediction markets you want to trade
How you usually place bets today
What you want the bot to handle for you

Email [email protected] Back to home

Bot Commands

Our conversational system parses natural language, scans order books across major prediction venues, and prepares orders for review in a single chat window.

/route <thesis>

Analyze a natural language thesis and calculate the optimal multi-venue routing path.

Example: /route btc down in 30m

/status

Retrieve your active portfolio positions, pending orders, and real-time PnP metrics.

Example: /status

/history

List your last 10 filled, cancelled, or routing execution traces.

Example: /history

Developer API

For developers needing absolute control or raw machine execution speed, connect directly to our low-latency HTTP routing endpoints.

POST /v1/route

Request Body JSON

{
  "thesis": "solana above current price tomorrow noon",
  "risk_preference": "medium",
  "max_slippage_pct": 1.5
}

Routed Response JSON

{
  "status": "routed",
  "route_id": "rt_8f1x9c2a",
  "estimated_savings_usd": 142.5,
  "splits": [
    {
      "venue": "Unhedged",
      "weight_pct": 60,
      "price_cents": 42
    },
    {
      "venue": "Polymarket",
      "weight_pct": 40,
      "price_cents": 42.5
    }
  ]
}

Automated Agent Integration

If you deploy autonomous agents on Farcaster, Telegram, or custom infrastructure, you can send thesis strings directly to FLOPPA. The API returns structured execution candidates so your agents can route across prediction-market spreads.

Automated Agent Script Python

import requests

FLOPPA_API = "https://api.floppa.ai/v1/route"
HEADERS = {"Authorization": "Bearer YOUR_DEV_TOKEN"}

def execute_agent_thesis(thesis_string):
    # Send thesis to FLOPPA routing API
    payload = {"thesis": thesis_string, "max_slippage_pct": 1.0}
    response = requests.post(FLOPPA_API, json=payload, headers=HEADERS)
    
    if response.status_code == 200:
        route = response.json()
        print(f"Optimal routing found! Saved \${route['estimated_savings_usd']}")
        return route['route_id']