Recent events (JSON)
GET/v1/cryptodata/stream/recent
The newest events from the live stream as JSON, oldest first. Same event shape as `GET /stream`. `last_id` is the id to pass as `since_id` when opening the stream, so a client can backfill and then go live without a gap or a duplicate. Any key, Free included.
Price
$0.01/ callEdge cache
Off
Uptime 24h
100.00%
p95
531ms
Parameters
| Name | In | Type | Description |
|---|---|---|---|
| limit | query | integer = 100 | Newest N events (1-500). |
| types | query | string | Comma-separated event types: liquidation, whale_transfer, whale_position, funding, oi_delta, price_move. Default: all. |
| symbols | query | string | Comma-separated base coins (BTC,ETH,SOL). Default: all. |
| min_usd | query | number = 0 | Drop events smaller than this USD size. Applies to events that carry `usd` (liquidation, whale_transfer, whale_position, oi_delta); funding and price_move always pass. |
Code
curl
# 1. No key, no payment: the gateway answers 402 with the price
curl -i "https://api.realtimeapi.ai/v1/cryptodata/stream/recent"
# 2. Pay: retry with a signed x402 payment (any x402 client builds this header)
curl "https://api.realtimeapi.ai/v1/cryptodata/stream/recent" -H "PAYMENT-SIGNATURE: $X402_PAYMENT"TypeScript · @x402/fetch
// npm i @x402/fetch @x402/core @x402/evm viem
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
const client = x402Client.fromConfig({ schemes: [{ network: "eip155:8453", client: new ExactEvmScheme(privateKeyToAccount(PRIVATE_KEY)) }] });
const pay = wrapFetchWithPayment(fetch, client);
const data = await (await pay("https://api.realtimeapi.ai/v1/cryptodata/stream/recent")).json();
console.log(data);Python · x402
# pip install x402 eth-account requests
from eth_account import Account
from x402.clients.requests import x402_requests
session = x402_requests(Account.from_key(PRIVATE_KEY))
print(session.get("https://api.realtimeapi.ai/v1/cryptodata/stream/recent").json())With an API key
curl "https://api.realtimeapi.ai/v1/cryptodata/stream/recent" -H "X-API-Key: $RTAPI_KEY"Frequently asked questions
How do I get recent events (json) from CryptoDataAPI?
Send GET https://api.realtimeapi.ai/v1/cryptodata/stream/recent. Pay $0.01 per request with x402, or send an X-API-Key header.
What does GET /stream/recent cost?
$0.01 per successful request in USDC on Base. Failed requests are never charged.
Can I call this endpoint from an MCP client?
Yes. Connect any MCP client to the RealtimeAPI server and use call_feed with this endpoint's URL, or get_quote to check the price first.