Data Marketplace

Download files on Coinbase Data Marketplace

After you've connected to the Data Marketplace SFTP service, you can browse and download files using standard SFTP commands such as lscd, and get.

You can see the marketplace folder at the root level:

$ sftp -i <key-file> <username>@<marketplace-endpoint>
Connected to download.data.coinbase.com.

sftp> ls
marketplace

The SFTP folder structure is logically organized to uniquely select the individual product, source, asset and timeframe of your data. You can only see and access purchased products. The folder structure is:

/marketplace/<product>/<source>/<provider>/<asset>/<year>/<month>/<day>

For example, if you purchased the Coinbase Exchange Trade Data product consisting of the BTC asset, then you can navigate to the following folder location to download data for the date of 2022-04-27:

sftp> cd /marketplace/trades/coinbase/coinbase/btc/2022/04/27
sftp> ls
trades.coinbase.coinbase.btc.2022-04-27.1.manifest 
trades.coinbase.coinbase.btc.eur.2022-04-27.1651017600000.1.csv.gz
trades.coinbase.coinbase.btc.gbp.2022-04-27.1651017600000.1.csv.gz
trades.coinbase.coinbase.btc.usd.2022-04-27.1651017600000.1.csv.gz 
trades.coinbase.coinbase.btc.usdc.2022-04-27.1651017600000.1.csv.gz
trades.coinbase.coinbase.btc.usdt.2022-04-27.1651017600000.1.csv.gz
trades.coinbase.coinbase.btc.ust.2022-04-27.1651017600000.1.csv.gz

There are multiple files, one for each currency pair. To download a file for the BTC-USD pair:

sftp> get trades.coinbase.coinbase.btc.usd.2022-04-27.1651017600000.1.csv.gz
Fetching 
...

You can also download all of them by using a wildcard:

sftp> get trades.*
Fetching 
...

Next steps:

You can verify your download file after completing these steps. Learn more here.