# Coinversa Pulse - [Coinversa Pulse](https://docs.coinversa.ai/index.md): Crypto intelligence for AI agents and serious traders — Hyperliquid trader analytics, HIP-4 outcome contracts, real-time risk, builder dex coverage, and a canonical cross-market asset registry. - [Quickstart](https://docs.coinversa.ai/quickstart.md): Get an API key and your first response in 5 minutes. - [Authentication](https://docs.coinversa.ai/authentication.md): API keys, rate-limit headers, tier behavior, and error responses. - [Pricing](https://docs.coinversa.ai/pricing.md): Tier limits, what's included, and how to upgrade. - [MCP setup](https://docs.coinversa.ai/mcp/setup.md): Connect Coinversa Pulse to Claude, Cursor, Perplexity, or any MCP-compatible client. - [Tool catalog](https://docs.coinversa.ai/mcp/tools.md): All 106 MCP tools by category, with descriptions and required tiers. - [Markets & symbols](https://docs.coinversa.ai/concepts/markets.md): Native Hyperliquid perps, the 7 builder dexes, and symbol-format conventions. - [Trader cohorts](https://docs.coinversa.ai/concepts/cohorts.md): Every tracked wallet is classified by two independent tier systems: PnL and size. - [Position lifecycles & execution quality](https://docs.coinversa.ai/concepts/position-lifecycles.md): Every position reconstructed open→close from on-chain fills, with MAE/MFE — analyze how a trade was managed, not just its PnL. - [Cross-market assets](https://docs.coinversa.ai/concepts/cross-market-assets.md): Canonical taxonomy unifying native HL perps with builder dex listings — PAXG and xyz:GOLD both resolve to GOLD. - [HIP-4 outcome contracts](https://docs.coinversa.ai/concepts/hip4.md): Prediction-market style side tokens indexed from Hyperliquid — encoding, settlements, trader overlap with perps. - [Builder codes & attribution](https://docs.coinversa.ai/concepts/builder-attribution.md): How builder-fee revenue and per-fill attribution are computed — the exact on-chain ledger, the orders-to-fills join, the verified stamp, and what dataNotes means. - [Data coverage](https://docs.coinversa.ai/concepts/data-coverage.md): What's indexed, how fresh it is, and where the cutoffs are. - [Introduction](https://docs.coinversa.ai/api-reference/introduction.md): The full REST surface under /api/public/v1, auto-generated from the live Coinversa OpenAPI spec — trader analytics, builder analytics, market data, live risk, HIP-4, entities. - [Authentication](https://docs.coinversa.ai/authentication.md): API keys, rate-limit headers, tier behavior, and error responses. - [Tier and pricing matrix](https://docs.coinversa.ai/api-reference/tiers.md): Which endpoints each tier unlocks, rate limits, and pricing. Single source of truth. - [Data windows](https://docs.coinversa.ai/api-reference/data-windows.md): How far back each endpoint reads. Window sizes are enforced server-side in SQL and aren't visible in the OpenAPI spec. - [Builder endpoints](https://docs.coinversa.ai/api-reference/builders.md): The 12 builder analytics endpoints: ledger-exact revenue, attributed flow, cohort mix, retention, and cross-builder overlap — REST and x402. - [Get API public v1 assets](https://docs.coinversa.ai/api-reference/get-api-public-v1-assets.md) - [Get API public v1 assets by canonical](https://docs.coinversa.ai/api-reference/get-api-public-v1-assets-by-canonical.md) - [Get API public v1 census stamp](https://docs.coinversa.ai/api-reference/get-api-public-v1-census-stamp.md) - [Get API public v1 entities leaderboard](https://docs.coinversa.ai/api-reference/get-api-public-v1-entities-leaderboard.md) - [Get API public v1 entity by address](https://docs.coinversa.ai/api-reference/get-api-public-v1-entity-by-address.md) - [Get API public v1 exchange active traders](https://docs.coinversa.ai/api-reference/get-api-public-v1-exchange-active-traders.md) - [Get API public v1 exchange oi](https://docs.coinversa.ai/api-reference/get-api-public-v1-exchange-oi.md) - [Get API public v1 exchange pnl leaders](https://docs.coinversa.ai/api-reference/get-api-public-v1-exchange-pnl-leaders.md) - [Get API public v1 exchange positions](https://docs.coinversa.ai/api-reference/get-api-public-v1-exchange-positions.md) - [Get API public v1 exchange volume](https://docs.coinversa.ai/api-reference/get-api-public-v1-exchange-volume.md) - [Get API public v1 hip4 cross product overlap](https://docs.coinversa.ai/api-reference/get-api-public-v1-hip4-cross-product-overlap.md) - [Get API public v1 hip4 daily volume](https://docs.coinversa.ai/api-reference/get-api-public-v1-hip4-daily-volume.md) - [Get API public v1 hip4 most active](https://docs.coinversa.ai/api-reference/get-api-public-v1-hip4-most-active.md) - [Get API public v1 hip4 outcomes](https://docs.coinversa.ai/api-reference/get-api-public-v1-hip4-outcomes.md) - [Get API public v1 hip4 outcomes by outcome ID](https://docs.coinversa.ai/api-reference/get-api-public-v1-hip4-outcomes-by-outcome-id.md) - [Get API public v1 hip4 outcomes by outcome ID perp position context](https://docs.coinversa.ai/api-reference/get-api-public-v1-hip4-outcomes-by-outcome-id-perp-position-context.md) - [Get API public v1 hip4 outcomes by outcome ID recent trades](https://docs.coinversa.ai/api-reference/get-api-public-v1-hip4-outcomes-by-outcome-id-recent-trades.md) - [Get API public v1 hip4 outcomes by outcome ID summary](https://docs.coinversa.ai/api-reference/get-api-public-v1-hip4-outcomes-by-outcome-id-summary.md) - [Get API public v1 hip4 questions](https://docs.coinversa.ai/api-reference/get-api-public-v1-hip4-questions.md) - [Get API public v1 hip4 settlements recent](https://docs.coinversa.ai/api-reference/get-api-public-v1-hip4-settlements-recent.md) - [Get API public v1 hip4 top traders](https://docs.coinversa.ai/api-reference/get-api-public-v1-hip4-top-traders.md) - [Get API public v1 hip4 trader by address outcomes](https://docs.coinversa.ai/api-reference/get-api-public-v1-hip4-trader-by-address-outcomes.md) - [Get API public v1 live cohort bias history by coin](https://docs.coinversa.ai/api-reference/get-api-public-v1-live-cohort-bias-history-by-coin.md) - [Get API public v1 live coins by coin long short](https://docs.coinversa.ai/api-reference/get-api-public-v1-live-coins-by-coin-long-short.md) - [Get API public v1 live long short](https://docs.coinversa.ai/api-reference/get-api-public-v1-live-long-short.md) - [Get API public v1 live long short history](https://docs.coinversa.ai/api-reference/get-api-public-v1-live-long-short-history.md) - [Get API public v1 live official oi by coin](https://docs.coinversa.ai/api-reference/get-api-public-v1-live-official-oi-by-coin.md) - [Get API public v1 live oi history](https://docs.coinversa.ai/api-reference/get-api-public-v1-live-oi-history.md) - [Get API public v1 live oi history by coin](https://docs.coinversa.ai/api-reference/get-api-public-v1-live-oi-history-by-coin.md) - [Get API public v1 live risk coins by coin](https://docs.coinversa.ai/api-reference/get-api-public-v1-live-risk-coins-by-coin.md) - [Get API public v1 live risk coins by coin history](https://docs.coinversa.ai/api-reference/get-api-public-v1-live-risk-coins-by-coin-history.md) - [Get API public v1 live risk coins by coin mark dislocations](https://docs.coinversa.ai/api-reference/get-api-public-v1-live-risk-coins-by-coin-mark-dislocations.md) - [Get API public v1 live risk liquidations recent](https://docs.coinversa.ai/api-reference/get-api-public-v1-live-risk-liquidations-recent.md) - [Get API public v1 live risk liquidations summary](https://docs.coinversa.ai/api-reference/get-api-public-v1-live-risk-liquidations-summary.md) - [Get API public v1 live risk overview](https://docs.coinversa.ai/api-reference/get-api-public-v1-live-risk-overview.md) - [Get API public v1 market historical oi](https://docs.coinversa.ai/api-reference/get-api-public-v1-market-historical-oi.md) - [Get API public v1 market orderbook by symbol](https://docs.coinversa.ai/api-reference/get-api-public-v1-market-orderbook-by-symbol.md) - [List API public v1 market positions by address](https://docs.coinversa.ai/api-reference/list-api-public-v1-market-positions-by-address.md) - [Get API public v1 market price by symbol](https://docs.coinversa.ai/api-reference/get-api-public-v1-market-price-by-symbol.md) - [Get API public v1 plan](https://docs.coinversa.ai/api-reference/get-api-public-v1-plan.md) - [List API public v1 pulse anti survivors](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-anti-survivors.md) - [List API public v1 pulse backstop events](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-backstop-events.md) - [List API public v1 pulse biggest losses](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-biggest-losses.md) - [List API public v1 pulse biggest wins](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-biggest-wins.md) - [List API public v1 pulse capital titans](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-capital-titans.md) - [List API public v1 pulse cohort bias history](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-cohort-bias-history.md) - [List API public v1 pulse cohorts recent by tier type by tier alpha concentration](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-cohorts-recent-by-tier-type-by-tier-alpha-concentration.md) - [List API public v1 pulse cohorts recent by tier type by tier lifecycle stats](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-cohorts-recent-by-tier-type-by-tier-lifecycle-stats.md) - [List API public v1 pulse cohorts recent by tier type by tier positions](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-cohorts-recent-by-tier-type-by-tier-positions.md) - [List API public v1 pulse cohorts recent by tier type by tier top positions](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-cohorts-recent-by-tier-type-by-tier-top-positions.md) - [List API public v1 pulse cohorts recent by tier type by tier trades](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-cohorts-recent-by-tier-type-by-tier-trades.md) - [List API public v1 pulse cohorts daily stats](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-cohorts-daily-stats.md) - [List API public v1 pulse cohorts by tier type by tier history](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-cohorts-by-tier-type-by-tier-history.md) - [List API public v1 pulse cohorts by tier type by tier positions](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-cohorts-by-tier-type-by-tier-positions.md) - [List API public v1 pulse cohorts by tier type by tier trades](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-cohorts-by-tier-type-by-tier-trades.md) - [List API public v1 pulse coin alpha map](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-coin-alpha-map.md) - [List API public v1 pulse coin kings](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-coin-kings.md) - [Get API public v1 pulse compare](https://docs.coinversa.ai/api-reference/get-api-public-v1-pulse-compare.md) - [Get API public v1 pulse daily latest](https://docs.coinversa.ai/api-reference/get-api-public-v1-pulse-daily-latest.md) - [Get API public v1 pulse daily by date](https://docs.coinversa.ai/api-reference/get-api-public-v1-pulse-daily-by-date.md) - [Hidden gems: consistent mid-size winners](https://docs.coinversa.ai/api-reference/hidden-gems:-consistent-mid-size-winners.md): Wallets from the all-time traders table with a trade count in [minTrades, maxTrades], win rate >= minWinRate, total PnL >= minPnl, activity on at least minActiveDays distinct days and on at least minDistinctCoins markets, ranked by total PnL. This is a column filter over all-time aggregates, not a s… - [List API public v1 pulse hour profitability](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-hour-profitability.md) - [Trader leaderboard](https://docs.coinversa.ai/api-reference/trader-leaderboard.md): Ranked traders. period=allTime reads the all-time traders table. day/week/month aggregate trader_daily_stats over UTC calendar days (a fill at 23:59 counts for its whole day). minTrades (default 10) applies before ranking in every supported sort. score and risk-adjusted are unsupported and return 40… - [List API public v1 pulse lethal coins](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-lethal-coins.md) - [Get API public v1 pulse lifecycle by ID](https://docs.coinversa.ai/api-reference/get-api-public-v1-pulse-lifecycle-by-id.md) - [List API public v1 pulse lifecycles recent](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-lifecycles-recent.md) - [List API public v1 pulse market concentration](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-market-concentration.md) - [Get API public v1 pulse market overview](https://docs.coinversa.ai/api-reference/get-api-public-v1-pulse-market-overview.md) - [List API public v1 pulse market candles recent by symbol](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-market-candles-recent-by-symbol.md) - [List API public v1 pulse max pain events](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-max-pain-events.md) - [List API public v1 pulse most traded](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-most-traded.md) - [Newcomer whales](https://docs.coinversa.ai/api-reference/newcomer-whales.md): Wallets whose first known activity — the earlier of their first indexed fill and their first reconstructed position lifecycle — is within newcomerDays, and whose gross lifecycle notional over the last 90 days is at least minNotional. Wallets with no trade history whose first lifecycle sits on the li… - [List API public v1 pulse one month wonders](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-one-month-wonders.md) - [List API public v1 pulse perfect exits](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-perfect-exits.md) - [List API public v1 pulse persistent winners](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-persistent-winners.md) - [Get API public v1 pulse stats](https://docs.coinversa.ai/api-reference/get-api-public-v1-pulse-stats.md) - [List API public v1 pulse style distribution](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-style-distribution.md) - [List API public v1 pulse survivors](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-survivors.md) - [List API public v1 pulse token leaderboard by coin](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-token-leaderboard-by-coin.md) - [Top liquidators (90d)](https://docs.coinversa.ai/api-reference/top-liquidators-90d.md): Wallets that most often appear as the liquidator on other wallets' position lifecycles liquidated in the last 90 days, ranked by penalty fees collected. victimClosedPnl is the summed closed PnL of the LIQUIDATED positions — the victims' losses, a negative number — not the liquidator's profit: the li… - [Trader closed positions](https://docs.coinversa.ai/api-reference/trader-closed-positions.md): Complete, closed perp lifecycles in the rolling lifecycle retention window. Same source and completeness filters as closed-positions/stats (stats is capped at the latest 10,000 rows). realizedPnl and fees come directly from the lifecycle; PnL is gross of fees. size is peak size. unrealizedPnl is 0 o… - [List API public v1 pulse trader by address daily](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-trader-by-address-daily.md) - [Get API public v1 pulse trader by address demo](https://docs.coinversa.ai/api-reference/get-api-public-v1-pulse-trader-by-address-demo.md) - [Get API public v1 pulse trader by address lifecycle summary](https://docs.coinversa.ai/api-reference/get-api-public-v1-pulse-trader-by-address-lifecycle-summary.md) - [Get API public v1 pulse trader by address lifecycles](https://docs.coinversa.ai/api-reference/get-api-public-v1-pulse-trader-by-address-lifecycles.md) - [Get API public v1 pulse trader by address performance](https://docs.coinversa.ai/api-reference/get-api-public-v1-pulse-trader-by-address-performance.md) - [List API public v1 pulse trader by address tokens](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-trader-by-address-tokens.md) - [List API public v1 pulse trader by address trades](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-trader-by-address-trades.md) - [List API public v1 pulse trades recent](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-trades-recent.md) - [List API public v1 pulse wallet drawdown curve by address](https://docs.coinversa.ai/api-reference/list-api-public-v1-pulse-wallet-drawdown-curve-by-address.md) - [Get API public v1 verify](https://docs.coinversa.ai/api-reference/get-api-public-v1-verify.md) - [Compare one underlying asset across venues](https://docs.coinversa.ai/api-reference/cross-market-intelligence/compare-one-underlying-asset-across-venues.md): Resolve an underlying asset and compare its venue instruments. For example GOLD includes recognized aliases such as PAXG; canonical identifiers are different from venue symbols such as xyz:GOLD. Position-count bias and notional exposure measure different things. Missing optional venue fields mean un… - [Builder revenue leaderboard](https://docs.coinversa.ai/api-reference/builder-analytics/builder-revenue-leaderboard.md): Builders ranked by exact revenue from Hyperliquid's cumulative builder-fee ledger over the requested period (day, week, or month). Each row carries join-attributed volume, distinct users, and fill counts — plus the same metrics for the immediately preceding window for deltas — and the builder's most… - [Builder user cohort composition](https://docs.coinversa.ai/api-reference/builder-analytics/builder-user-cohort-composition.md): Cohort composition of the builder's attributed users over the period, split by all-time profitability tier (pnlTiers) and size tier (sizeTiers), with per-cohort users, share of total, builder fees, volume, realized PnL, and fills. Wallets missing from the traders rollup appear under tier 'untracked'… - [Builder attributed fills](https://docs.coinversa.ai/api-reference/builder-analytics/builder-attributed-fills.md): Individual fills attributed to the builder within a lookback window (clamped to 90d), with optional exact-coin and wallet filters. Each fill carries price, size, USD volume, realized PnL, the builder fee paid, and the order id it attributes to. Trigger-order fills (stop/TP) are not yet attributed, s… - [Builder activity heatmap](https://docs.coinversa.ai/api-reference/builder-analytics/builder-activity-heatmap.md): When this builder's users trade: a 7x24 UTC weekday-by-hour grid of attributed volume, builder fees, and fill counts over the trailing 12 weeks, zero-filled and Sunday-first. Useful for support-coverage planning, feature-launch timing, and spotting bot-like around-the-clock flow versus human trading… - [Builder user journey economics](https://docs.coinversa.ai/api-reference/builder-analytics/builder-user-journey-economics.md): Lifetime economics of the builder's trailing-year acquisition cohort (wallets with 3+ attributed fills): average and median revenue per wallet, concentration (avg/median), median days from first fill to peak-revenue day and to 50% and 75% of lifetime revenue, and where users peak (before day 7, days… - [Builder user lifecycle](https://docs.coinversa.ai/api-reference/builder-analytics/builder-user-lifecycle.md): Every wallet that ever traded via this builder, partitioned into mutually exclusive stages by recent activity: active (attributed fill within 7d), cooling (30d), switched (no fill via this builder in 30d but at least one via a DIFFERENT builder — detectable only with all-builder attribution), dorman… - [Builder order intent](https://docs.coinversa.ai/api-reference/builder-analytics/builder-order-intent.md): What this builder's users INTEND, not just what filled: order counts and shares by action type (plain orders, batch modifies, and stop/TP trigger orders), time-in-force mix, reduce-only share, a full trigger breakdown (take-profit vs stop, market vs limit, position-TPSL vs standalone, resolved vs st… - [Builder audience overlap](https://docs.coinversa.ai/api-reference/builder-analytics/builder-audience-overlap.md): The top 10 other builders this builder's active users also traded via in the period, ranked by shared users. Each row carries the overlap's share of this builder's active users and the builder fees those shared users paid to the OTHER builder in the period. feesUsd is null (unknown, never zero) when… - [Builder profile](https://docs.coinversa.ai/api-reference/builder-analytics/builder-profile.md): Single-builder overview: exact ledger revenue over the period, first/last fee accrual, distinct fee tokens, most common requested fee rate, a daily attributed series (fees, volume, users, fills) with the biggest day highlighted, top coins by attributed volume, and how many of the period's attributed… - [Builder retention cohorts](https://docs.coinversa.ai/api-reference/builder-analytics/builder-retention-cohorts.md): Retention matrix for the builder's users: wallets are cohorted by the calendar month (or ISO week, with granularity=weekly) of their first activity via this builder, and each later period counts how many of that cohort were active again. WHICH PLANE defines 'first' and 'active' is disclosed per resp… - [Builder's attributed traders](https://docs.coinversa.ai/api-reference/builder-analytics/builders-attributed-traders.md): Wallets that traded via the builder in the window, sortable by builder fees paid, volume, or realized PnL. Each row is enriched with the wallet's latest equity and its all-time cohort tiers (pnlTier / sizeTier) from the traders rollup — lifetime labels, not the 30d-rolling tiers the pulse cohort end… - [Builders a wallet trades through](https://docs.coinversa.ai/api-reference/builder-analytics/builders-a-wallet-trades-through.md): Every builder the wallet had attributed fills via within the lookback window (clamped to 90d), ordered by builder fees paid. Each row carries the wallet's fills, fees, and volume via that builder plus first/last attributed-fill timestamps within the window. - [Compare trader cohort positioning](https://docs.coinversa.ai/api-reference/cohort-intelligence/compare-trader-cohort-positioning.md): Compare long and short positions across all-time PnL cohorts for one exact market. Long share by count is longCount / (longCount + shortCount); do not substitute notional bias. Zero denominator means no observed positions, not a neutral trading signal. Responses retain legacy cohort slugs (smart_mon… - [Discover trader performance and size cohorts](https://docs.coinversa.ai/api-reference/cohort-intelligence/discover-trader-performance-and-size-cohorts.md): Summarize wallets by all-time PnL and size cohort. Wallet/trade counts and fill-level win rates are not position notional or the probability of a profitable strategy. Response cohort identifiers retain legacy slugs. Use /live/cohort-bias/{coin} for current positioning in a market. - [Inspect potential liquidation exposure by price](https://docs.coinversa.ai/api-reference/liquidation-risk/inspect-potential-liquidation-exposure-by-price.md): Group currently indexed positions by liquidation price around the current mark. Risk notional is potential exposure in USD, not realized liquidations or a price forecast. The timestamp is when the heatmap was computed, including when served from cache. Empty buckets with currentPrice zero mean no ma… - [Official OI history for a whole dex](https://docs.coinversa.ai/api-reference/live-markets/official-oi-history-for-a-whole-dex.md): Per-coin open-interest history for EVERY coin on the requested dex in one response, from Hyperliquid's official market snapshots (open interest, mark price, and rolling 24h notional volume per snapshot). The batch replaces N calls to /live/official-oi/{coin} with one window scan; the per-coin route… - [L4 order book coverage](https://docs.coinversa.ai/api-reference/market/l4-order-book-coverage.md): How fresh the L4 order-book rollups are: coins covered, the newest L1 block height and block time, the age of the freshest row and whether the source is stale. Returns no book data, so it is free — this is the `book` dataset behind the MCP's data_coverage tool. - [L4 order book price levels](https://docs.coinversa.ai/api-reference/market/l4-order-book-price-levels.md): The depth ladder with the detail L2 discards: the top price levels per side, best-first, each with total size, order count, DISTINCT wallet count and the age of the oldest order on it — so a level held by one wallet is distinguishable from the same size across twenty. Snapshot-derived, refreshed eve… - [L4 order book stop map](https://docs.coinversa.ai/api-reference/market/l4-order-book-stop-map.md): Where the stops are: every untriggered stop / take-profit order bucketed by distance from mid in 0.25% steps out to within_pct, with per bucket the count, size, reduce-only share, stop vs take-profit split and side split — plus totals below and above mid, the nearest trigger each side, and how many… - [L4 order book summary](https://docs.coinversa.ai/api-reference/market/l4-order-book-summary.md): How deep and how lopsided a book is right now: touch prices, spread in bps, and per side the size / order count / distinct wallet count within 0.5, 1, 2, 5 and 10% of mid, plus near- and far-band imbalance, the orders resting at the touch, their median age and post-only share. Snapshot-derived, refr… - [L4 order book whales](https://docs.coinversa.ai/api-reference/market/l4-order-book-whales.md): Who is sitting on a book: the largest resting orders (wallet, side, price, size, distance from mid, tif, order type, rest duration) and the biggest wallets per side by total resting size. Wallet addresses join to the trader routes. Snapshot-derived, refreshed every 60s, latest-only. - [Recently closed positions (deprecated: use /pulse/lifecycles/recent)](https://docs.coinversa.ai/api-reference/pulse/recently-closed-positions-deprecated:-use-pulselifecyclesrecent.md): DEPRECATED — superseded by GET /pulse/lifecycles/recent, which returns the same rows with a richer shape (MAE/MFE, liquidation flag, builder fee, optional spot). Both routes read the position_lifecycles_full table with identical filters, so ids, realizedPnl, fees, size (= peakSize) and notional (= p… - [Closed-position stats for a wallet](https://docs.coinversa.ai/api-reference/pulse/closed-position-stats-for-a-wallet.md): Aggregate over the wallet's CLOSED position lifecycles: count, average/min/max hold time, total and average realized PnL, win/loss counts, win rate, and the first/last close time (RFC 3339). Source: the latest 10,000 eligible rows for the wallet in position_lifecycles_full — closed perps only, exclu… - [Inspect a wallet's trading context](https://docs.coinversa.ai/api-reference/wallet-intelligence/inspect-a-wallets-trading-context.md): Fetch the indexed trader profile for a wallet. Combine it with the WebSocket tradesByUser feed to follow wallet activity. Trade statistics describe indexed fills; a successful lookup does not establish that a stream is connected. A syntactically valid example address may have no indexed profile (404… - [WebSocket API](https://docs.coinversa.ai/websocket/overview.md): Stream every Hyperliquid fill in real time over wss://ws.coinversa.ai — authenticate with your API key on the upgrade, subscribe to a coin, a wallet, a list of up to 1,000 wallets, or the firehose, and read fills as they land. - [WebSocket quickstart](https://docs.coinversa.ai/websocket/quickstart.md): Copy-and-run websocket clients for Hyperliquid fills and the L4 order book in Node, Python, Go and the browser — connect with your API key, subscribe, reconnect with backoff, and check sequence ordering. - [Feeds and the fill object](https://docs.coinversa.ai/websocket/feeds.md): The twenty-four websocket feeds — the Hyperliquid fill firehose, one coin, one wallet, a list of up to 1,000 wallets, liquidations, leverage and margin changes, OHLC candles per coin or across every market, TWAP slice fills, TWAP order lifecycle, TWAP status with a live-set snapshot, the L4 order bo… - [Order book (L4)](https://docs.coinversa.ai/websocket/order-book.md): The l4Book websocket feed — Hyperliquid's full L4 order book for one coin, every resting order with its wallet plus untriggered stop and take-profit orders, as one snapshot followed by per-block diffs. Pro and above. - [Wire protocol](https://docs.coinversa.ai/websocket/protocol.md): Every frame on the Coinversa websocket — subscribe and unsubscribe acks, multi-wallet `users` lists and how they hash, ping, data frames carrying a monotonic source position as `seq`, the order-book snapshot, update and error frames, and the exact error strings the server sends. - [WebSocket plan limits](https://docs.coinversa.ai/websocket/limits.md): Websocket capacity by plan — concurrent connections per account, subscriptions per connection, which of the twenty-four feeds each tier includes, multi-wallet lists against the subscription cap, fair-use bandwidth — and how the connection cap is shared across your API keys. - [Changelog](https://docs.coinversa.ai/changelog/overview.md): Product updates and releases for Coinversa Pulse. ## OpenAPI Specs - [openapi](/api-reference/openapi.json) ## Optional - [Dashboard](https://developers.coinversa.ai) - [MCP repo](https://github.com/Coinversaa/mcp-server) - [Releases](https://github.com/Coinversaa/mcp-server/releases) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.