Skip to content
clusters: prooflayer · edgemarket · edgefinance · synthforge · mediakit · wordmint · webprobe · locale · comppoint
$ man hyperliquid-perps

/hyperliquid-perps

agentutility / edge-market / hyperliquid-perps
PRICE / CALL
$0.005
USDC · base mainnet · scheme: exact
METHOD
POST
CLUSTER
edgemarket
CATEGORY
uncategorized
STATUS
live
NAME
hyperliquid-perps hyperliquid perps market data / perpetual futures market lookup / crypto derivatives feed
SYNOPSIS
POST https://x402.agentutility.ai/hyperliquid-perps
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }
↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.
DESCRIPTION

Hyperliquid perps market data / perpetual futures market lookup / crypto derivatives feed. Read-only public Hyperliquid info API wrapper returning active markets, mark prices, size decimals, max leverage, and margin table ids. No trading, private wallet data, or order routing.

INPUTrequest schema
propertytypedescriptionreq?
marketstringHyperliquid market or symbol, e.g. 'BTC', 'ETH', or 'SOL'.optional
modestringLookup mode. Only read-only market data is enabled. Default 'market'.
enum: market
optional
limitnumberMaximum records to return. Suggested range 1-50.optional
OUTPUTresponse shape
fieldtypedescription
marketstring
mark_pricestring
size_decimalsstring
max_leveragestring
margin_table_idstring
sourcestring
EXAMPLEStwo ways to call
EXAMPLE 1 · curl
curl -X POST https://x402.agentutility.ai/hyperliquid-perps \
  -H 'Content-Type: application/json' \
  -d '{ }'
first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.
EXAMPLE 2 · mcp
# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the hyperliquid-perps tool from your MCP-aware agent.
MCP server handles payment automatically — your coding agent just calls the tool by name.
METADATA
tags
edge-markethyperliquidperpshyperliquid-perps
methods
POST
cluster
edgemarket
price
$0.005 USDC per call
ADJACENTother endpoints in edgemarket
endpointdescriptionprice
agent-card-resolveAgent card resolver / ERC-8004 Identity Registry lookup / Trustless Agents / agentId → owner + agentURI / A2A identity / agent.json fetch…$0.005
arbitrage-spreadCross-exchange arbitrage spread / max-min price / CEX price dispersion / spread % calculator.$0.005
basename-resolveBasename resolver / Coinbase Basenames / .base.eth lookup / Base name service / on-chain name resolution.$0.005
defi-yield-poolsDeFi yield pools / APY aggregator / yield-farming opportunities / DeFiLlama yields / cross-protocol APY ranking / stablecoin yields / LP…$0.005
ipfsIPFS API / IPFS fetch / IPFS content retrieval / CID resolver.$0.005
ipfs-fetchIPFS fetch / IPFS gateway / Web3 storage retrieval / NFT metadata fetcher / Filecoin gateway / decentralized content / pinned-content reader.$0.005
ipfs-gatewayIPFS gateway fetcher / CID gateway resolver / decentralized file retrieval.$0.005
price-impactPrice-impact / slippage estimator / DEX swap size impact / size-keyed quote / depth simulation.$0.005
SEE ALSO
agentutility · edgemarket · x402 · mcp · llms.txt · registry.json · bazaar.x402.org