Quickstart

Set-up Blochouse

To use the Blockhouse SDK, you need to authenticate using an API key. Each API key is a 32-character string, that can be found from API keys page on your portal. The authentication process ensures secure access to the Blockhouse services and protects your data.

1

Step 1: Create a Blockhouse Account

To generate an API key, you must first create an account on the Blockhouse platform:

1. Visit Blockhouse.

2. Click on Sign Up and provide the required details.

3. Verify your email and log in to your account.

2

Step 2: Generate an API Key

Once you have an account, follow these steps to generate an API key:

1. Navigate to the API Keys section in your Blockhouse dashboard.

2. Click on Create New API Key.

3. Copy and securely store the API key as it will be required to authenticate requests.

3

Step 3: Authenticate API Requests

To use the SDK, you need to provide the API key in your application. The API key can be set as an environment variable or passed explicitly in your script:

Option 1: Using an Environment Variable

Set the API key in your system environment variables:

export BLOCKHOUSE_API_KEY='your_api_key_here'

On Windows (PowerShell):

$env:BLOCKHOUSE_API_KEY="your_api_key_here"

Option 2: Passing API Key in the Code

You can also pass the API key directly when initializing the SDK:

from blockhouse import Client

api_key = "your_api_key_here"
client = Client(api_key)

Best Practices for API Key Security

Best Practices for API Key Security

• Never share your API key publicly or hard-code it in source code.

• Use environment variables or secure storage solutions.

• Rotate API keys periodically to enhance security.

Choose a service

Blockhouse offers two data services: historical and live. While these services are largely similar, they are separated due to licensing costs and differences between request-response and real-time streaming APIs. You have the flexibility to integrate either one or both services.

	Historical	Live
Coverage	Details are available here.	coming soon..
Pricing	Prices vary. Visit Blockhouse website for more info.	coming soon..
Access	Client libraries (C++, Python, and Rust) and API (HTTP).	coming soon..

Uncover your first set of trading insights

Historical

Install SDK

bash

pip install blockhouse

Authenticate & Send

python

from blockhouse import Transfer

client = Transfer(api_key="your_api_key") 

result = client.process_data(
    market_data_path='trade_data.csv',
    trade_data_path='market_data.csv',
    bucket_name="blockhouse-sdk",
)
print(result)

NOTE : You must provide at least one of trade_data_path or market_data_path. You may provide both.

View SDK Documentation →

Live

Next steps

You have successfully integrated the Blockhouse SDK! Here’s what you can do next:

Explore Dashboards

Visualize pre-trade, real-time, and post-trade execution costs.

View Dashboards →

Analyze Execution Metrics

Break down slippage, market impact, and spread capture.

View Analytics →

Generate Reports

Download best execution & compliance reports.

View Reports →

Deploy AI Execution Algorithms

Automate order routing & reduce slippage.

Run AI Execution →