FreeCryptoAPI Crypto Price Actor

Fetch basic cryptocurrency data from FreeCryptoAPI via Apify.

What it does

• Market Data: Get current prices, market cap, volume, ATH/ATL for any cryptocurrency
• Multi-Symbol: Query multiple coins at once (BTC+ETH+SOL)

The actor intentionally excludes advanced and non-core endpoints from the current actor surface.

Input

Quick start: for most runs, you only need endpoint and symbol.

{
  "endpoint": "getData",
  "symbol": "BTC"
}

Available Endpoints

Endpoint	Description
getData	Market data for symbol(s)
getCryptoList	List all supported cryptocurrencies

Common Parameters

Parameter	Description
endpoint	What kind of data to fetch
symbol	One symbol like BTC or multiple like BTC+ETH+SOL

Output

Results are stored in the default dataset with the following structure:

{
  "symbol": "BTC",
  "price": 67432.50,
  "change_24h": 1234.56,
  "change_percentage_24h": 1.86,
  "market_cap": 1324567890123,
  "volume_24h": 45678901234,
  "_metadata": {
    "endpoint": "getData",
    "params": {"symbol": "BTC"},
    "fetched_at": "2026-03-19T12:00:00Z"
  }
}

Dataset Views

Access specific views of your data:

• Market Data: ?view=marketData
• Technical Analysis: ?view=technicalAnalysis
• Historical: ?view=historical
• All Data: ?view=all

Use Cases

• Trading Bots: Feed real-time price data into automated trading systems
• Portfolio Trackers: Monitor cryptocurrency holdings and performance
• Technical Analysis: Get RSI, MACD, Bollinger Bands for any coin
• Research: Historical price data for backtesting strategies
• Dashboards: Power crypto dashboards with live market data
• Alerts: Monitor price movements and market sentiment

Environment Setup

The actor requires FREECRYPTO_API_KEY environment variable:

1. Apify Cloud: Set as a secret in Console or via CLI:

   $apify secrets add freecryptoApiKey your_api_key
   

2. Local Testing: Create .env file:

   $FREECRYPTO_API_KEY=your_api_key
   

Get your free API key at freecryptoapi.com.

Quick Start

# Run locally
apify run

# Deploy to Apify
apify push

# Run on cloud
apify call akash9078/freecrypto-actor --input='{"endpoint":"getData","symbol":"BTC"}'

Example Inputs

Get Bitcoin Price

{"endpoint": "getData", "symbol": "BTC"}

Supported Coin List

{"endpoint": "getCryptoList"}

Multiple Coins

{"endpoint": "getData", "symbol": "BTC+ETH+SOL"}

API Reference

This actor wraps the FreeCryptoAPI SDK. For full API documentation, visit their SDK page.

Free Plan Notes

The actor is intentionally scoped to the core endpoints currently exposed here: getData and getCryptoList.

License

MIT