Free Python

How To Download Kucoin OHLCV API Data with Python

Apr 21, 2023 · by CryptoDataDownload

This is a brief tutorial with working example code to how to download market data from the Kucoin exchange via their public REST API using Python. The script will connect to the Kucoin API, download historical Open, High, Low, Close and Volume data for BTCUSD and save the results to a CSV. Every line is commented, feel free to modify to your purpose!

Live codebase Python

#CryptoDataDownload
#No Express Warranty
import pandas as pd
import requests
import json

def main(symbol='BTC-USDT'):
    url = f'https://api.kucoin.com/api/v1/market/candles?type=1day&symbol={symbol}'   # the API endpoint
    response = requests.get(url)  # call the API
    if response.status_code == 200:  # if result is GOOD
        data = json.loads(response.text)  # load the json response from API
        data_pd = pd.DataFrame(data['data'], columns=['unix', 'open', 'close', 'high', 'low', 'volume', 'turnover'])  # create dataframe out of json response
        data_pd['date'] = pd.to_datetime(data_pd['unix'], unit='s')  # add a human readable date
        
        pair = symbol.replace("-", "_")  # remove the - in the symbol name for the csv file
        filename = f'Kucoin_{pair}_day.csv'   # set a filename variable
        data_pd.to_csv(filename, index=False)   # write to CSV
        print(f'Wrote filename: {filename}')    # print results

if __name__ == "__main__":
    """
    This is the main portion of our script, this will call the function called main for the symbol passed to it 
    and download all the OHLCV historical data for that symbol and save the results to a CSV
    
    """
    sym = 'BTC-USDT'
    main(symbol=sym)

Notice: Information contained herein is not and should not be construed as an offer, solicitation, or recommendation to buy or sell securities. The information has been obtained from sources we believe to be reliable; however no guarantee is made or implied with respect to its accuracy, timeliness, or completeness. Author does not own the any crypto currency discussed. The information and content are subject to change without notice. CryptoDataDownload and its affiliates do not provide investment, tax, legal or accounting advice.

This material has been prepared for informational purposes only and is the opinion of the author, and is not intended to provide, and should not be relied on for, investment, tax, legal, accounting advice. You should consult your own investment, tax, legal and accounting advisors before engaging in any transaction. All content published by CryptoDataDownload is not an endorsement whatsoever. CryptoDataDownload was not compensated to submit this article. Please also visit our Privacy policy; disclaimer; and terms and conditions page for further information.

THE PERFORMANCE OF TRADING SYSTEMS IS BASED ON THE USE OF COMPUTERIZED SYSTEM LOGIC. IT IS HYPOTHETICAL. PLEASE NOTE THE FOLLOWING DISCLAIMER. CFTC RULE 4.41: HYPOTHETICAL OR SIMULATED PERFORMANCE RESULTS HAVE CERTAIN LIMITATIONS. UNLIKE AN ACTUAL PERFORMANCE RECORD, SIMULATED RESULTS DO NOT REPRESENT ACTUAL TRADING. ALSO, SINCE THE TRADES HAVE NOT BEEN EXECUTED, THE RESULTS MAY HAVE UNDER-OR-OVER COMPENSATED FOR THE IMPACT, IF ANY, OF CERTAIN MARKET FACTORS, SUCH AS LACK OF LIQUIDITY. SIMULATED TRADING PROGRAMS IN GENERAL ARE ALSO SUBJECT TO THE FACT THAT THEY ARE DESIGNED WITH THE BENEFIT OF HINDSIGHT. NO REPRESENTATION IS BEING MADE THAT ANY ACCOUNT WILL OR IS LIKELY TO ACHIEVE PROFIT OR LOSSES SIMILAR TO THOSE SHOWN. U.S. GOVERNMENT REQUIRED DISCLAIMER: COMMODITY FUTURES TRADING COMMISSION. FUTURES AND OPTIONS TRADING HAS LARGE POTENTIAL REWARDS, BUT ALSO LARGE POTENTIAL RISK. YOU MUST BE AWARE OF THE RISKS AND BE WILLING TO ACCEPT THEM IN ORDER TO INVEST IN THE FUTURES AND OPTIONS MARKETS. DON’T TRADE WITH MONEY YOU CAN’T AFFORD TO LOSE. THIS IS NEITHER A SOLICITATION NOR AN OFFER TO BUY/SELL FUTURES OR OPTIONS. NO REPRESENTATION IS BEING MADE THAT ANY ACCOUNT WILL OR IS LIKELY TO ACHIEVE PROFITS OR LOSSES SIMILAR TO THOSE DISCUSSED ON THIS WEBSITE. THE PAST PERFORMANCE OF ANY TRADING SYSTEM OR METHODOLOGY IS NOT NECESSARILY INDICATIVE OF FUTURE RESULTS.