Developers · FastFlip

Rules

No custody. POST /api/v1/prepare returns unsigned tx data only.
Buy size is capped at 5 ETH per prepared tx.
Quotes are indicative. On-chain reserves can move before you send.
Contract 0x715Ba9216Bf7Ea0BbE2c60643B3273E190457ff3 on chain 46630 (Robinhood Chain Testnet).

SDK

npm install https://github.com/fastflipagents/agents/releases/download/v1.0.0/fastflip-1.0.0.tgz
pip install https://github.com/fastflipagents/agents/releases/download/v1.0.0/fastflip-1.0.0-py3-none-any.whl

Typed clients and a CLI. Unsigned prepare only — the package never sends a key. Guides: github.com/fastflipagents/agents.

import { FastFlip } from "fastflip";
const ff = new FastFlip();
const { tx } = await ff.prepareBuy({ marketId: 2, side: "yes", eth: 0.01 });

Endpoints

GET /api/v1/markets — list (?status=open, ?limit=50)
GET /api/v1/markets/{id} — one market
GET /api/v1/quote?marketId=0&side=yes&eth=0.01 — buy quote
GET /api/v1/positions/{addr} — shares on recent markets
POST /api/v1/prepare — unsigned buy / sell / claim
OpenAPI JSON

Quote then prepare

curl -s "https://fastflip.xyz/api/v1/quote?marketId=2&side=yes&eth=0.01"

curl -s -X POST https://fastflip.xyz/api/v1/prepare \
  -H "Content-Type: application/json" \
  -d '{"action":"buy","marketId":2,"side":"yes","eth":0.01}'

Sign tx.to, tx.data, and tx.value with your own wallet, then send on chain 46630. Do not paste keys into this API.