---
title: "Get API public v1 hip4 outcomes by outcome ID odds history"
method: GET
path: "/api/public/v1/hip4/outcomes/{outcome_id}/odds-history"
---

# Get API public v1 hip4 outcomes by outcome ID odds history

`GET /api/public/v1/hip4/outcomes/{outcome_id}/odds-history`

## Request

- Base URL: `https://api.coinversa.ai`
- URL: `https://api.coinversa.ai/api/public/v1/hip4/outcomes/{outcome_id}/odds-history`
- Auth: API key in header `X-API-Key`

## Path parameters

- `outcome_id` integer, required

## Query parameters

- `interval` '5m' | '1h' | '1d'
- `hours` integer: Defaults to 24/168/720 and is capped at 48/720/2160 hours for 5m/1h/1d.

## Response `200`

OK

- Hip4OddsHistory
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `hours` integer, required
  - `interval` string, required
  - `outcomeId` integer, required
  - `quoteToken` string
  - `sides` Hip4OddsHistorySide[], nullable, required: Executed-trade candles, oldest first. Empty buckets are omitted.
    - `assetId` integer, required
    - `candles` Hip4OddsCandle[], nullable, required
      - `close` number, double, required
      - `contracts` number, double, required
      - `fills` integer, required
      - `high` number, double, required
      - `low` number, double, required
      - `notional` number, double, required: In the outcome's quote token.
      - `open` number, double, required
      - `time` string, date-time, required
      - `vwap` number, double, required
    - `coinKey` string, required
    - `index` integer, required
    - `name` string, required
    - `sideToken` string, required
  - `since` string, date-time, required

## Other responses

- `400`: Bad Request
- `403`: Forbidden
- `422`: Unprocessable Entity
- `429`: Too Many Requests
- `500`: Internal Server Error
- `504`: Gateway Timeout

## Changes

- **2026-11-20** `16561f501ad7`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/coinversa/apis/coinversa-api/changes/api/public/v1/hip4/outcomes/:outcome_id/odds-history/get.md)

---

[API](https://skmtc.dev/coinversa/apis/coinversa-api.md) - [All operations](https://skmtc.dev/coinversa/apis/coinversa-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coinversa/apis/coinversa-api/revisions/16561f501ad7?raw)
