Hypurracle Documentation

1. Getting Started

Hypurracle provides a simple and secure way to access Hyperliquid price data across chains. Follow these steps to integrate Hypurracle into your project:

  1. Make your first API call (see API Reference below)
  2. Call `updatePrice` on the Hypurracle contract (see Contract Addresses below)
  3. Query the price data in your smart contract (specifying a maximum delay)

2. API Reference

Use the following endpoint to query price data:

curl 'https://api.hypurracle.xyz/read?feeds%5B0%5D=HYPE-SPOT&feeds%5B1%5D=PURR-SPOT'

Example response:

{
  "HYPE-SPOT":{
    "feed":"HYPE-SPOT",
    "timestamp":"1737058579",
    "price":"23660500000000000000",
    "signature":"0x80bd212fdb54..."
  }
  "PURR-SPOT":{
    "feed":"PURR-SPOT",
    "timestamp":"1737058579",
    "price":"233425000000000000",
    "signature":"0xea266d36f808..."
  }
}

Input Parameters

ParameterDescription
feedsArray of feed names, e.g. ["HYPE-SPOT", "PURR-SPOT"]. If none is provided, all feeds will be returned.

Output Fields

FieldDescription
feedThe name of the feed
timestampUnix timestamp of the price update
priceThe price of the feed
signatureCryptographic signature for verification

3. Contract Addresses

Use these contract addresses to interact with Hypurracle on different chains:

ChainChain IDAddress
Arbitrum42161TBD
Arbitrum-Sepolia421614https://sepolia.arbiscan.io/address/0xB1018403D9569f8FE6A98d728Bc7641c320c64DD
Hyperliquid-Testnet1337TBD