List Markets

Search markets via Polymarket public-search by keyword, status, sorting and pagination.

GET /markets

List Markets

cURL

curl --request GET \
  --url https://www.aionmarket.com/bvapi/markets \
  --header 'Authorization: Bearer <token>'

200

{
  "items": [
    {
      "id": "<string>",
      "title": "<string>",
      "slug": "<string>",
      "status": "<string>",
      "yesPrice": 123,
      "noPrice": 123,
      "volume": 123,
      "endDate": "2023-11-07T05:31:56Z"
    }
  ],
  "total": 123
}

Search for markets on Polymarket using keywords and various filters.

Overview

Use this endpoint for discovery before context checks and execution.

Query parameters

Parameter	Type	Required	Default	Description
q	string	Yes	-	Search keywords
limit	integer	No	20	Results per page
page	integer	No	1	1-indexed page number
order	string	No	-	Sorting field
ascending	boolean	No	false	Sort direction
eventsStatus	string	No	active	active, resolved, closed
closed	boolean	No	false	Closed market filter
venue	string	No	polymarket	Venue selector

Examples

curl

curl -X GET "https://www.aionmarket.com/bvapi/markets?q=election&limit=20&order=volume24hr&ascending=false" \
  -H "Authorization: Bearer YOUR_API_KEY"

Python SDK

from aion_sdk import AionMarketClient

client = AionMarketClient(api_key="YOUR_API_KEY", base_url="https://www.aionmarket.com/bvapi")

markets = client.get_markets(
    q="election",
    limit=20,
    page=1,
    venue="polymarket",
    events_status="active",
)
print(markets)

Response

[
  {
    "id": "0x123abc...",
    "title": "Will Biden win the 2024 election?",
    "question": "Will Joe Biden win the 2024 US Presidential election?",
    "conditionId": "0xabc123...",
    "category": "Politics",
    "endDate": "2024-11-05T00:00:00Z",
    "createdAt": "2024-01-01T00:00:00Z",
    "lastUpdatedAt": "2024-04-15T10:30:00Z",
    "volume24hr": "1500000",
    "liquidity": "500000",
    "bestBid": "0.65",
    "bestAsk": "0.68",
    "active": true,
    "resolved": false,
    "outcomes": ["Yes", "No"]
  }
]

Search Tips

• By Category: Search for category names like “Politics”, “Sports”, “Crypto”
• By Question: Search for specific questions about events
• By Keyword: Use broader terms to find related markets
• Sort by Volume: Discover most active markets with order=volume24hr
• Active Only: Use eventsStatus=active to find ongoing trading opportunities

Response Fields

Field	Type	Description
id	string	Market identifier
title	string	Market title
question	string	Full market question
conditionId	string	Condition ID
category	string	Market category
endDate	string	Resolution time
volume24hr	string	24h volume
liquidity	string	Liquidity
bestBid	string	Best bid
bestAsk	string	Best ask
active	boolean	Active flag
resolved	boolean	Resolved flag
outcomes	array	Outcome names

Common errors

Code	Meaning
400	Invalid query parameters
401	Invalid or missing API key
429	Rate limited

Use Cases

• Market Discovery: Find relevant markets for your trading strategy
• Opportunity Scanning: Identify high-volume or liquid markets
• Category Filtering: Browse markets within specific domains
• Heartbeat Data: Include in periodic market refreshes

Authorizations

Authorization · string · header · default: YOUR_API_KEY · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

q · string · required

Global search keyword (required). Backed by Polymarket public-search.

Required string length: 1 - 100

limit · integer · default: 20

Per-type result count (limit_per_type), default 20

Required range: x >= 0

page · integer · default: 1

1-indexed page number, default 1

Required range: x >= 1

order · string

Sort field, e.g. volume24hr / liquidity / volume

Maximum string length: 200

ascending · boolean · default: false

Sort ascending (default false = descending)

eventsStatus · enum<string> · default: active

Event status filter (default active)

Available options: active, resolved, closed

closed · boolean · default: false

Only return closed markets (default false)

venue · string · default: polymarket

Trading venue (default polymarket)

Maximum string length: 50

Response

200 - application/json

Matching markets

items · object[]

Show child attributes

total · integer