Search Markets
Search for prediction markets by keyword, tag, or slug.
Parameters
| Name | Type | Default | Description |
|---|
q | string | - | Search query |
slug | string | - | Exact market slug match |
tag | string | - | Category: crypto, politics, sports, entertainment |
limit | int | 10 | Max results (max: 100) |
offset | int | 0 | Pagination offset |
sort | string | volume | volume, liquidity, end_date, recent |
min_volume | int | 100 | Minimum volume in USD |
accepting_orders | bool | true | Only tradeable markets |
ending_soon | bool | false | Prioritize markets ending within 24h |
Example
curl "https://luckylobster.io/api/agent/v1/markets/search?q=bitcoin&sort=volume" \
-H "Authorization: Bearer ll_live_..."
{
"success": true,
"data": [
{
"id": "1314069",
"slug": "bitcoin-up-or-down-on-february-3",
"question": "Bitcoin Up or Down on February 3?",
"outcomes": ["Up", "Down"],
"outcomePrices": ["0.65", "0.35"],
"volume": "409100.65",
"liquidity": "39255.13",
"acceptingOrders": true
}
],
"context": {
"topMatch": { "id": "1314069", "question": "..." }
}
}
Get Market Details
Get detailed information about a specific market including token IDs for trading.
Example
curl "https://luckylobster.io/api/agent/v1/markets/1314069" \
-H "Authorization: Bearer ll_live_..."
{
"success": true,
"data": {
"id": "1314069",
"conditionId": "0xf46bf33576e8341821161316705ab2357312f58d58b7d157cb8dca73b656b326",
"question": "Bitcoin Up or Down on February 3?",
"tokens": [
{"tokenId": "36656454529662513...", "outcome": "Up", "price": "0.345"},
{"tokenId": "10609233133841503...", "outcome": "Down", "price": "0.655"}
],
"clobTokenIds": ["36656454529662513...", "10609233133841503..."],
"spreads": [
{"outcome": "Up", "bid": "0.34", "ask": "0.35", "spread": "0.01"}
]
}
}
Crypto Markets
Quick lookup for crypto up/down markets.
Parameters
| Name | Type | Description |
|---|
asset | string | btc, eth, sol, doge, etc. |
timeframe | string | daily, hourly, 15m |
Example
curl "https://luckylobster.io/api/agent/v1/markets/crypto?asset=btc&timeframe=daily" \
-H "Authorization: Bearer ll_live_..."
Find by Slug
Find a market by its exact Polymarket URL slug.
Example
curl "https://luckylobster.io/api/agent/v1/markets/by-slug?slug=btc-updown-15m-1770129900" \
-H "Authorization: Bearer ll_live_..."
Order Book
Get the full order book for a token.
Parameters
| Name | Type | Description |
|---|
token_id | string | Token ID (required) |
token_ids | string | Comma-separated for batch (max 20) |
Example
curl "https://luckylobster.io/api/agent/v1/orderbook?token_id=36656454529662513..." \
-H "Authorization: Bearer ll_live_..."
{
"success": true,
"data": {
"tokenId": "36656454529662513...",
"bids": [
{"price": "0.65", "size": "1000"},
{"price": "0.64", "size": "500"}
],
"asks": [
{"price": "0.66", "size": "800"}
],
"summary": {
"bestBid": "0.65",
"bestAsk": "0.66",
"spread": "0.01"
}
}
}
Prices
Get current prices for tokens.
Parameters
| Name | Type | Description |
|---|
token_id | string | Token ID (required) |
token_ids | string | Comma-separated for batch |
Example
curl "https://luckylobster.io/api/agent/v1/prices?token_id=36656454529662513..." \
-H "Authorization: Bearer ll_live_..."
{
"success": true,
"data": {
"tokenId": "36656454529662513...",
"midpoint": "0.655",
"buyPrice": "0.66",
"sellPrice": "0.65",
"lastTradePrice": "0.65"
}
}
Spread
Get the bid-ask spread for a token.
Example
curl "https://luckylobster.io/api/agent/v1/spread?token_id=36656454529662513..." \
-H "Authorization: Bearer ll_live_..."
{
"success": true,
"data": {
"bid": "0.65",
"ask": "0.66",
"spread": "0.01",
"spreadPercent": "1.52"
}
}
Market Data (All-in-One)
Get comprehensive market data in a single request.
Example
curl "https://luckylobster.io/api/agent/v1/market-data?token_id=36656454529662513..." \
-H "Authorization: Bearer ll_live_..."
