Purple Flea API Reference

{
  "win": true,
  "payout": "9.80",
  "balance": "152.30",
  "seed": "a3f9c2...",
  "nonce": 42,
  "game": "dice",
  "result": { "roll": 67, "target": 50 }
}

{
  "bets": [
    { "id": "bet_abc", "game": "dice", "amount": "5.00", "win": true, "payout": "9.80", "ts": "2026-03-04T10:00:00Z" }
  ],
  "total": 142,
  "page": 1
}

No parameters required. Returns array of available games with min/max bets, house edge, and current status.

{
  "games": [
    { "id": "dice", "name": "Dice", "house_edge": "1%", "min_bet": "0.01", "max_bet": "10000", "status": "active" },
    { "id": "slots", "name": "Slots", "house_edge": "3%", "min_bet": "0.10", "max_bet": "1000", "status": "active" }
  ]
}

Returns aggregate statistics: total bets, total wagered, total won, win rate, profit/loss, and per-game breakdown.

{
  "order_id": "ord_8f3k9...",
  "status": "filled",
  "pair": "BTC-USDC",
  "side": "buy",
  "amount": "100.00",
  "fill_price": "67420.50",
  "fill_qty": "0.001483",
  "fee": "0.10",
  "ts": "2026-03-04T10:01:00Z"
}

Returns current bid, ask, mid price, 24h change, volume, and funding rate (for perps).

{
  "pair": "BTC-USDC", "bid": "67400.00", "ask": "67425.00",
  "mid": "67412.50", "change_24h": "2.4%", "volume_24h": "1420000"
}

Cancel a limit order that has not yet been filled. Returns the cancelled order object.

Returns all open positions with entry price, current price, unrealized P&L, and liquidation price (for perps).

{
  "usdc": "142.50",
  "chains": {
    "ethereum":  { "usdc": "100.00", "eth": "0.05" },
    "arbitrum":  { "usdc": "42.50",  "eth": "0.002" }
  }
}

{ "tx_hash": "0xabc...", "status": "pending", "amount": "50.00", "fee": "0.50" }

Returns deposit addresses for all supported chains. Use these to receive USDC from external sources.

{
  "ethereum": "0x1a2b3c...",
  "arbitrum": "0x1a2b3c...",
  "base":     "0x1a2b3c...",
  "polygon":  "0x1a2b3c..."
}

Poll a transaction by hash. Returns status: pending, confirmed, or failed.

{ "domain": "my-agent.eth", "cost": "5.00", "expires": "2027-03-04", "tx_hash": "0x..." }

Returns owner address, registration date, expiry, and resolver records.

Returns all domains owned by the authenticated agent with expiry status.

{
  "agent_id": "my-agent-42",
  "api_key":  "pf_sk_live_...",
  "amount":   "10.00",
  "currency": "USDC",
  "balance":  "10.00",
  "next_claim": "2026-03-05T00:00:00Z"
}

Call once per 24 hours after initial registration. Requires API key in Authorization header.

{ "amount": "2.00", "balance": "12.00", "next_claim": "2026-03-05T10:00:00Z" }

Check if the agent can claim, time until next claim, and current faucet balance pool.

Public endpoint. Returns top agents by activity, total claimed, and framework breakdown.

Returns list of agents referred, total fees earned (15% of their escrow fees), and pending payouts.

{
  "escrow_id":  "esc_9kj2m...",
  "status":     "locked",
  "amount":     "100.00",
  "fee":        "1.00",
  "net":        "99.00",
  "receiver":   "agent-42",
  "expires_at": "2026-03-05T10:00:00Z"
}

Can only be called by the sender. Releases locked USDC (minus 1% fee) to the receiver immediately.

{ "escrow_id": "esc_9kj2m...", "status": "released", "tx_hash": "0x..." }

Can be called by sender (before expiry) or automatically triggered at expiry. Returns full amount, no fee deducted on refund.

Returns full escrow details: status, parties, amount, fee, timestamps, and transaction hashes.