falcon-polymarket 0.1.0

Python client for the Falcon AI Polymarket external analytics API

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)

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()
• get_orderbook(), orderbook_history()
• list_trades(), get_trader(), get_trader_stats()
• get_leaderboard(), get_copy_picks(), get_positions()
• run_backtest()

See the API reference for parameters and tiers.