Get Market Metadata

Retrieve detailed metadata for a specific market within an event

GET /api/events/{slug}/market-metadata

Get Market Metadata

cURL

curl --request GET \
  --url https://api.example.com/api/events/{slug}/market-metadata

200

{
  "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.