# registeredOutcomes - Active HIP-4 Outcomes

Use `registeredOutcomes` to list recent HIP-4 outcome registrations that have not settled yet.

## Endpoints

REST-style Info API:

```text
POST https://api-hyperliquid-index.n.dwellir.com/YOUR_API_KEY/info
```

JSON-RPC:

```text
POST https://api-hyperliquid-index.n.dwellir.com/YOUR_API_KEY/jsonrpc
```

## Billing

`registeredOutcomes` responses are billed by the number of outcome objects returned. Empty arrays are billed as `0` responses/API credits.

## Request Parameters

- `type` (`string, required`): Must be registeredOutcomes for /info REST requests. Omit this field for JSON-RPC.
- `name` (`string, optional`): Optional exact outcome name filter.
- `class` (`string, optional`): Optional class filter, for example priceBinary.
- `underlying` (`string, optional`): Optional underlying asset filter, for example BTC.
- `period` (`string, optional`): Optional recurrence filter, for example 1d.
- `limit` (`number, optional`): Maximum rows to return, capped at 50.

## Request Example

```bash
curl -X POST "https://api-hyperliquid-index.n.dwellir.com/YOUR_API_KEY/info" \
  -H "content-type: application/json" \
  -d '{
  "type": "registeredOutcomes",
  "underlying": "BTC",
  "period": "1d",
  "limit": 10
}'
```

## Response Fields

- `outcomes` (`array, required`): Array of active registered outcome objects. Billing counts one response/API credit per outcome object returned.
- `outcomeId` (`number, required`): Outcome ID.
- `yesAssetId` (`string, required`): Encoded Yes asset ID, for example
- `noAssetId` (`string, required`): Encoded No asset ID, for example
- `yesStats` (`object, required`): Fill-derived statistics for the Yes asset.
- `noStats` (`object, required`): Fill-derived statistics for the No asset.

## Successful Response

```json
[
  {
    "outcomeId": 3,
    "name": "Recurring",
    "description": "class:priceBinary|underlying:BTC|expiry:20260506-0600|targetPrice:80930|period:1d",
    "class": "priceBinary",
    "underlying": "BTC",
    "expiry": "20260506-0600",
    "targetPrice": "80930",
    "period": "1d",
    "quoteToken": "150",
    "yesAssetId": "#30",
    "noAssetId": "#31",
    "yesStats": { "coin": "#30", "volumeNotional": "0", "volumeContracts": "0", "lastPrice": "0" },
    "noStats": { "coin": "#31", "volumeNotional": "0", "volumeContracts": "0", "lastPrice": "0" }
  }
]
```

## Error Responses

### Error

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid request"
  }
}
```

## Response

REST `/info` responses return an array directly. JSON-RPC responses return the same array under `result`.