The CryptoRetail API provides historical investment return data for over 20 major cryptocurrencies. Given a coin symbol, an investment amount in USD, and a purchase date, the API returns the current value, ROI percentage, peak value, peak date, and a full weekly price series.

We operate exclusively on the x402 payment protocol. There are no API keys to manage and no monthly subscriptions. You pay exactly $0.02 USDC per successful query on either Base or Solana mainnet.

Ready-to-use integrations: We have published 5-line integration snippets for Claude Desktop, LangChain, and CrewAI on our GitHub Examples Repository.

1. The MCP Server (Recommended for AI Agents)

If you are building an AI agent using Claude Desktop, Cursor, or any framework that supports the Model Context Protocol (MCP), you can use our remote MCP server. The server automatically handles the x402 payment flow on your behalf.

POST https://api.cryptoretail.store/mcp

Claude Desktop Configuration

Add the following to your claude_desktop_config.json file:

{ "mcpServers": { "cryptoretail": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-sse", "https://api.cryptoretail.store/mcp" ] } } }

2. The x402 REST API

If you are building a custom application or an agent framework that supports x402 natively (such as OpenClaw), you can call our REST endpoint directly.

GET https://api.cryptoretail.store/v1/calculate

Request Parameters

Parameter Type Required Description
symbol String Yes The cryptocurrency ticker symbol (e.g., BTC, ETH, SOL). Over 20 major coins supported.
amount Number Yes The initial investment amount in USD (e.g., 1000).
date String Yes The purchase date in YYYY-MM-DD format (e.g., 2021-07-26). Must be in the past.

Example Request

curl "https://api.cryptoretail.store/v1/calculate?symbol=BTC&amount=1000&date=2021-07-26"

Payment Handling

When you call the endpoint without a payment receipt, the server will return an HTTP 402 Payment Required response containing the x402 payment challenge. The challenge advertises two payment options:

Your x402 client will automatically sign the authorization for one of these options and retry the request. The payment is settled instantly.

3. Example Response Data

A successful request returns a comprehensive JSON object containing both summary metrics and the full time series data.

{ "symbol": "BTC", "name": "Bitcoin", "investment": { "amount_usd": 1000, "date": "2021-07-26", "price_at_buy": 37281.55 }, "current": { "value_usd": 1349.64, "roi_percentage": 34.96, "price": 50316.42 }, "peak": { "value_usd": 2454.24, "roi_percentage": 145.42, "date": "2025-07-15", "price": 91497.10 }, "history": [ { "date": "2021-07-26", "price": 37281.55, "value": 1000 }, { "date": "2021-08-02", "price": 39145.20, "value": 1050.12 }, // ... weekly data points to present day ] }

Support & Discovery

Our API is fully indexed and discoverable on x402scan, mcpservers.org, and mcpmarket.com. If you need assistance with integration or have feature requests, please contact us at api@cryptoretail.store.