Live Crypto Data

This API provides real-time pricing, 24-hour percentage changes, market cap, and volume for the top 200 cryptocurrencies. To ensure extreme speed and stability, responses are cached for 5 minutes for optimal speed.

Endpoint

POST /api/v1/crypto

Request Parameters

The following parameters are accepted in the request body:

Field	Type	Required	Description	Example
`limit`	`integer`	Optional	Number of coins to return (Max 20. Default is 10).	`5`
`symbol`	`string`	Optional	Filter results by a specific coin symbol.	`"BTC"`

Request Examples

curl -X POST https://heavstal.com.ng/api/v1/crypto \
-H "Content-Type: application/json" \
-H "x-api-key: <YOUR_API_KEY>" \
-d '{"limit": 2, "symbol": "ETH"}'

const response = await fetch('https://heavstal.com.ng/api/v1/crypto', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'x-api-key': '<YOUR_API_KEY>'
  },
  body: JSON.stringify({
    limit: 2,
    symbol: "ETH"
  })
});

const res = await response.json();
console.log(res.data);

import { search } from '@heavstal/api';

const btc = await search.crypto(1, "BTC");
console.log(btc.data[0].price_usd);

import requests

url = "https://heavstal.com.ng/api/v1/crypto"
headers = {
    "Content-Type": "application/json",
    "x-api-key": "<YOUR_API_KEY>"
}
payload = {
    "limit": 2,
    "symbol": "ETH"
}

response = requests.post(url, headers=headers, json=payload)
print(response.json()["data"])

{
  "status": "success",
  "creator": "HEAVSTAL TECH",
  "provider": "CoinGecko",
  "cached": true,
  "cache_ttl": 248,
  "timestamp": "2026-06-29T10:08:45Z",
  "data": [
    {
      "id": "ethereum",
      "rank": 2,
      "symbol": "ETH",
      "name": "Ethereum",
      "price_usd": "3450.21",
      "change_24h_percent": "1.45",
      "market_cap_usd": "415000000000",
      "volume_24h_usd": "12500000000"
    }
  ]
}

{
  "status": "error",
  "error": "Symbol not found in top 200 cryptocurrencies."
}