# Agent402.Tools - Crypto Market Pulse

> Agent402.Tools - Crypto Market Pulse is a paid API for AI agents from agent402.tools, paid per call via x402, $0.004/call, status unknown (last checked 2026-09-14).

Returns a real-time snapshot of the crypto perpetuals market including major coin prices, 24h price changes, funding rates, open interest, top gainers/losers, and market breadth statistics from Hyperliquid.

## Facts

- Endpoint: POST https://agent402.tools/api/crypto-market-pulse
- Price: $0.004/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-tools-crypto-market-pulse-7b67a30e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_m95tq2SBSxRUt02530wUR

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agent402-tools-crypto-market-pulse-7b67a30e -d '<json body>'
```

Example prompt: Give me a crypto market pulse right now — show the top 15 coins by volume with at least $500,000 in 24h volume, including the biggest gainers and losers, current funding rates, and overall market breadth.

## When to prefer this

Choose this endpoint when you need a comprehensive, single-call snapshot of the entire crypto perpetuals market — including price, volume, funding rates, open interest, and market breadth — sourced directly from Hyperliquid. Prefer it over single-coin price feeds when you need market-wide context, breadth statistics, or funding rate analysis across many coins simultaneously. It is especially useful for trading agents that need situational awareness before placing orders or for portfolio monitoring dashboards.

## Known failure modes

- Invalid limit value (above 20) returns validation error
- minVolumeUsd set too high may result in very few or zero markets counted
- Network or upstream Hyperliquid data unavailability may cause timeout or stale data
- Payment failure (insufficient USDC balance) results in 402 Payment Required before data is returned

## How this service works

The whole crypto perp market in one call: advancers versus decliners, mean, median and volume-weighted 24h change, total open interest and volume, top contracts by volume, the day's gainers and losers, funding extremes and BTC and ETH at a glance. Use it when an agent needs a market snapshot before deciding what to look at next.

## Output

Returns a JSON object containing: major coin snapshots (BTC, ETH) with mark price, 24h change %, 24h volume, funding APR, and open interest; top gainers and losers lists; top coins by volume; highest and lowest funding rate coins; overall market breadth (advancers/decliners count and percentages, mean/median 24h change); funding distribution (positive/negative/zero count, mean APR); market totals (aggregate volume, open interest, top-5 volume share); and a fetchedAt timestamp. Data sourced from Hyperliquid.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "number",
   "description": "Rows per list (default 10, max 20)."
  },
  "minVolumeUsd": {
   "type": "number",
   "description": "Minimum 24h notional volume in USD for a market to count (default 1000000, 0 = all)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "majors": {
   "BTC": {
    "markPx": 77244,
    "change24hPct": 0.36,
    "volume24hUsd": 4679441788.67,
    "fundingAprPct": 10.95,
    "openInterestUsd": 2776803000
   },
   "ETH": {
    "markPx": 2429.3,
    "change24hPct": 2.06,
    "volume24hUsd": 3396726206.45,
    "fundingAprPct": -4.38,
    "openInterestUsd": 1832000000
   }
  },
  "source": "hyperliquid",
  "totals": {
   "volume24hUsd": 12500000000,
   "openInterestUsd": 9100000000,
   "top5VolumeSharePct": 71.2
  },
  "breadth": {
   "advancers": 80,
   "decliners": 35,
   "unchanged": 5,
   "advancersPct": 66.67,
   "meanChange24hPct": 1.42,
   "medianChange24hPct": 0.95,
   "volumeWeightedChange24hPct": 0.61
  },
  "funding": {
   "zero": 5,
   "negative": 25,
   "positive": 90,
   "meanAprPct": 8.4
  },
  "markets": {
   "listed": 230,
   "counted": 120,
   "minVolumeUsd": 1000000
  },
  "fetchedAt": "2026-08-22T12:05:00.000Z",
  "topLosers": [
   {
    "coin": "DOGE",
    "markPx": 0.21,
    "change24hPct": -4.2,
    "volume24hUsd": 300000000,
    "fundingAprPct": -3.2,
    "openInterestUsd": 200000000
   }
  ],
  "topGainers": [
   {
    "coin": "SOL",
    "markPx": 180.2,
    "change24hPct": 8.1,
    "volume24hUsd": 900000000,
    "fundingAprPct": 20.1,
    "openInterestUsd": 500000000
   }
  ],
  "topByVolume": [
   {
    "coin": "BTC",
    "markPx": 77244,
    "change24hPct": 0.36,
    "volume24hUsd": 4679441788.67,
    "fundingAprPct": 10.95,
    "openInterestUsd": 2776803000
   }
  ],
  "lowestFunding": [
   {
    "coin": "ETH",
    "change24hPct": 2.06,
    "fundingAprPct": -4.38,
    "fundingHourly": -0.000005,
    "openInterestUsd": 1832000000
   }
  ],
  "highestFunding": [
   {
    "coin": "SOL",
    "change24hPct": 8.1,
    "fundingAprPct": 20.1,
    "fundingHourly": 0.0000229,
    "openInterestUsd": 500000000
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-tools-crypto-market-pulse-7b67a30e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)