falcon-polymarket

Python client for the Falcon AI Polymarket external API.

Install

pip install falcon-polymarket

Local development:

pip install -e packages/falcon-polymarket-python

Quick start

Set FALCON_API_KEY (from Developer Keys) or pass explicitly:

from falcon_polymarket import FalconPolymarketClient

with FalconPolymarketClient() as client:
    print(client.health())
    for market in client.iter_markets(status="active", limit=10):
        print(market["title"], market.get("yes_price"))
    board = client.get_leaderboard(limit=5, sort_by="total_realized_pnl")
    print(board)
    ticks = client.price_ticks("0x...", hours=1)
    print(len(ticks), "sub-minute ticks")

Staging:

client = FalconPolymarketClient(
    api_key="aif_...",
    base_url="https://api-test.falconai.bot/api/v1/external/polymarket",
)

Methods

• health(), usage()
• list_markets(), iter_markets(), get_market() — event_slug filter on list
• list_events(), get_event(), list_series(), get_series()
• get_orderbook(), orderbook_history() — include_levels for recent L2 rows
• price_ticks() — sub-minute CLOB WebSocket ticks
• list_trades(), get_trader(), get_trader_stats()
• get_leaderboard(), get_copy_picks(), get_positions()
• run_backtest()

See the API reference for parameters and tiers.