Moai.cash API Documentation

Public, unauthenticated, read-only APIs. All endpoints are GET and require no authentication. Base URL: https://moai.cash

Machine-readable: OpenAPI 3.1 spec · Discovery: API catalog. An Accept: text/markdown request to this page returns a markdown version.

GET

Token prices

Current prices for one or more tokens by CoinGecko id, with 24h change, market cap, and volume. Results are cached server-side for ~60s.

https://moai.cash/api/token-price?ids=bitcoin,ethereum&currencies=usd,eur

Parameters

Name	Required	Description
`ids`	Yes	Comma-separated CoinGecko coin ids (e.g. bitcoin,ethereum).
`currencies`	No	Comma-separated fiat currencies to report prices in.

Example response

{
  "bitcoin": { "usd": 64000, "usd_24h_change": 1.2, "usd_market_cap": 1.2e12, "usd_24h_vol": 3.4e10 },
  "ethereum": { "usd": 3200, "usd_24h_change": -0.5 }
}

GET

All token prices (batch)

Prices for every token Moai tracks, in a single request. Useful for populating price tickers. Cached ~60s.

https://moai.cash/api/token-prices-batch?currencies=usd

Parameters

Name	Required	Description
`currencies`	No	Comma-separated fiat currencies to report prices in (default usd).

Example response

{
  "bitcoin": { "usd": 64000, "usd_24h_change": 1.2 },
  "ethereum": { "usd": 3200, "usd_24h_change": -0.5 }
}

GET

Token price history

Historical market chart (prices, market caps, volumes) for a token by CoinGecko id. Cached ~10 minutes.

https://moai.cash/api/token-chart?id=bitcoin&days=30&currency=usd

Parameters

Name	Required	Description
`id`	Yes	CoinGecko coin id (e.g. bitcoin).
`days`	No	Number of days of history (default 30). Use max for full history.
`currency`	No	Target fiat currency (default usd).

Example response

{
  "prices": [[1717000000000, 64000], [1717086400000, 64200]],
  "market_caps": [[1717000000000, 1.2e12]],
  "total_volumes": [[1717000000000, 3.4e10]]
}

GET

Token news

Latest news headlines for a token symbol. Returns up to 5 items. Cached ~1 hour. If no CryptoCompare API key is configured, returns { news: [], configured: false }.

https://moai.cash/api/token-news?symbol=BTC

Parameters

Name	Required	Description
`symbol`	Yes	Token symbol (e.g. BTC, ETH).

Example response

{
  "news": [
    { "title": "Bitcoin rallies", "url": "https://...", "source": "CoinDesk", "publishedOn": 1717000000 }
  ],
  "configured": true
}

GET

Fiat exchange rates

Current exchange rate between two fiat currencies (and optional history). Source: Frankfurter / ECB. Cached 1h (current) / 6h (history).

https://moai.cash/api/fiat-rates?from=USD&to=EUR&days=30

Parameters

Name	Required	Description
`from`	No	Base currency code (default USD).
`to`	No	Quote currency code (default EUR).
`days`	No	If >0, include daily history for this many days.

Example response

{
  "rate": 0.92,
  "inverse": 1.087,
  "date": "2026-07-21",
  "history": [{ "date": "2026-06-21", "rate": 0.93 }]
}