# Realtap

> Live Cardano token prices, charts, DEX trades, liquidity pools, NFT markets, stake pools, governance and a block explorer, computed from on-chain data by a self-hosted node. Free to read for people and for AI agents: an MCP server, Markdown views of the main pages and a JSON API, with no signup needed to try them.

- DEX trades, pool states and token prices follow the chain tip, normally within one to two minutes; the exact lag is `sync.lagSeconds` in the market overview.
- Stake pool, DRep and governance data are synced periodically (minutes to a few hours); holder counts of large tokens once a day.
- How far back history reaches depends on the deployment; answers that are bounded say so (`coverageFrom`, `indexedSince`).
- Every answer carries an as-of time.

## For AI agents
- [MCP server](https://realtap.app/api/mcp): Model Context Protocol endpoint (Streamable HTTP, revisions 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26) with 21 read-only tools; add this URL to an MCP client as a remote server, no key required
- [Guide for agents](https://realtap.app/developers/ai): copy-paste client setup, curl examples, the tool list, limits and how to cite
- [Full reference for models](https://realtap.app/llms-full.txt): every tool with its arguments, every Markdown view, units, errors and limits in one file
- [MCP server card](https://realtap.app/api/mcp/server-card): machine-readable description of the MCP endpoint

## Markdown views
- [/api/md/market](https://realtap.app/api/md/market): DEX market overview: ADA price, 24 h volume, TVL, DEX shares, gainers, losers, trending.
- [/api/md/dashboard](https://realtap.app/api/md/dashboard): One-page summary: market, top tokens, NFT collections, chain and governance status, news.
- [/api/md/tokens](https://realtap.app/api/md/tokens?sort=rank&limit=25): Ranked token table (`?sort=rank|trending|gainers|losers|volume24h|mcap|new&limit=1-100`).
- [/api/md/token/{unit}](https://realtap.app/api/md/token/29d222ce763455e3d7a09a665ce554f00ac89d2e99a1a83d267170c64d494e): One token: price, changes, volume, liquidity, market cap, holders, pools, safety.
- [/api/md/pool/{id}](https://realtap.app/api/md/pool/1): One liquidity pool: pair, reserves, TVL, price, fee, recent trades.
- [/api/md/wallet/{address}](https://realtap.app/api/md/wallet/$snek): A wallet (addr1…, stake1… or $handle): ADA, token positions, total value. Also served as /api/md/address/{address}.
- [/api/md/nft/{policyId}](https://realtap.app/api/md/nft/4523c5e21d409b81c95b45b0aea275b8ea1406e6cafea5583b9f8a5f): One NFT collection: floor, volume, listings, holders, recent sales.
- [/api/md/stake-pool/{poolId}](https://realtap.app/api/md/stake-pool/pool1gaztx97t53k47fr7282d70tje8323vvzx8pshgts30t9krw62tm): One stake pool: fees, stake, saturation, blocks, returns.

## JSON API
- [OpenAPI 3.1 document](https://realtap.app/api/v1/openapi.json): the stable, versioned REST API: tokens, candles, trades, pools, wallets, NFTs, explorer, staking, swap quotes
- [Developer documentation](https://realtap.app/developers): endpoints with live examples, API keys and usage

## Pages
- [Tokens](https://realtap.app/): ranked table of every Cardano native token traded on a DEX (`?sort=rank|gainers|losers|new|volume24h|mcap`)
- [Dashboard](https://realtap.app/dashboard): markets, chain status, NFT collections and news on one page
- [Market overview](https://realtap.app/market-overview): DEX volume, TVL and market share
- [Liquidity pools](https://realtap.app/pools): every DEX pool with price, reserves, volume and fees
- [NFT collections](https://realtap.app/nft): floor prices, volume, sales and listings
- [Stake pools](https://realtap.app/stake-pools): fees, saturation, pledge, blocks and estimated returns
- [Governance](https://realtap.app/governance): governance actions with live vote tallies, DReps, treasury
- [Explorer](https://realtap.app/explorer): blocks, transactions, addresses, assets, policies, epochs
- [DeFi](https://realtap.app/defi): protocols and total value locked
- [ADA Handles](https://realtap.app/handles): search and resolve $handles
- [News](https://realtap.app/news): Cardano headlines from several sources

## Access and limits
- No key: 60 requests per minute per IP address on https://realtap.app/api/v1, https://realtap.app/api/md and https://realtap.app/api/mcp.
- Free API key (created at https://realtap.app/account after signing in with a Cardano wallet): 120 per minute, 10,000 per day. Send it as `x-api-key: otk_…` or `Authorization: Bearer otk_…`.
- Once plans are switched on (https://realtap.app/pricing says whether they are), a key's limits follow the plan of the account that owns it: Plus 300 per minute and 50,000 per day, Pro 600 per minute and 200,000 per day.
- Expensive calls (wallet profit and loss) have an extra limit of 20 per minute without a key.
- Over the limit the answer is HTTP 429 with a JSON body (`error`, `hint`, `docs`, `retryAfter`) and a `Retry-After` header in seconds: wait that long, then continue.
- Realtap is read-only for programs. The swap quote tool and endpoint return an estimate and a link to https://realtap.app/swap; the user reviews the trade there and signs it in their own wallet. No endpoint builds, accepts or submits transactions on behalf of an agent.

## Citing
- Cite as: "Source: Realtap (<page URL>), retrieved <asOf time>". Prices are derived from on-chain DEX pools and are not financial advice.

## Optional
- [Sitemap](https://realtap.app/sitemap.xml): index of all listed pages
- [Swap](https://realtap.app/swap): compare routes and trade from your own wallet (for people)