> ## Documentation Index
> Fetch the complete documentation index at: https://goldrush.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# settledOutcome | Hyperliquid Info API

> Hyperliquid settledOutcome: retrieve resolution details for a settled HIP-4 binary outcome market on HyperCore.

> [card] Credit Cost
>
> 1 per call

> [card] Processing
>
> Realtime

The Hyperliquid info endpoint with `type: "settledOutcome"` is used to retrieve resolution details for a settled HIP-4 binary outcome market on HyperCore.

> [!TIP]
>
> Estimate your monthly cost for this API using the [Pricing Calculator](https://goldrush.dev/docs/pricing-calculator.md?endpoint=%2Fapi-reference%2Fhyperliquid-info%2Fsettled-outcome).

> [!NOTE]
>
> * Wire-equal to `POST api.hyperliquid.xyz/info` with `{"type": "settledOutcome", "outcome": <int>}`.

Returns the on-chain settlement data for a single settled HIP-4 outcome: the integer outcome ID, the resolved side, the resolution price, and the settlement timestamp.

Use this once an outcome has resolved to confirm which side paid out and reconcile against your own books.

## Endpoint

```
POST https://hypercore.goldrushdata.com/info
Authorization: Bearer <GOLDRUSH_API_KEY>
Content-Type: application/json
```

## Request

**type** `string` *required*

Always `"settledOutcome"`.

**outcome** `int` *required*

Integer outcome ID for the settled HIP-4 market. Outcome IDs are stable across the market's lifecycle - the same ID returned by `outcomeMeta` while live is queried here once the outcome has resolved.

### Example

```bash cURL theme={null}
curl -X POST https://hypercore.goldrushdata.com/info \
  -H "Authorization: Bearer $GOLDRUSH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "settledOutcome",
    "outcome": 1
  }'
```

```typescript TypeScript theme={null}
const response = await fetch("https://hypercore.goldrushdata.com/info", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.GOLDRUSH_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    type: "settledOutcome",
    outcome: 1,
  }),
});

const settlement = await response.json();
```

```python Python theme={null}
import os, requests

response = requests.post(
    "https://hypercore.goldrushdata.com/info",
    headers={"Authorization": f"Bearer {os.environ['GOLDRUSH_API_KEY']}"},
    json={
        "type": "settledOutcome",
        "outcome": 1,
    },
)

settlement = response.json()
```

## Response

```json theme={null}
{
  "spec": {
    "outcome": 1,
    "name": "Recurring",
    "description": "class:priceBinary|underlying:BTC|expiry:20260504-0600|targetPrice:78213|period:1d",
    "sideSpecs": [
      { "name": "Yes" },
      { "name": "No" }
    ],
    "quoteToken": "USDH"
  },
  "settleFraction": "1.0",
  "details": "price:79980"
}
```

For question-class outcomes (free-form markets resolved by an oracle question), the response also includes a `question` object:

```json theme={null}
{
  "spec": {
    "outcome": 100,
    "name": "Fallback",
    "description": "",
    "sideSpecs": [{ "name": "Yes" }, { "name": "No" }],
    "quoteToken": "USDC"
  },
  "settleFraction": "0.0",
  "details": "",
  "question": {
    "question": {
      "settled": 19,
      "name": "May CPI year-over-year",
      "description": "The question resolves by assigning Yes to exactly one of …"
    }
  }
}
```

### Field descriptions

> [!NOTE]
>
> `settleFraction` is returned as a **decimal string** with full upstream precision. Do not parse it as a float - keep it as a string or use a fixed-precision decimal type.

**spec** `object`

Original market specification for the outcome - the same shape `outcomeMeta` returns while the market is live.

**properties**

**outcome** `int`

Integer outcome ID. Echoes the request parameter.

**name** `string`

Human-readable label for the market - for example, `"Recurring"` for repeating price-binary markets.

**description** `string`

For `priceBinary` markets, a pipe-delimited spec (`class:…|underlying:…|expiry:…|targetPrice:…|period:…`). Empty string for `question`-class outcomes.

**sideSpecs** `array\<object\>`

Tradeable sides of the outcome. For binary outcomes, index 0 is `Yes` and index 1 is `No`.

**properties**

**name** `string`

Side label - typically `"Yes"` or `"No"`.

**quoteToken** `string`

Symbol of the token the market quotes against - typically `"USDC"` or `"USDH"`.

**settleFraction** `string`

The fraction the `Yes` side (index 0) paid out at resolution, as a decimal string. `"1.0"` means `Yes` won outright, `"0.0"` means `No` won, fractional values indicate a partial settlement.

**details** `string`

Free-form resolution detail. For `priceBinary` markets, contains the resolved underlying value (e.g. `"price:79980"`). Empty string when settlement detail is carried in the `question` object instead.

**question** `object`

Optional. Present only for question-class outcomes. Wraps the structured oracle question that produced the resolution.

**properties**

**question** `object`

**properties**

**settled** `int`

Encoded settlement side (`19` is observed for `No`-resolved questions in current data).

**name** `string`

Short label for the question.

**description** `string`

Full question description, including resolution criteria and fallback rules.

## Related endpoints

> [card] [outcomeMeta](https://goldrush.dev/docs/api-reference/hyperliquid-info/outcome-meta.md)
>
> enumerate all active HIP-4 binary outcome markets on HyperCore.

> [card] [metaAndAssetCtxs](https://goldrush.dev/docs/api-reference/hyperliquid-info/meta-and-asset-ctxs.md)
>
> fetch the full Hyperliquid perpetuals market universe with live per-asset trading context.

> [card] [spotMetaAndAssetCtxs](https://goldrush.dev/docs/api-reference/hyperliquid-info/spot-meta-and-asset-ctxs.md)
>
> fetch the spot universe metadata, token configuration, and live market data in a single call.

See all Hyperliquid endpoints: [Overview hub](https://goldrush.dev/docs/goldrush-hyperliquid/overview.md) · [Info API reference](https://goldrush.dev/docs/goldrush-hyperliquid/info-api/overview.md)

*Last reviewed: 2026-06-19*


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.