marketstack-python

Usage

Configuration (recommended)

MARKETSTACK_API_KEY="xyz"
MARKETSTACK_TLS_SUPPORT="1"

Create your client

from marketstack.client import Client
import os
def create_client() -> tuple[Client, str]: 
 access_key = os.getenv("MARKETSTACK_API_KEY")
 assert access_key is not None and len(access_key) > 0, "Environment variable MARKETSTACK_API_KEY is not defined"
 tls_support = os.getenv("MARKETSTACK_TLS_SUPPORT")
 protocol = "https" if tls_support == "1" else "http"
 client = Client(base_url=f"{protocol}://api.marketstack.com/v1")
 
 return client, access_key 

Call operations

from marketstack.api.eod import eod
client, access_key = create_client()
response = eod.sync(
 client=client,
 access_key=access_key,
 symbols="AAPL,AMZN",
 limit=10,
)

Multiple asynchronous calls

import asyncio
from typing import List
from marketstack.api.intraday import intraday_latest
from marketstack.api.exchanges import exchanges
from marketstack.models import PagedResponseListmodelsIntervalPrice, PagedResponseListmodelsExchange
async def load_async(symbols: List[str]):
 client, access_key = create_client()
 
 prices_call = intraday_latest.asyncio(access_key=access_key, client=client, symbols=",".join(symbols))
 exchanges_call = exchanges.asyncio(access_key=access_key, client=client)
 
 # Type hints for future results
 prices_response: PagedResponseListmodelsIntervalPrice
 exchanges_response: PagedResponseListmodelsExchange
 
 prices_response, exchanges_response = await asyncio.gather(prices_call, exchanges_call)

Error handling

from marketstack.models import ErrorCode, ErrorResponse
if isinstance(response, ErrorResponse):
 assert response.error.code == ErrorCode.FUNCTION_ACCESS_RESTRICTED

Map to Pandas dataframe

import pandas as pd
df = pd.DataFrame(map(lambda x: x.__dict__, response.data))

Developers area

Generate the client

Run the tests

Release update

References