> ## Documentation Index
> Fetch the complete documentation index at: https://chainstack-docs-polygon-erigon-trace-deprecation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# settledOutcome | Hyperliquid info

> The info endpoint with type: "settledOutcome" retrieves the specification and settlement details for an outcome market by its outcome identifier.

<Info>
  This method is available on Chainstack. Not all Hyperliquid methods are available on Chainstack, as the open-source node implementation does not support them yet — see [Hyperliquid methods](/docs/hyperliquid-methods) for the full availability breakdown.
</Info>

The `info` endpoint with `type: "settledOutcome"` retrieves the specification and settlement details for an outcome market, identified by its `outcome` index. Outcome markets are binary (Yes/No) prediction markets on Hyperliquid. Use this method to read an outcome's definition and how it settled.

## Parameters

### Request body

* `type` (string, required) — The request type. Must be `"settledOutcome"`.
* `outcome` (integer, required) — The outcome identifier.

## Response

Returns a settled outcome object, or `null` if the outcome is not settled.

* `spec` (object) — The outcome specification:
  * `outcome` (integer) — The outcome identifier.
  * `name` (string) — The name of the outcome.
  * `description` (string) — The description of the outcome.
  * `sideSpecs` (array) — The side specifications, each with a `name` and an optional `token`.
  * `quoteToken` (string) — The quote token for this outcome.
* `settleFraction` (string) — The settlement fraction.
* `details` (string) — The settlement details.

## Example request

<CodeGroup>
  ```shell Shell theme={null}
  curl -X POST \
    -H "Content-Type: application/json" \
    -d '{"type": "settledOutcome", "outcome": 0}' \
    https://hyperliquid-mainnet.core.chainstack.com/4f8d8f4040bdacd1577bff8058438274/info
  ```

  ```python Python (hyperliquid-python-sdk) theme={null}
  from hyperliquid.info import Info

  # skip_ws=True avoids opening a WebSocket connection for this REST call
  info = Info("YOUR_CHAINSTACK_ENDPOINT", skip_ws=True)

  # The SDK has no dedicated settledOutcome helper, so post the request directly.
  settled_outcome = info.post("/info", {"type": "settledOutcome", "outcome": 0})
  print(settled_outcome)
  ```

  ```typescript TypeScript (@nktkas/hyperliquid) theme={null}
  import { HttpTransport, InfoClient } from "@nktkas/hyperliquid";

  // apiUrl points the transport at a custom server (your Chainstack endpoint)
  const transport = new HttpTransport({ apiUrl: "YOUR_CHAINSTACK_ENDPOINT" });
  const info = new InfoClient({ transport });

  const settledOutcome = await info.settledOutcome({ outcome: 0 });
  console.log(settledOutcome);
  ```
</CodeGroup>

<Note>
  **Use your own endpoint in your code.** The code examples use a placeholder Chainstack endpoint (YOUR\_CHAINSTACK\_ENDPOINT) — replace it with your own Hyperliquid node endpoint from the [Chainstack console](https://console.chainstack.com/). The curl above uses a shared public endpoint for quick checks only; do not use it in production.
</Note>

## Example response

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

## Use cases

The `info` endpoint with `type: "settledOutcome"` is useful for:

* Reading the definition of an outcome market (underlying, target price, expiry)
* Checking how an outcome settled and its settlement fraction
* Building prediction-market dashboards and settlement reports


## OpenAPI

````yaml openapi/hyperliquid_node_api/hypercore_info/info_settled_outcome.json post /4f8d8f4040bdacd1577bff8058438274/info
openapi: 3.0.0
info:
  title: Hyperliquid Node API
  version: 1.0.0
  description: This is an API for interacting with Chainstack Hyperliquid node.
servers:
  - url: https://hyperliquid-mainnet.core.chainstack.com
security: []
paths:
  /4f8d8f4040bdacd1577bff8058438274/info:
    post:
      tags:
        - hyperliquid operations
      summary: info (settledOutcome)
      operationId: infoSettledOutcome
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                type:
                  type: string
                  description: Request type
                  default: settledOutcome
                  enum:
                    - settledOutcome
                outcome:
                  type: integer
                  description: Outcome identifier.
                  default: 0
              required:
                - type
                - outcome
      responses:
        '200':
          description: >-
            Information about a settled outcome, or null if the outcome is not
            settled
          content:
            application/json:
              schema:
                type: object
                nullable: true
                properties:
                  spec:
                    type: object
                    description: Outcome specification.
                    properties:
                      outcome:
                        type: integer
                        description: Outcome identifier.
                      name:
                        type: string
                        description: Name of the outcome.
                      description:
                        type: string
                        description: Description of the outcome.
                      sideSpecs:
                        type: array
                        description: Side specifications for this outcome.
                        items:
                          type: object
                          properties:
                            name:
                              type: string
                              description: Name of the side.
                            token:
                              type: integer
                              description: Token identifier for this side.
                      quoteToken:
                        type: string
                        description: Quote token for this outcome.
                  settleFraction:
                    type: string
                    description: Settlement fraction.
                  details:
                    type: string
                    description: Settlement details.

````