# Prediction Candles

{% hint style="info" %}
This endpoint is new and currently considered to be "experimental." 
{% endhint %}

{% hint style="warning" %}
The "Test it" functionality requires providing an API key in the Authorization Header. You can acquire a free API key by "purchasing" the free tier of the SVS API at <https://cloud.solanavibestation.com>
{% endhint %}

## Get Prediction Market Candles

> Retrieve 72-hour OHLCV candle data for specified prediction markets. Returns open, high, low, close prices and volume for each market, broken down by buy/sell and yes/no sides.<br>

````json
{"openapi":"3.1.0","info":{"title":"Solana Vibe Station API","version":"0.2.0"},"servers":[{"url":"https://free.api.solanavibestation.com"}],"security":[{},{"AuthHeader":[]},{"URLParameter":[]}],"components":{"securitySchemes":{"AuthHeader":{"type":"apiKey","in":"header","name":"Authorization","description":"Authorization header for API key authentication.\n\n**Example:**\n```\nAuthorization: your-api-key-here\n```\n"},"URLParameter":{"type":"apiKey","in":"query","name":"api_key","description":"API key passed as a URL parameter for authentication.\n\n**Example:**\n```\nhttps://free.api.solanavibestation.com/metadata?api_key=your-api-key-here\n```\n"}},"schemas":{"PredictionCandleRequest":{"type":"object","description":"Request for prediction market candle data","required":["market_ids"],"properties":{"market_ids":{"type":"array","description":"Array of prediction market identifiers to retrieve candle data for","items":{"type":"string","description":"Prediction market identifier"}}}},"PredictionCandleResponse":{"type":"object","description":"Response containing prediction market candle data","required":["candles"],"properties":{"candles":{"type":"object","description":"Map of market identifiers to their candle data arrays","additionalProperties":{"type":"array","items":{"$ref":"#/components/schemas/PredictionCandle72h"}},"propertyNames":{"type":"string"}}}},"PredictionCandle72h":{"type":"object","description":"72-hour OHLCV candle data for a prediction market","required":["market_id","is_buy","is_yes","o_72h","h_72h","l_72h","c_72h","v_72h"],"properties":{"market_id":{"type":"string","description":"Unique identifier for the prediction market"},"is_buy":{"type":"boolean","description":"Whether this candle represents buy-side activity"},"is_yes":{"type":"boolean","description":"Whether this candle represents the yes outcome"},"o_72h":{"type":"number","format":"double","description":"Opening price over the 72-hour period"},"h_72h":{"type":"number","format":"double","description":"Highest price over the 72-hour period"},"l_72h":{"type":"number","format":"double","description":"Lowest price over the 72-hour period"},"c_72h":{"type":"number","format":"double","description":"Closing price over the 72-hour period"},"v_72h":{"type":"number","format":"double","description":"Trading volume over the 72-hour period"}}},"PredictionCandleRequestError":{"oneOf":[{"type":"object","required":["InvalidInput"],"properties":{"InvalidInput":{"type":"string","description":"Error message for invalid input format"}}},{"type":"object","required":["TooManyMarkets"],"properties":{"TooManyMarkets":{"type":"string","description":"Error message when too many markets are requested in a single call"}}}]}}},"paths":{"/prediction/candles":{"post":{"operationId":"prediction_candles","summary":"Get Prediction Market Candles","description":"Retrieve 72-hour OHLCV candle data for specified prediction markets. Returns open, high, low, close prices and volume for each market, broken down by buy/sell and yes/no sides.\n","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PredictionCandleRequest"}}},"required":true},"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PredictionCandleResponse"}}}},"400":{"description":"Invalid input","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PredictionCandleRequestError"}}}},"401":{"description":"Unauthorized","content":{"text/plain":{"schema":{"type":"string"}}}},"403":{"description":"Forbidden","content":{"text/plain":{"schema":{"type":"string"}}}},"429":{"description":"Too Many Requests","content":{"text/plain":{"schema":{"type":"string"}}}},"500":{"description":"Internal Server Error","content":{"text/plain":{"schema":{"type":"string"}}}}}}}}}
````


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.solanavibestation.com/developers/partner-marketplace/svs-api/prediction-candles.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.