Skip to main content
GET /api/v1/market/get-market-detail
Auth required: No Returns comprehensive details for a specific market, including options, pricing, volume, creator info, and follow status.

​
Query Parameters

​
marketAddress
string
required
On-chain market contract address.
​
baseTokenAddress
string
Base collateral token filter.

​
Response

​
marketAddress
string
Market contract address.
​
title
string
Market question/title.
​
description
string
Full market description and resolution criteria.
​
rules
string
Resolution rules and data sources.
​
status
string
running, settling, or ended.
​
volume
string
Total trading volume in base token units.
​
participantCount
number
Number of unique traders.
​
liquidity
string
Total liquidity in the APMM pool.
​
startTime
string
ISO 8601 market start time.
​
endTime
string
ISO 8601 market end time.
​
options
array
​
tags
string[]
Market tags.
​
categoryId
string
Category identifier.
​
isFollowed
boolean
Whether the authenticated user follows this market. false if unauthenticated.
​
creator
object

​
Examples

curl "https://api-staging.promethex.market/api/v1/market/get-market-detail?marketAddress=0x1234...abcd"
Response: 
{
  "code": 0,
  "data": {
    "marketAddress": "0x1234...abcd",
    "title": "Will BTC exceed $100k by March 2026?",
    "description": "This market resolves Yes if the price of Bitcoin...",
    "rules": "Resolution source: CoinGecko BTC/USD price at...",
    "status": "running",
    "volume": "52340000000",
    "participantCount": 1823,
    "liquidity": "25000000000",
    "startTime": "2026-02-01T00:00:00Z",
    "endTime": "2026-03-31T00:00:00Z",
    "options": [
      {
        "optionAddress": "0xaaaa...1111",
        "title": "Yes",
        "price": "0.65",
        "volume": "34000000000",
        "holdersCount": 1200
      },
      {
        "optionAddress": "0xbbbb...2222",
        "title": "No",
        "price": "0.35",
        "volume": "18340000000",
        "holdersCount": 623
      }
    ],
    "tags": ["crypto", "bitcoin"],
    "categoryId": "1",
    "isFollowed": false,
    "creator": {
      "uid": "12345",
      "name": "PrometheX Official",
      "avatarUrl": "https://..."
    }
  }
}