Authentication

ThetaDataDx authenticates with ThetaData's servers using your account email and password. There are two ways to provide credentials.

Credentials File

Create a creds.txt file with your ThetaData email on line 1 and password on line 2:

your-email@example.com
your-password

WARNING

Do not commit creds.txt to version control. Add it to your .gitignore.

Load the file in your application:

Rust

let creds = Credentials::from_file("creds.txt")?;

Python

from thetadatadx import Credentials

creds = Credentials.from_file("creds.txt")

Go

creds, err := thetadatadx.CredentialsFromFile("creds.txt")
if err != nil {
    log.Fatal(err)
}
defer creds.Close()

C++

auto creds = tdx::Credentials::from_file("creds.txt");

Environment Variables

For containerized deployments or CI pipelines, pass credentials through environment variables:

Rust

let creds = Credentials::new(
    std::env::var("THETA_EMAIL")?,
    std::env::var("THETA_PASS")?,
);

Python

import os
from thetadatadx import Credentials

creds = Credentials(os.environ["THETA_EMAIL"], os.environ["THETA_PASS"])

Go

creds, err := thetadatadx.CredentialsFromEnv("THETA_EMAIL", "THETA_PASS")
if err != nil {
    log.Fatal(err)
}
defer creds.Close()

C++

auto creds = tdx::Credentials(
    std::getenv("THETA_EMAIL"),
    std::getenv("THETA_PASS")
);

TIP

Environment variables are the recommended approach for production deployments and Docker containers. The file-based approach is convenient for local development.

Connecting

Once you have credentials, create a client connected to ThetaData's production servers:

Rust

use thetadatadx::{ThetaDataDx, Credentials, DirectConfig};

let creds = Credentials::from_file("creds.txt")?;
let client = ThetaDataDx::connect(&creds, DirectConfig::production()).await?;

Python

from thetadatadx import Credentials, Config, ThetaDataDx

creds = Credentials.from_file("creds.txt")
client = ThetaDataDx(creds, Config.production())

Go

creds, _ := thetadatadx.CredentialsFromFile("creds.txt")
defer creds.Close()

config := thetadatadx.ProductionConfig()
defer config.Close()

client, err := thetadatadx.Connect(creds, config)
if err != nil {
    log.Fatal(err)
}
defer client.Close()

C++

auto creds = tdx::Credentials::from_file("creds.txt");
auto client = tdx::Client::connect(creds, tdx::Config::production());

The client authenticates automatically on connection. If credentials are invalid, the connection call returns an error immediately.