Get HIP-3 oracle discovery bounds

{ "success": true, "data": { "symbol": "km:US500", "reference_price": 752.24, "reference_source": "external", "max_leverage": 20, "bound_fraction": 0.05, "lower_bound": 714.628, "upper_bound": 789.852, "block_number": 1038634032, "timestamp": 1781678086894 }, "meta": { "count": 123, "next_cursor": "<string>", "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a" } }

Authorizations

X-API-Key

string

header

required

API key for authentication. Get yours at https://www.0xarchive.io/dashboard/

Path Parameters

symbol

string

required

HIP-3 symbol with builder prefix. Case-sensitive.

Example:

"km:US500"

Response

HIP-3 oracle discovery bounds

API response containing HIP-3 oracle discovery bounds.

success

boolean

Example:

true

data

object

Instantaneous HIP-3 discovery bounds derived from the current reference price and max leverage.

Hide child attributes

data.symbol

string

required

HIP-3 symbol.

Example:

"km:US500"

data.reference_price

number

required

External price when available, otherwise mark price.

Example:

752.24

data.reference_source

enum<string>

required

Price source used for the bounds.

Available options:

external,

mark

Example:

"external"

data.max_leverage

integer

required

Market max leverage used for the bound fraction.

Example:

20

data.bound_fraction

number

required

Fraction applied on each side of reference_price.

Example:

0.05

data.lower_bound

number

required

Instantaneous lower discovery bound.

Example:

714.628

data.upper_bound

number

required

Instantaneous upper discovery bound.

Example:

789.852

data.block_number

integer<int64>

required

Source block number.

Example:

1038634032

data.timestamp

integer<int64>

required

Source timestamp in Unix milliseconds.

Example:

1781678086894