Skip to main content

CoinGecko Coins

Sync overview​

This source can sync market chart and historical data for a single coin listed on the CoinGecko API. It currently supports only Full Refresh syncing.

Output schema​

This source is capable of syncing the following streams:

  • market_chart
  • history

Features​

FeatureSupported? (Yes/No)Notes
Full Refresh SyncYes
Incremental SyncNo
CoinGecko Pro APIYesWill default to free API unless an API key is provided

Performance considerations​

The CoinGecko API has a rate limit of 10-50 requests per minute. The connector should not run into this under normal operation.

Public (free) CoinGecko API users can only query historical data within the past 365 days. A start_date older than 365 days, or days: max, requires a CoinGecko Pro API key; without one the connector fails with a configuration error explaining the limit.

CoinGecko also request that free users provide attribution when using CoinGecko data. Please read more about this here.

Getting started​

Requirements​

  1. Choose a coin to pull data from. The coin must be listed on CoinGecko, and can be listed via the /coins/list endpoint.
  2. Choose a vs_currency to pull data in. This can be any currency listed on CoinGecko, and can be listed via the /simple/supported_vs_currencies endpoint.

Setup guide​

The following fields are required fields for the connector to work:

  • coin_id: The ID of the coin to pull data for. This can be found via the /coins/list endpoint.
  • vs_currency: The currency to pull data for. This can be found via the /simple/supported_vs_currencies endpoint.
  • days: The number of days to pull market_chart data for.
  • start_date: The start date to pull history data from, in YYYY-MM-DD format (the legacy DD-MM-YYYY format is also accepted).
  • (optional) end_date: The end date to pull history data until, in YYYY-MM-DD format. Defaults to today.

IP allow list​

If you use Airbyte Cloud and your organization restricts access to specific IPs, add the Airbyte Cloud IP addresses to your allow list.

Reference​

Config fields reference

Field
Type
Property name
string
coin_id
string
days
string
start_date
string
vs_currency
string
api_key
string
end_date

Changelog​

Expand to review
VersionDatePull RequestSubject
0.2.272026-10-0788334Accept YYYY-MM-DD dates from the UI date picker for start_date/end_date; surface CoinGecko's 365-day public-API limit as a clear config error
0.2.262025-05-2460393Update dependencies
0.2.252025-05-1059918Update dependencies
0.2.242025-05-0359394Update dependencies
0.2.232025-04-2658833Update dependencies
0.2.222025-04-1958359Update dependencies
0.2.212025-04-1257760Update dependencies
0.2.202025-04-0557254Update dependencies
0.2.192025-03-2956504Update dependencies
0.2.182025-03-2255340Update dependencies
0.2.172025-03-0154932Update dependencies
0.2.162025-02-2254441Update dependencies
0.2.152025-02-1553743Update dependencies
0.2.142025-02-0853332Update dependencies
0.2.132025-02-0152849Update dependencies
0.2.122025-01-2552299Update dependencies
0.2.112025-01-1851644Update dependencies
0.2.102025-01-1151060Update dependencies
0.2.92024-12-2850572Update dependencies
0.2.82024-12-2149995Update dependencies
0.2.72024-12-1449527Update dependencies
0.2.62024-12-1249208Update dependencies
0.2.52024-12-1148937Starting with this version, the Docker image is now rootless. Please note that this and future versions will not be compatible with Airbyte versions earlier than 0.64
0.2.42024-11-0548363Revert to source-declarative-manifest v5.17.0
0.2.32024-11-0548330Update dependencies
0.2.22024-10-2947804Update dependencies
0.2.12024-10-2847559Update dependencies
0.2.02024-08-2244565Refactor connector to manifest-only format
0.1.132024-08-1744306Update dependencies
0.1.122024-08-1243911Update dependencies
0.1.112024-08-1043537Update dependencies
0.1.102024-08-0343113Update dependencies
0.1.92024-07-2742625Update dependencies
0.1.82024-07-2042335Update dependencies
0.1.72024-07-1341707Update dependencies
0.1.62024-07-1041262Update dependencies
0.1.52024-07-0640879Update dependencies
0.1.42024-06-2540292Update dependencies
0.1.32024-06-2240035Update dependencies
0.1.22024-06-0438971[autopull] Upgrade base image to v1.2.1
0.1.12024-05-2138515[autopull] base image + poetry + up_to_date
0.1.12023-04-3025558Make manifest.yaml connector builder-friendly
0.1.02022-10-2018248New source