---
title: "Get API public v1 hip4 odds"
method: GET
path: "/api/public/v1/hip4/odds"
---

# Get API public v1 hip4 odds

`GET /api/public/v1/hip4/odds`

## Request

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

## Query parameters

- `limit` integer
- `offset` integer
- `questionId` integer

## Response `200`

OK

- Hip4OddsBoard
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `asOf` string, date-time, nullable, required: Time the mids snapshot was fetched.
  - `count` integer, required
  - `limit` integer, required
  - `nextOffset` integer, nullable, required
  - `offset` integer, required
  - `outcomes` HIP4OddsItem[], nullable, required
    - `live` boolean, nullable, required: Null when current listing status cannot be determined.
    - `name` string
    - `outcomeId` integer, required
    - `questionId` integer
    - `quoteToken` string
    - `sides` Hip4OddsSide[], nullable, required
      - `assetId` integer, required
      - `coinKey` string, required
      - `index` integer, required
      - `mid` number, double, nullable, required: Hyperliquid mid (market-implied probability); null when unavailable.
      - `name` string, required
      - `sideToken` string, required
  - `stale` boolean, required
  - `total` integer, required
  - `warnings` string[], nullable

## 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/odds/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)
