> ## Documentation Index
> Fetch the complete documentation index at: https://docs.coinversa.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Coinversa Pulse

> 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.

Coinversa Pulse is a REST API and MCP server for crypto intelligence on Hyperliquid. It indexes every tracked wallet, classifies behavior into cohorts, and exposes trader analytics, liquidation heatmaps, HIP-4 outcome contract data, and a cross-market asset registry that resolves venue symbols (`xyz:GOLD`, `hyna:PAXG`) to canonical assets.

The same endpoints power our own dashboard, every MCP client (Claude, Cursor, Perplexity), and external bots.

## Choose your path

There are two ways into the same data. Both use the same API key and hit the same backend — pick the one that matches what you're building.

<Columns cols={2}>
  <Card title="Building an AI agent?" icon="robot" href="/mcp/setup">
    Use the **MCP server**. One connector gives Claude, Cursor, or Perplexity first-class tool access — the agent picks and calls tools for you, no HTTP code.

    `https://mcp.coinversa.ai/mcp`
  </Card>

  <Card title="Building an app, script, or SDK?" icon="terminal" href="/quickstart">
    Use the **REST API** directly. Every endpoint, JSON, in your language. This is the complete and authoritative surface — the MCP wraps a curated subset of it.

    `https://api.coinversa.ai/api/public/v1`
  </Card>
</Columns>

<Note>
  The MCP is a thin wrapper over the REST API — it translates tool calls into the same HTTP endpoints documented here. Anything the MCP can do, the REST API can do; the REST API also exposes endpoints not yet wrapped as tools, and supports [x402 pay-per-call](/authentication) which the MCP does not yet sign natively. When in doubt, the REST API is the full surface.
</Note>

## Get started

<Columns cols={2}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Get an API key and make your first request in under 5 minutes.
  </Card>

  <Card title="MCP setup" icon="plug" href="/mcp/setup">
    Connect Pulse to Claude, Cursor, or Perplexity.
  </Card>

  <Card title="API reference" icon="terminal" href="/api-reference">
    96 endpoints, auto-generated from the live OpenAPI spec.
  </Card>

  <Card title="Authentication" icon="key" href="/authentication">
    API keys, rate-limit headers, tier behavior.
  </Card>
</Columns>

## What's in the data

<Columns cols={2}>
  <Card title="Position lifecycles" icon="timeline" href="/concepts/position-lifecycles">
    Every position reconstructed open→close with MAE/MFE — analyze execution quality, drawdowns, and trader archetypes, not just PnL.
  </Card>

  <Card title="Trader cohorts" icon="users" href="/concepts/cohorts">
    Every tracked wallet classified by PnL and size tier — from `money_printer` to `giga_rekt`, `leviathan` to `shrimp`.
  </Card>

  <Card title="Cross-market assets" icon="layer-group" href="/concepts/cross-market-assets">
    Canonical taxonomy unifying native HL perps with builder dex listings — `PAXG`, `xyz:GOLD`, and `hyna:PAXG` all resolve to `GOLD`.
  </Card>

  <Card title="HIP-4 outcomes" icon="chart-line" href="/concepts/hip4">
    Prediction-market style outcome contracts: discovery, settlements, perp-position context, trader overlap.
  </Card>

  <Card title="Live risk" icon="bolt" href="/concepts/data-coverage">
    Liquidation heatmaps, recent liquidations, cohort bias, long/short ratios, OI history.
  </Card>
</Columns>

## How it's used

* **AI agents** — install the [MCP server](/mcp/setup) into Claude / Cursor / Perplexity and the agent gets first-class tool access to the Pulse data surface.
* **Trading bots & SDKs** — hit the [REST API](/api-reference) directly with `X-API-Key`. Same key, same tier, same data — and the full endpoint surface, including anything not yet exposed as an MCP tool.
* **Dashboards** — the [Coinversa Pulse dashboard](https://coinversa.ai) and partner integrations consume the same REST endpoints.

<Note>
  The MCP server is open source: [github.com/Coinversaa/mcp-server](https://github.com/Coinversaa/mcp-server). It's a thin transport layer — the API key you use governs the tier and rate limits at the API layer.
</Note>