Markets

Overview

The MarketFetcher class handles market discovery, individual market lookups, and orderbook retrieval. It also automatically caches venue contract addresses needed for order signing.

Setup

import os
from limitless_sdk.api import HttpClient
from limitless_sdk import HMACCredentials
from limitless_sdk.markets import MarketFetcher

# Authenticate with a scoped API token (token ID + secret)
http_client = HttpClient(
    hmac_credentials=HMACCredentials(
        token_id=os.environ["LMTS_TOKEN_ID"],
        secret=os.environ["LMTS_TOKEN_SECRET"],
    ),
)
market_fetcher = MarketFetcher(http_client)

Fetching active markets

Use get_active_markets() to retrieve a paginated list of all active markets:

params = {
    "page": 1,
    "limit": 10,
    "sortBy": "newest",
}
result = await market_fetcher.get_active_markets(params)

for market in result["data"]:
    print(market["title"], market["slug"])

Parameter	Type	Default	Description
`page`	`int`	`1`	Page number for pagination
`limit`	`int`	`10`	Number of markets per page
`sortBy`	`str`	—	Sort order: `"lp_rewards"`, `"ending_soon"`, `"newest"`, `"high_value"`, or `"liquidity"`

Use pagination parameters to avoid large responses. Start with a small limit and increment page as needed.

Fetching a single market

Use get_market(slug) to retrieve full details for a specific market:

market = await market_fetcher.get_market("btc-above-100k-march-2025")

print(market.title)
print("YES token:", market.tokens.yes)
print("NO token:", market.tokens.no)
print("Exchange:", market.venue.exchange)
print("Adapter:", market.venue.adapter)

The returned Market object is a Pydantic model with the following key fields:

Field	Type	Description
`title`	`str`	Human-readable market title
`slug`	`str`	URL-friendly market identifier
`tokens.yes`	`str`	Token ID for the YES outcome
`tokens.no`	`str`	Token ID for the NO outcome
`venue.exchange`	`str`	Exchange contract address (used as EIP-712 `verifyingContract`)
`venue.adapter`	`str`	Adapter contract address (used for NegRisk token approvals)
`open_interest`	`str \| None`	Open interest value
`liquidity`	`str \| None`	Liquidity value
`image_url`	`str \| None`	Market image URL
`automation_type`	`str \| None`	Market automation type (`"manual"`, `"lumy"`, or `"sports"`)
`position_ids`	`list[str] \| None`	Position IDs (alternative to `tokens.yes` / `tokens.no`)

Token IDs are returned as strings. Pass them directly to OrderClient.create_order() as token_id.

Fetching the orderbook

Use get_orderbook(slug) to retrieve current bids and asks for a market:

orderbook = await market_fetcher.get_orderbook("btc-above-100k-march-2025")

print("Bids:")
for bid in orderbook["bids"]:
    print(f"  Price: {bid['price']}  Size: {bid['size']}")

print("Asks:")
for ask in orderbook["asks"]:
    print(f"  Price: {ask['price']}  Size: {ask['size']}")

Venue caching

Every call to get_market() automatically caches the venue contract addresses (exchange and adapter) for that market. The OrderClient reads from this cache when signing orders, so you do not need to manage venues manually.

Fetch the market

Calling get_market(slug) retrieves and caches the venue:

market = await market_fetcher.get_market("btc-above-100k-march-2025")
# Venue is now cached for this slug

Place an order

The OrderClient automatically looks up the cached venue when you pass market_slug:

await order_client.create_order(
    token_id=market.tokens.yes,
    price=0.65,
    size=10.0,
    side=Side.BUY,
    order_type=OrderType.GTC,
    market_slug="btc-above-100k-march-2025",
)

You must call get_market(slug) at least once before placing orders on that market. Without a cached venue, the OrderClient cannot determine the correct verifyingContract for EIP-712 signing.

Debugging venue cache

Enable DEBUG logging to see venue cache operations:

from limitless_sdk.types import ConsoleLogger, LogLevel

logger = ConsoleLogger(level=LogLevel.DEBUG)

# Output will include lines like:
# [DEBUG] Venue cached for btc-above-100k-march-2025: exchange=0xA1b2... adapter=0xD4e5...
# [DEBUG] Venue cache hit for btc-above-100k-march-2025

Complete example

import asyncio
import os
from limitless_sdk.api import HttpClient
from limitless_sdk import HMACCredentials
from limitless_sdk.markets import MarketFetcher

async def main():
    http_client = HttpClient(
        hmac_credentials=HMACCredentials(
            token_id=os.environ["LMTS_TOKEN_ID"],
            secret=os.environ["LMTS_TOKEN_SECRET"],
        ),
    )
    market_fetcher = MarketFetcher(http_client)

    # List active markets
    active = await market_fetcher.get_active_markets({"limit": 5})
    for m in active["data"]:
        print(f"{m['title']} — {m['slug']}")

    # Get a specific market
    slug = active["data"][0]["slug"]
    market = await market_fetcher.get_market(slug)
    print(f"\nMarket: {market.title}")
    print(f"YES token: {market.tokens.yes}")
    print(f"NO token:  {market.tokens.no}")

    # Fetch the orderbook
    orderbook = await market_fetcher.get_orderbook(slug)
    print(f"\nOrderbook — {len(orderbook['bids'])} bids, {len(orderbook['asks'])} asks")

    await http_client.close()

asyncio.run(main())

Getting Started

Quick Start

TypeScript SDK

Python SDK

Go SDK

Rust SDK

WebSocket

Overview

Setup

Fetching active markets

Fetching a single market

Fetching the orderbook

Venue caching

Debugging venue cache

Complete example

​Overview

​Setup

​Fetching active markets

​Fetching a single market

​Fetching the orderbook

​Venue caching

​Debugging venue cache

​Complete example

Overview

Setup

Fetching active markets

Fetching a single market

Fetching the orderbook

Venue caching

Debugging venue cache

Complete example