For AI agents

1. Connect an MCP client

The server speaks the Model Context Protocol over Streamable HTTP (revisions 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26). It needs no key and keeps no session. Endpoint:

https://realtap.app/api/mcp

claude mcp add --transport http opentap https://realtap.app/api/mcp

{
  "mcpServers": {
    "opentap": {
      "type": "http",
      "url": "https://realtap.app/api/mcp"
    }
  }
}

{
  "servers": {
    "opentap": {
      "type": "http",
      "url": "https://realtap.app/api/mcp"
    }
  }
}

With an API key for higher limits, add the header X-API-Key: otk_… (for example --header "X-API-Key: otk_…" in Claude Code).

2. Tools (20, all read-only)

Start with search when you only have a name or ticker; the other tools take exact identifiers. ADA amounts are whole ADA, token amounts are decimal-adjusted, fields ending in Pct are percent values, times are UTC.

* required. Full schemas come from tools/list and are written out in llms-full.txt.

3. Try it with curl

A tool call in the current revision: the protocol version and client capabilities travel in the request, mirrored in three headers.

curl -s https://realtap.app/api/mcp \
  -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2026-07-28' -H 'Mcp-Method: tools/call' -H 'Mcp-Name: get_market_overview' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_market_overview","arguments":{},"_meta":{"io.modelcontextprotocol/protocolVersion":"2026-07-28","io.modelcontextprotocol/clientCapabilities":{}}}}'

The short form of the handshake revisions also works for a single call, because nothing is stored between requests:

curl -s https://realtap.app/api/mcp \
  -H 'content-type: application/json' -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_tokens","arguments":{"sort":"gainers","limit":5}}}'

The answer carries the data as JSON text and as structuredContent. A problem the model can fix (a bad argument, an unknown identifier, a data source that is down) comes back as a result with isError: true and a sentence saying what to do next.

4. Markdown views

One GET, compact text with units, an as-of time and links. The matching pages advertise them with <link rel="alternate" type="text/markdown">.

curl -s https://realtap.app/api/md/market

5. 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.
• Create a key under Account (sign in with a Cardano wallet; no email needed).

6. What the data is, and what agents may do

• 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.
• Prices come from on-chain DEX pools, not from an exchange feed: read the pool liquidity together with any price.
• 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.

7. Machine-readable entry points

• llms.txt https://realtap.app/llms.txt · short map of the site for language models
• llms-full.txt https://realtap.app/llms-full.txt · every tool, view, unit and limit in one file
• MCP server card https://realtap.app/api/mcp/server-card · where and how to connect, machine-readable
• AI catalog https://realtap.app/.well-known/ai-catalog.json · domain-level discovery of the MCP server
• OpenAPI 3.1 https://realtap.app/api/v1/openapi.json · the versioned REST API
• Sitemap https://realtap.app/sitemap.xml · all listed pages