# Cerebrus Pulse

> Pay-per-call crypto derivatives intelligence for AI agents. 50+ Hyperliquid
> perpetuals. No account, no API key — pay per request with USDC via the x402
> protocol on Base or Solana.

## How to call it

Request any paid endpoint. You receive HTTP 402 with payment terms in BOTH
the JSON body (x402 v1 shape) and the `Payment-Required` header (x402 v2).
Pay, then retry with the `X-PAYMENT` header. Free endpoints need no payment.

## Free endpoints

- GET https://api.cerebruspulse.xyz/health — service status
- GET https://api.cerebruspulse.xyz/coins — list of supported perpetuals
- GET https://api.cerebruspulse.xyz/.well-known/agent-card.json — A2A agent card

## Paid endpoints

- GET https://api.cerebruspulse.xyz/arb — Cerebrus Stress: cross-chain market stress index from arbitrage detection across 8 chains ($0.02 USDC)
- GET https://api.cerebruspulse.xyz/basis/{coin} — Cerebrus Basis: HL perpetual oracle vs Chainlink spot price basis analysis ($0.02 USDC)
- GET https://api.cerebruspulse.xyz/bundle/{coin} — Cerebrus Bundle: pulse + sentiment + funding + spread combined (9% discount) ($0.05 USDC)
- GET https://api.cerebruspulse.xyz/cex-dex/{token} — Cerebrus CEX-DEX: cross-venue price divergence between Coinbase and DEX/Chainlink ($0.02 USDC)
- GET https://api.cerebruspulse.xyz/correlation — Cerebrus Correlation: BTC-alt correlation matrix with regime classification ($0.05 USDC)
- GET https://api.cerebruspulse.xyz/depeg — Cerebrus Depeg: USDC collateral health monitor via Chainlink oracle ($0.01 USDC)
- GET https://api.cerebruspulse.xyz/funding/{coin} — Cerebrus Funding: historical funding rate analysis ($0.01 USDC)
- GET https://api.cerebruspulse.xyz/liquidations/{coin} — Cerebrus Liquidations: estimated liquidation heatmap by leverage tier with cascade risk ($0.03 USDC)
- GET https://api.cerebruspulse.xyz/oi/{coin} — Cerebrus OI: open interest analysis with delta, percentile, and divergence ($0.015 USDC)
- GET https://api.cerebruspulse.xyz/pulse/{coin} — Cerebrus Pulse: multi-timeframe technical analysis for 50+ perpetuals ($0.025 USDC)
- GET https://api.cerebruspulse.xyz/screener — Cerebrus Screener: scan 50+ coins for top signals, trends, and regime ($0.06 USDC)
- GET https://api.cerebruspulse.xyz/sentiment — Cerebrus Sentiment: bucketed multi-source market sentiment ($0.01 USDC)
- GET https://api.cerebruspulse.xyz/spread/{coin} — Cerebrus Spread: bid-ask spread, slippage estimates, and liquidity scoring ($0.015 USDC)

## Docs

- Documentation: https://cerebruspulse.xyz
- OpenAPI: https://api.cerebruspulse.xyz/openapi.json
- x402 manifest: https://api.cerebruspulse.xyz/.well-known/x402