webData2 | Hyperliquid Info API
curl --request POST \
--url https://hypercore.goldrushdata.com/info \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "<string>",
"user": "<string>"
}
'import requests
url = "https://hypercore.goldrushdata.com/info"
payload = {
"type": "<string>",
"user": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({type: '<string>', user: '<string>'})
};
fetch('https://hypercore.goldrushdata.com/info', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://hypercore.goldrushdata.com/info",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'type' => '<string>',
'user' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://hypercore.goldrushdata.com/info"
payload := strings.NewReader("{\n \"type\": \"<string>\",\n \"user\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://hypercore.goldrushdata.com/info")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"type\": \"<string>\",\n \"user\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://hypercore.goldrushdata.com/info")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"type\": \"<string>\",\n \"user\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"user": "<string>",
"isVault": true,
"agentAddress": {},
"agentValidUntil": {},
"serverTime": 123,
"cumLedger": "<string>",
"totalVaultEquity": "<string>",
"perpsAtOpenInterestCap": [
"<string>"
],
"twapStates": [
{}
],
"leadingVaults": [
{}
],
"clearinghouseState": {},
"meta": {},
"assetCtxs": [
{}
],
"spotAssetCtxs": [
{}
],
"openOrders": [
{}
]
}Info API
webData2 | Hyperliquid Info API
Hyperliquid webData2: fetch the composite snapshot the Hyperliquid web app uses for a wallet in a single call.
POST
/
info
webData2 | Hyperliquid Info API
curl --request POST \
--url https://hypercore.goldrushdata.com/info \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"type": "<string>",
"user": "<string>"
}
'import requests
url = "https://hypercore.goldrushdata.com/info"
payload = {
"type": "<string>",
"user": "<string>"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({type: '<string>', user: '<string>'})
};
fetch('https://hypercore.goldrushdata.com/info', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://hypercore.goldrushdata.com/info",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'type' => '<string>',
'user' => '<string>'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://hypercore.goldrushdata.com/info"
payload := strings.NewReader("{\n \"type\": \"<string>\",\n \"user\": \"<string>\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://hypercore.goldrushdata.com/info")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"type\": \"<string>\",\n \"user\": \"<string>\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://hypercore.goldrushdata.com/info")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"type\": \"<string>\",\n \"user\": \"<string>\"\n}"
response = http.request(request)
puts response.read_body{
"user": "<string>",
"isVault": true,
"agentAddress": {},
"agentValidUntil": {},
"serverTime": 123,
"cumLedger": "<string>",
"totalVaultEquity": "<string>",
"perpsAtOpenInterestCap": [
"<string>"
],
"twapStates": [
{}
],
"leadingVaults": [
{}
],
"clearinghouseState": {},
"meta": {},
"assetCtxs": [
{}
],
"spotAssetCtxs": [
{}
],
"openOrders": [
{}
]
}Credit Cost
1 per call
Processing
Realtime
type: "webData2" is used to fetch the composite snapshot the Hyperliquid web app uses for a wallet in a single call.
Estimate your monthly cost for this API using the Pricing Calculator.
- Wire-equal to
POST api.hyperliquid.xyz/infowith{"type": "webData2", "user": "0x..."}.
Endpoint
POST https://hypercore.goldrushdata.com/info
Authorization: Bearer <GOLDRUSH_API_KEY>
Content-Type: application/json
Request
Wallet address (lowercase
0x-prefixed 42-character hex). The payload is keyed to this user.Example
curl -X POST https://hypercore.goldrushdata.com/info \
-H "Authorization: Bearer $GOLDRUSH_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"type": "webData2",
"user": "0x31ca8395cf837de08b24da3f660e77761dfb974b"
}'
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: "webData2",
user: "0x31ca8395cf837de08b24da3f660e77761dfb974b",
}),
});
const dashboard = await response.json();
import os, requests
response = requests.post(
"https://hypercore.goldrushdata.com/info",
headers={"Authorization": f"Bearer {os.environ['GOLDRUSH_API_KEY']}"},
json={
"type": "webData2",
"user": "0x31ca8395cf837de08b24da3f660e77761dfb974b",
},
)
dashboard = response.json()
Response
The response is a single composite object. The example below shows one representative element of each array; in practicemeta.universe, assetCtxs, spotAssetCtxs, and openOrders each contain many entries.
{
"user": "0x31ca8395cf837de08b24da3f660e77761dfb974b",
"isVault": true,
"agentAddress": null,
"agentValidUntil": null,
"serverTime": 1781881474980,
"cumLedger": "6332392.6399999997",
"totalVaultEquity": "0.0",
"perpsAtOpenInterestCap": ["CANTO", "FTM", "JELLY"],
"twapStates": [],
"leadingVaults": [],
"clearinghouseState": {
"marginSummary": {
"accountValue": "3007919.6080829999",
"totalNtlPos": "3459573.844978",
"totalRawUsd": "3271201.7188229999",
"totalMarginUsed": "172978.692196"
},
"crossMarginSummary": { "...": "same shape as marginSummary" },
"crossMaintenanceMarginUsed": "...",
"withdrawable": "...",
"time": 1781881474980,
"assetPositions": [
{
"type": "oneWay",
"position": {
"coin": "BTC",
"szi": "-0.67076",
"leverage": { "type": "cross", "value": 20 },
"entryPx": "62884.6",
"positionValue": "42329.65132",
"unrealizedPnl": "-149.163124",
"returnOnEquity": "-0.070726125",
"liquidationPx": "4451986.8072480513",
"marginUsed": "2116.482566",
"maxLeverage": 50,
"cumFunding": {
"allTime": "167037.152562",
"sinceOpen": "-63.255648",
"sinceChange": "0.0"
}
}
}
]
},
"meta": {
"collateralToken": 0,
"marginTables": [],
"universe": [
{ "szDecimals": 5, "name": "BTC", "maxLeverage": 40, "marginTableId": 56 }
]
},
"assetCtxs": [
{
"funding": "0.0000125",
"openInterest": "30871.17824",
"prevDayPx": "63776.0",
"dayNtlVlm": "2564601901.510225296",
"premium": "-0.000633553",
"oraclePx": "63136.0",
"markPx": "63107.0",
"midPx": "63095.5",
"impactPxs": ["63095.0", "63096.0"],
"dayBaseVlm": "40824.8194300001"
}
],
"spotAssetCtxs": [
{
"coin": "PURR/USDC",
"prevDayPx": "0.094397",
"dayNtlVlm": "1940712.1805890012",
"markPx": "0.10119",
"midPx": "0.101275",
"circulatingSupply": "595243631.3874200583",
"totalSupply": "595243637.9101999998",
"dayBaseVlm": "20336991.0"
}
],
"openOrders": [
{
"coin": "APE",
"side": "A",
"limitPx": "0.13155",
"sz": "5187.6",
"oid": 473960008142,
"timestamp": 1781881474980,
"triggerCondition": "N/A",
"isTrigger": false,
"triggerPx": "0.0",
"children": [],
"isPositionTpsl": false,
"reduceOnly": false,
"orderType": "Limit",
"origSz": "5187.6",
"tif": "Alo",
"cloid": null
}
]
}
Field descriptions
All numeric balances, prices, and sizes are returned as decimal strings with full upstream precision. Do not parse them as floats - keep them as strings or use a fixed-precision decimal type. Timestamps (
serverTime, time, timestamp) are integer Unix milliseconds.Cumulative non-funding ledger total for the wallet, in USDC. Tracks net deposits/withdrawals/transfers across time.
Sum of all vault equity the wallet leads (when
isVault or a vault leader). "0.0" when the wallet leads no vaults.List of perp
coin symbols currently at their open-interest cap. Useful for surfacing “no new shorts/longs” UI states.Vaults the wallet leads, each with vault address and current equity. Empty array when the wallet leads no vaults.
Perpetuals account state - identical to the response shape of
clearinghouseState. Contains marginSummary, crossMarginSummary, crossMaintenanceMarginUsed, withdrawable, time, and assetPositions[].Perp universe metadata - identical to the response shape of
meta. Contains universe[] ({name, szDecimals, maxLeverage, marginTableId}), marginTables[], and collateralToken.Live per-perp market context, ordered to align with
meta.universe. Each entry carries funding, openInterest, markPx, oraclePx, midPx, impactPxs, premium, prevDayPx, dayNtlVlm, and dayBaseVlm.Live per-spot-pair market context. Each entry carries
coin (the spot pair symbol), markPx, midPx, prevDayPx, dayNtlVlm, dayBaseVlm, circulatingSupply, and totalSupply.The wallet’s open orders with full trigger metadata - identical to the response shape of
frontendOpenOrders. Each entry includes coin, side, limitPx, sz, oid, timestamp, triggerCondition, isTrigger, triggerPx, children, isPositionTpsl, reduceOnly, orderType, origSz, tif, and cloid.Related endpoints
activeAssetData
fetch a user’s active trading limits, leverage setting, available size, and mark price for a single Hyperliquid perpetual…
allMids
fetch the current mid price for every actively traded asset in a single call.
allPerpMetas
fetch the perpetuals metadata — universe definitions and margin tables — for every perp DEX in a single request.
/info and /ws APIs at hypercore.goldrushdata.com, with no rate limits and every fill, order, trade, funding and ledger event retained from the start of HyperCore coverage.
Last reviewed: 2026-06-19