Skip to main content
GET /api/v1/market/get-markets
Auth required: No Returns a paginated list of prediction markets. Supports filtering by status, category, tags, and sorting.

​
Query Parameters

​
page
number
required
Page number (1-indexed).
​
pageSize
number
required
Items per page. Maximum 50.
​
tag
string
Filter by tag slug (e.g., crypto, politics).
​
status
string
Filter by market status: running, settling, ended.
​
sortType
string
Sort order: hot, newest, ending_soon, volume.
​
categoryId
string
Filter by category ID.
​
hotWords
string
Filter by trending keywords.
​
followed
boolean
Only return markets the authenticated user follows. Requires auth.
​
newMarket
boolean
Only recently created markets.
​
soonExpired
boolean
Markets ending within 24 hours.
​
baseTokenAddress
string
Filter by base collateral token address.

​
Response

​
totalCount
number
Total number of markets matching the filter criteria.
​
markets
array
Array of market objects.

​
Examples

curl "https://api-staging.promethex.market/api/v1/market/get-markets?page=1&pageSize=5&sortType=hot"
Response: 
{
  "code": 0,
  "data": {
    "totalCount": 142,
    "markets": [
      {
        "marketAddress": "0x1234...abcd",
        "title": "Will BTC exceed $100k by March 2026?",
        "description": "Resolves Yes if Bitcoin price...",
        "status": "running",
        "volume": "52340000000",
        "participantCount": 1823,
        "endTime": "2026-03-31T00:00:00Z",
        "options": [
          {
            "optionAddress": "0xaaaa...1111",
            "title": "Yes",
            "price": "0.65",
            "volume": "34000000000"
          },
          {
            "optionAddress": "0xbbbb...2222",
            "title": "No",
            "price": "0.35",
            "volume": "18340000000"
          }
        ],
        "tags": ["crypto", "bitcoin"],
        "categoryId": "1",
        "createdAt": "2026-02-01T10:00:00Z"
      }
    ]
  }
}