# TokenRanker

> Real-time on-chain token ranking platform for the Robinhood chain: prices, liquidity, volume, AI risk audits, and X/Twitter engagement metrics for traders and AI agents.

TokenRanker tracks every enriched Robinhood-chain token pair, scoring each with an AI risk audit (0-100) and live social engagement (1h/24h/48h). Data refreshes every ~30 seconds and is exposed through a public REST API and an MCP endpoint, so agents can query, evaluate, and act on high-potential tokens programmatically.

## Core

- [Homepage](https://tokenranker.xyz/): Live ranking table with search, sorting, AI scores and X stats.
- [Agent API documentation](https://tokenranker.xyz/docs.md): Complete markdown reference for the REST API, MCP tools, and data model.

## Machine-readable API

- [All pairs](https://tokenranker.xyz/api/v1/pairs): Ranked token pairs with filters (type, dex, quote, minLiq/minVol/minScore), sorting, and pagination.
- [Single pair](https://tokenranker.xyz/api/v1/pairs/{idOrAddress}): One pair by pair id, token address, or token name.
- [Hyped tokens](https://tokenranker.xyz/api/v1/hyped): Tokens ranked by 24h X follower growth.
- [Surge zone](https://tokenranker.xyz/api/v1/surge): Momentum tokens in the surge zone.
- [Token audit](https://tokenranker.xyz/api/v1/audits/{address}): AI risk audit for one token address.
- [Market stats](https://tokenranker.xyz/api/v1/stats): Totals, averages, and breakdowns across the whole market.
- [OpenAPI spec](https://tokenranker.xyz/openapi.json): Machine-readable OpenAPI 3.1 description of the REST API.

## MCP

- [MCP endpoint](https://tokenranker.xyz/mcp): Model Context Protocol server (Streamable HTTP) with tools for pairs, hyped tokens, audits, and stats.
- [MCP server card](https://tokenranker.xyz/server-card): Server card describing the MCP endpoint for discovery.

## Optional

- [Raw pair dump](https://tokenranker.xyz/pairdata.json): Raw live dump as produced by the background task.
- [Raw hype dump](https://tokenranker.xyz/hypedata.json): Raw hyped-token dump (may be empty between refreshes).