CoinCap API Scraper

Comprehensive Apify actor for scraping cryptocurrency market data. This actor supports all public GET endpoints including assets, rates, exchanges, markets, and historical candle data.

Features

• 10 Different Endpoints: Access all major CoinCap API endpoints
• Flexible Configuration: Extensive input options for filtering and pagination
• Retry Logic: Automatic retry with exponential backoff for failed requests
• Authentication Support: Optional API key for authenticated requests
• Comprehensive Data: Fetch cryptocurrency prices, market data, exchange information, and historical candles

Supported Endpoints

Assets

• List All Assets (assets) - Retrieve all cryptocurrencies with market data
• Get Asset by ID (asset-by-id) - Get detailed data for a specific cryptocurrency
• Asset History (asset-history) - Fetch historical price data for an asset
• Asset Markets (asset-markets) - Get market trading information for an asset

Rates

• List All Rates (rates) - Get exchange rates for all currencies
• Get Rate by ID (rate-by-id) - Get USD conversion rate for a specific currency

Exchanges

• List All Exchanges (exchanges) - Retrieve all cryptocurrency exchanges
• Get Exchange by ID (exchange-by-id) - Get detailed information for a specific exchange

Markets

• List Markets (markets) - Get trading pair information across exchanges

Candles

• Get Candles (candles) - Fetch OHLCV (Open, High, Low, Close, Volume) candlestick data

Input Configuration

Required Parameters

• endpoint (string) - Select which API endpoint to call
  • Options: assets, asset-by-id, asset-history, asset-markets, rates, rate-by-id, exchanges, exchange-by-id, markets, candles

Optional Parameters

Asset-Specific

• assetId (string) - Asset identifier (e.g., bitcoin, ethereum) - Required for asset-by-id, asset-history, asset-markets
• search (string) - Search assets by ID or symbol
• ids (string) - Comma-separated list of asset IDs to filter

Rate-Specific

• rateId (string) - Rate identifier - Required for rate-by-id endpoint

Exchange-Specific

• exchangeId (string) - Exchange identifier (e.g., binance, kraken) - Required for exchange-by-id and candles

Market/Candles Parameters

• baseId (string) - Base asset identifier (required for candles)
• quoteId (string) - Quote asset identifier (required for candles)
• baseSymbol (string) - Base asset symbol (e.g., ETH)
• quoteSymbol (string) - Quote asset symbol (e.g., BTC)

Time/Interval

• interval (string) - Time interval for history/candles
  • Options: m1, m5, m15, m30, h1, h2, h4, h6, h8, h12, d1, w1
• start (integer) - Start time in UNIX milliseconds
• end (integer) - End time in UNIX milliseconds

Pagination

• limit (integer) - Maximum results to return (default: 100, max: 2000)
• offset (integer) - Number of results to skip (default: 0)

Retry Configuration

• maxRetries (integer) - Maximum retry attempts for failed requests (default: 3)

Example Inputs

Fetch Top 10 Cryptocurrencies

{
  "endpoint": "assets",
  "limit": 10,
  "offset": 0
}

Get Bitcoin Details

{
  "endpoint": "asset-by-id",
  "assetId": "bitcoin"
}

Get Bitcoin Historical Data

{
  "endpoint": "asset-history",
  "assetId": "bitcoin",
  "interval": "d1",
  "start": 1640995200000,
  "end": 1672531199000
}

Get ETH/BTC Markets on Binance

{
  "endpoint": "markets",
  "exchangeId": "binance",
  "baseSymbol": "ETH",
  "quoteSymbol": "BTC"
}

Get 1-Hour Candles for ETH/BTC on Poloniex

{
  "endpoint": "candles",
  "exchangeId": "poloniex",
  "interval": "h1",
  "baseId": "ethereum",
  "quoteId": "bitcoin",
  "start": 1528410925604,
  "end": 1528497325604
}

Search for Assets Containing "bit"

{
  "endpoint": "assets",
  "search": "bit",
  "limit": 20
}

Get Multiple Specific Assets

{
  "endpoint": "assets",
  "ids": "bitcoin,ethereum,solana,cardano",
  "limit": 10
}

Output

The actor pushes results to the Apify dataset with a structured output format.

Successful Response Example

{
  "endpoint": "assets",
  "requestedAt": "2026-02-16T12:00:00.000Z",
  "response": {
    "data": [
      {
        "id": "bitcoin",
        "rank": "1",
        "symbol": "BTC",
        "name": "Bitcoin",
        "supply": "19000000.0000000000000000",
        "maxSupply": "21000000.0000000000000000",
        "marketCapUsd": "850000000000.0000000000000000",
        "volumeUsd24Hr": "25000000000.0000000000000000",
        "priceUsd": "45000.0000000000000000",
        "changePercent24Hr": "2.5000000000000000",
        "vwap24Hr": "44500.0000000000000000"
      }
    ],
    "timestamp": 1708088400000
  },
  "metadata": {
    "assetId": null,
    "exchangeId": null,
    "rateId": null,
    "interval": null,
    "limit": 100,
    "offset": 0
  }
}

Error Response Example

{
  "endpoint": "asset-by-id",
  "requestedAt": "2026-02-16T12:00:00.000Z",
  "error": "Request failed with status code 404",
  "status": 404,
  "metadata": {
    "assetId": "invalid-asset",
    "exchangeId": null,
    "rateId": null
  }
}

Output Fields

• endpoint (string) - The API endpoint that was called
• requestedAt (string) - ISO 8601 timestamp when the request was made
• response (object) - The full API response data (only on success)
  • data (array/object) - The main data payload from the API
  • timestamp (integer) - UNIX timestamp in milliseconds from the API
• metadata (object) - Request parameters used
  • assetId (string|null) - Asset identifier if used
  • exchangeId (string|null) - Exchange identifier if used
  • rateId (string|null) - Rate identifier if used
  • interval (string|null) - Time interval if used
  • limit (integer|null) - Pagination limit if used
  • offset (integer|null) - Pagination offset if used
• error (string) - Error message (only on failure)
• status (integer) - HTTP status code (only on failure)

Error Handling

• Automatic retry with exponential backoff (up to maxRetries attempts)
• Errors are logged and pushed to the dataset with error details
• Failed requests include status code and error message

Common Asset IDs

Popular cryptocurrency identifiers:

• Bitcoin: bitcoin
• Ethereum: ethereum
• Solana: solana
• Cardano: cardano
• XRP: xrp
• Polkadot: polkadot
• Dogecoin: dogecoin

Common Exchange IDs

Popular exchange identifiers:

• Binance: binance
• Kraken: kraken
• Coinbase: gdax
• Poloniex: poloniex
• Bitfinex: bitfinex

Notes

• Candle intervals: m=minute, h=hour, d=day, w=week
• All prices are returned in USD
• Timestamps are in UNIX milliseconds
• Maximum limit per request is 2000 items
• Use pagination (offset/limit) for large datasets