Skip to main content
GET
/
api
/
events
/
{slug}
/
market-metadata
Get Market Metadata
curl --request GET \
  --url https://api.example.com/api/events/{slug}/market-metadata
{
  "data": {
    "condition_id": "<string>",
    "title": "<string>",
    "slug": "<string>",
    "short_title": "<string>",
    "question": "<string>",
    "market_rules": "<string>",
    "resolution_source": "<string>",
    "resolution_source_url": "<string>",
    "resolver": "<string>",
    "end_time": "<string>",
    "is_active": true,
    "is_resolved": true,
    "neg_risk": true,
    "neg_risk_market_id": "<string>",
    "volume": 123,
    "volume_24h": 123,
    "condition": {
      "id": "<string>",
      "oracle": "<string>",
      "question_id": "<string>",
      "outcome_slot_count": 123,
      "resolved": true,
      "resolution_status": "<string>",
      "resolution_price": 123,
      "resolution_flagged": true,
      "resolution_paused": true,
      "resolution_deadline_at": "<string>",
      "volume": 123,
      "open_interest": 123,
      "active_positions_count": 123
    },
    "outcomes": [
      {
        "token_id": "<string>",
        "outcome_text": "<string>",
        "outcome_index": 123,
        "is_winning_outcome": true,
        "payout_value": 123
      }
    ],
    "created_at": "<string>",
    "updated_at": "<string>"
  }
}

​
Overview

The /api/events/{slug}/market-metadata endpoint retrieves detailed metadata for a specific market (condition) within an event. This includes market configuration, resolution details, and status information.

​
Request

​
Path Parameters

​
slug
string
required
The event slug identifier (e.g., bitcoin-price-above-100k).

​
Query Parameters

​
conditionId
string
required
The condition ID (market identifier) to retrieve metadata for. This is the blockchain contract address for the market.

​
Response

​
data
object
Market metadata object, or null if not found.
​
condition_id
string
Unique market identifier (blockchain condition ID).
​
title
string
Market question or title.
​
slug
string
URL-friendly market identifier.
​
short_title
string
Abbreviated market title for display in compact spaces.
​
question
string
Detailed market question text.
​
market_rules
string
Market-specific rules and settlement criteria.
​
resolution_source
string
Source used for resolving the market (e.g., “CoinGecko”, “ESPN”).
​
resolution_source_url
string
URL to the resolution source.
​
resolver
string
Ethereum address of the market resolver.
​
end_time
string
ISO 8601 timestamp when the market closes for trading.
​
is_active
boolean
Whether the market is currently accepting trades.
​
is_resolved
boolean
Whether the market has been resolved.
​
neg_risk
boolean
Whether this market uses negative risk (profit-only) mechanics.
​
neg_risk_market_id
string
ID of the associated negative risk market if applicable.
​
volume
number
Total trading volume in USDC.
​
volume_24h
number
Trading volume in the last 24 hours in USDC.
​
condition
object
Blockchain condition details.
​
id
string
Condition contract address.
​
oracle
string
Oracle contract address.
​
question_id
string
Question identifier used by the oracle.
​
outcome_slot_count
number
Number of possible outcomes.
​
resolved
boolean
Whether the condition has been resolved on-chain.
​
resolution_status
string
Current resolution status (e.g., “pending”, “confirmed”, “disputed”).
​
resolution_price
number
Final settlement price if resolved.
​
resolution_flagged
boolean
Whether the resolution has been flagged for review.
​
resolution_paused
boolean
Whether resolution is currently paused.
​
resolution_deadline_at
string
ISO 8601 timestamp of the resolution deadline.
​
volume
number
Total trading volume for this condition in USDC.
​
open_interest
number
Current open interest (total value locked) in USDC.
​
active_positions_count
number
Number of active trader positions.
​
outcomes
array
Array of possible outcomes.
​
token_id
string
Unique token identifier for this outcome.
​
outcome_text
string
Outcome label.
​
outcome_index
number
Index of the outcome.
​
is_winning_outcome
boolean
Whether this outcome won (only set after resolution).
​
payout_value
number
Payout value for this outcome if resolved.
​
created_at
string
ISO 8601 timestamp of market creation.
​
updated_at
string
ISO 8601 timestamp of last update.

​
Example Request

cURL
curl --request GET \
  --url 'https://api.kuest.com/api/events/bitcoin-price-above-100k/market-metadata?conditionId=0xabc123...' \
  --header 'Accept: application/json'
```bash

## Example Response

```json
{
  "data": {
    "condition_id": "0xabc123456789...",
    "title": "Bitcoin > $100k by EOY 2024",
    "slug": "bitcoin-100k-eoy-2024",
    "short_title": "BTC > $100k",
    "question": "Will Bitcoin (BTC) close above $100,000 USD on or before December 31, 2024?",
    "market_rules": "Resolves to Yes if Bitcoin price is above $100,000 at any point before EOY 2024 according to CoinGecko.",
    "resolution_source": "CoinGecko",
    "resolution_source_url": "https://www.coingecko.com/en/coins/bitcoin",
    "resolver": "0xdef456...",
    "end_time": "2024-12-31T23:59:59.000Z",
    "is_active": true,
    "is_resolved": false,
    "neg_risk": false,
    "neg_risk_market_id": null,
    "volume": 125430.50,
    "volume_24h": 8920.25,
    "condition": {
      "id": "0xabc123456789...",
      "oracle": "0x9876...",
      "question_id": "0xquestion123...",
      "outcome_slot_count": 2,
      "resolved": false,
      "resolution_status": null,
      "resolution_price": null,
      "resolution_flagged": false,
      "resolution_paused": false,
      "resolution_deadline_at": "2025-01-07T23:59:59.000Z",
      "volume": 125430.50,
      "open_interest": 45230.75,
      "active_positions_count": 342
    },
    "outcomes": [
      {
        "token_id": "0xtoken1...",
        "outcome_text": "Yes",
        "outcome_index": 0,
        "is_winning_outcome": false,
        "payout_value": null
      },
      {
        "token_id": "0xtoken2...",
        "outcome_text": "No",
        "outcome_index": 1,
        "is_winning_outcome": false,
        "payout_value": null
      }
    ],
    "created_at": "2024-01-15T10:30:00.000Z",
    "updated_at": "2024-03-03T14:22:00.000Z"
  }
}
```bash

## Error Responses

### 400 Bad Request

```json
{
  "error": "Missing conditionId."
}
```bash

Returned when the `conditionId` query parameter is not provided.

### 404 Not Found

```json
{
  "error": "Event not found."
}
```bash

Returned when the event slug does not exist.

```json
{
  "data": null
}
```bash

Returned when the condition ID is not found within the specified event.

### 500 Internal Server Error

```json
{
  "error": "An unexpected error occurred. Please try again later."
}
```bash

Returned when the server encounters an unexpected error.

## Notes

- The `conditionId` comparison is case-insensitive.
- Condition IDs are normalized to lowercase before matching.
- This endpoint is useful for retrieving full market details including resolution configuration.
- Use this endpoint to check market resolution status and rules before placing trades.
- The resolution deadline typically extends 7 days after the market end time to allow for dispute periods.

Build docs developers (and LLMs) love

Get started for freeTalk to us