Skip to content

Crypto market pulse

$0.004 per callUSDC via x402POST /api/crypto-market-pulse

One-call market snapshot across every perpetual listed on Hyperliquid: breadth (advancers, decliners, unchanged, mean/median and volume-weighted 24h change), total open interest and 24h volume, top markets by volume, top gainers and losers, highest and lowest funding, and BTC/ETH at a glance. limit caps each list (max 20); minVolumeUsd (default 1,000,000) filters illiquid markets out of the lists and breadth. Send POST /api/crypto-market-pulse with no required fields (2 optional) and pay $0.004 per call over x402 or MPP (there is no free tier). It returns a JSON object with source, markets, breadth, totals, funding and 7 more.

Pure arithmetic over public data, no key, no LLM.

Category: Crypto & onchain dataTags: crypto market breadth gainers losers funding open-interest signals

Try in playground →

Parameters

NameTypeRequiredDescription
limitnumbernoRows per list (default 10, max 20).
minVolumeUsdnumbernoMinimum 24h notional volume in USD for a market to count (default 1000000, 0 = all).

Example request

curl -i -X POST https://agent402.tools/api/crypto-market-pulse \
  -H "Content-Type: application/json" \
  -d '{"limit":5}'

Without payment this returns HTTP 402 Payment Required with the exact price for crypto-market-pulse; any x402 v2 or MPP client pays it and retries.

Watch a call get paid

RequestPOST /api/crypto-market-pulse
402$0.004 USDC
SignPAYMENT-SIGNATURE
Settleon 14 chains
Answer200 OK
ReceiptAgent402-ReceiptEd25519

Example response

{
  "source": "hyperliquid",
  "markets": {
    "listed": 230,
    "counted": 120,
    "minVolumeUsd": 1000000
  },
  "breadth": {
    "advancers": 80,
    "decliners": 35,
    "unchanged": 5,
    "advancersPct": 66.67,
    "meanChange24hPct": 1.42,
    "medianChange24hPct": 0.95,
    "volumeWeightedChange24hPct": 0.61
  },
  "totals": {
    "openInterestUsd": 9100000000,
    "volume24hUsd": 12500000000,
    "top5VolumeSharePct": 71.2
  },
  "funding": {
    "positive": 90,
    "negative": 25,
    "zero": 5,
    "meanAprPct": 8.4
  },
  "majors": {
    "BTC": {
      "markPx": 77244,
      "change24hPct": 0.36,
      "fundingAprPct": 10.95,
      "openInterestUsd": 2776803000,
      "volume24hUsd": 4679441788.67
    },
    "ETH": {
      "markPx": 2429.3,
      "change24hPct": 2.06,
      "fundingAprPct": -4.38,
      "openInterestUsd": 1832000000,
      "volume24hUsd": 3396726206.45
    }
  },
  "topByVolume": [
    {
      "coin": "BTC",
      "markPx": 77244,
      "change24hPct": 0.36,
      "volume24hUsd": 4679441788.67,
      "openInterestUsd": 2776803000,
      "fundingAprPct": 10.95
    }
  ],
  "topGainers": [
    {
      "coin": "SOL",
      "markPx": 180.2,
      "change24hPct": 8.1,
      "volume24hUsd": 900000000,
      "openInterestUsd": 500000000,
      "fundingAprPct": 20.1
    }
  ],
  "topLosers": [
    {
      "coin": "DOGE",
      "markPx": 0.21,
      "change24hPct": -4.2,
      "volume24hUsd": 300000000,
      "openInterestUsd": 200000000,
      "fundingAprPct": -3.2
    }
  ],
  "highestFunding": [
    {
      "coin": "SOL",
      "fundingHourly": 0.0000229,
      "fundingAprPct": 20.1,
      "change24hPct": 8.1,
      "openInterestUsd": 500000000
    }
  ],
  "lowestFunding": [
    {
      "coin": "ETH",
      "fundingHourly": -0.000005,
      "fundingAprPct": -4.38,
      "change24hPct": 2.06,
      "openInterestUsd": 1832000000
    }
  ],
  "fetchedAt": "2026-08-22T12:05:00.000Z"
}
FieldTypeAlways presentIn the example
sourcestringyeshyperliquid
marketsobjectyes3 fields: listed, counted, minVolumeUsd
breadthobjectyes7 fields: advancers, decliners, unchanged, advancersPct and 3 more
totalsobjectyes3 fields: openInterestUsd, volume24hUsd, top5VolumeSharePct
fundingobjectyes4 fields: positive, negative, zero, meanAprPct
majorsobjectyes2 fields: BTC, ETH
topByVolumearray of objectsyes1 item in the example
topGainersarray of objectsyes1 item in the example
topLosersarray of objectsyes1 item in the example
highestFundingarray of objectsyes1 item in the example
lowestFundingarray of objectsyes1 item in the example
fetchedAtstringyes2026-08-22T12:05:00.000Z

From an MCP client

catalog.call {
  "slug": "crypto-market-pulse",
  "params": {
    "limit": 5
  }
}

The hosted connector at https://agent402.tools/mcp needs a payment for crypto-market-pulse; the stdio package pays it from a wallet or from an AGENT402_CREDITS_KEY issued earlier. Local install: npx -y agent402-mcp@0.14.0.

Errors and behavior

Paid call (JavaScript agent)

import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
client.setSpendControls?.({ maxAmountPerPayment: "$0.004" }); // refuse any quote above this tool's price
registerExactEvmScheme(client, { signer: privateKeyToAccount(KEY) });
const payFetch = wrapFetchWithPayment(fetch, client);

const res = await payFetch("https://agent402.tools/api/crypto-market-pulse", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "limit": 5
  }),
});

Related tools

Perp markets snapshot

$0.003POST /api/perp-markets

Snapshot of every listed perpetual on Hyperliquid in one call: mark and oracle price, 24h change, hourly funding (plus.

Crypto technical indicators

$0.002POST /api/crypto-indicators

Technical indicators for one perpetual computed deterministically from Hyperliquid candles: RSI(14), MACD(12,26,9).

Perp funding rate and history

$0.002POST /api/perp-funding

Current funding rate for one perpetual (hourly, per 8h and annualized) plus the last N hourly funding prints.

Perp open interest

$0.001POST /api/perp-open-interest

Open interest for perpetuals in coins and USD notional.

Crypto news headlines

$0.001POST /api/crypto-news

Latest crypto headlines aggregated from the public RSS/Atom feeds of 8 major outlets (coindesk, cointelegraph, decrypt.

Funding rate screener across venues

$0.005GET /api/funding-screener

Perpetual funding for one coin across every listed derivatives venue, computed in one call: open-interest-weighted.