Data Overview

The CoinGecko Coins source provides two types of data: time-series market chart data and point-in-time historical records. Both entities are scoped to a single coin and currency pair per source configuration.

Entities

Entity
What it contains

Market charts

Prices, market caps, and total volumes sampled over a selected time window (1 day up to all-time)

Histories

A historical snapshot of a coin's price, market cap, volume, and community/developer data for a given date range

Available data fields

Market charts

Field
Description

timestamp

The date and time for the data point

price

Coin price in the selected currency

market_cap

Total market capitalization at that timestamp

total_volume

Total trading volume across exchanges at that timestamp

Histories

Field
Description

date

The date of the historical record

current_price

Price in the selected currency on that date

market_cap

Market cap on that date

total_volume

Total trading volume on that date

community_data

Metrics like Twitter followers and Reddit subscribers (where available)

developer_data

Developer activity metrics such as GitHub stars and forks (where available)

Common data combinations

  • Market charts + Histories — use the Join transformation to cross-reference time-series price trends with historical snapshot details for deeper context

  • Multiple coins via Append — configure one source per coin (e.g. Bitcoin, Ethereum, Solana) and use Append to create a single unified table for side-by-side comparison

  • Aggregate transformation — use Aggregate on market chart data to calculate averages, minimums, or maximums over a time window without leaving Coupler.io

Use cases by role

  • Track the USD or EUR value of crypto holdings over time using Market charts

  • Pull historical price data into Excel or Google Sheets to support portfolio valuation and reporting

  • Feed daily price snapshots into BigQuery for auditing or compliance records

  • Use AI destinations like Claude or ChatGPT to summarize price trends and flag anomalies automatically

Platform-specific notes

  • The Coin ID must match CoinGecko's internal identifier exactly — use the coins list endpointarrow-up-right to look up the correct ID before configuring your source

  • Market chart data granularity is controlled by CoinGecko based on the days parameter: 1 day returns hourly data, ranges above 90 days return daily data

  • Community and developer data in the Histories entity may be null for newer or less-tracked coins

  • Free-tier CoinGecko API keys have rate limits that may affect how many coins you can sync simultaneously — check your plan limits before setting up many data flows

  • Each source is scoped to a single coin and currency pair; to track multiple coins or currencies, add additional sources to your data flow

Last updated

Was this helpful?