Skip to main content
GET
/
partners
/
marketplace
/
rates
/
stream
Stream Real-Time Exchange Rates
curl --request GET \
  --url https://api.hyperrail.io/api/v1/partners/marketplace/rates/stream \
  --header 'Authorization: Bearer <token>'
"event: rate_update\ndata: {\"from\":\"NGN\",\"to\":\"USDT\",\"rate\":0.0006,\"timestamp\":\"2026-04-14T10:30:00Z\",\"source\":\"CONSENSUS\",\"percentChange24h\":-0.32}\n\nevent: heartbeat\ndata: {\"status\":\"connected\",\"timestamp\":\"2026-04-14T10:31:00Z\"}\n\nevent: rate_update\ndata: {\"from\":\"NGN\",\"to\":\"USDT\",\"rate\":0.00061,\"timestamp\":\"2026-04-14T10:31:05Z\",\"source\":\"CONSENSUS\",\"percentChange24h\":-0.28}\n\n"

Authorizations

​
Authorization
string
header
required

API key authentication using Bearer token

Query Parameters

​
from
string
required

The source currency code

Example:

"NGN"

​
to
string
required

The target currency code (e.g., GHS).

Example:

"GHS"

Response

Successfully established SSE connection. Rate updates will be pushed continuously.

Server-Sent Events stream with rate updates

Example:

"event: rate_update\ndata: {\"from\":\"NGN\",\"to\":\"USDT\",\"rate\":0.0006,\"timestamp\":\"2026-04-14T10:30:00Z\"}\n\nevent: rate_update\ndata: {\"from\":\"NGN\",\"to\":\"USDT\",\"rate\":0.00061,\"timestamp\":\"2026-04-14T10:30:15Z\"}\n\n"