5-Minute Quickstart

Get up and running with the Tradovate Partner API in just a few minutes. This guide walks you through making your first API call and accessing live market data.

Prerequisites

Before you begin, ensure you have:

• Partner Account Access to Dashboards (Request from an Eval Support representative if needed)
• API Credentials (API Key and Secret, created in Dashboards)
• Development Environment (Node.js, Python, or preferred language)
• HTTP Client (curl, Postman, or programming language HTTP library)

Step 1: Obtain API Credentials

Once approved, you’ll receive your API credentials. This should consist of a username and password. Once you have your credentials:

1. Log on to Dashboards (staging prod).
2. Navigate to Eval Functions from the side bar
3. Click the API Entitlement tab at the top of the page.
4. Create a new API key.
5. Copy the ID and client secret when presented.

Now we have everything we need to create an /auth/accesstokenrequest payload:

1
{
2
  "name": "<YOUR_USERNAME>",
3
  "password": "<YOUR_PASSWORD>", //or API dedicated password
4
  "appId": "<API_KEY_NAME>",
5
  "appVersion": "1.0.0",
6
  "cid": 1234, // use your API key ID presented when key is created
7
  "sec": "<YOUR_API_SECRET>" // use the secret presented when key is created
8
}

Warning: Keep your API credentials secure! Never commit them to version control or expose them in client-side code.

Step 2: Authenticate

Now that we have our payload, we can get an access token from the system:

1
const YOUR_CREDENTIALS = {
2
  name: "<YOUR_USERNAME>",
3
  password: "<YOUR_PASSWORD>", //or API dedicated password
4
  appId: "<API_KEY_NAME>",
5
  appVersion: "1.0.0",
6
  cid: 1234,                // use your API key ID presented when key is created
7
  sec: "<YOUR_API_SECRET>"  // use the secret presented when key is created
8
}
9
10
const response = await fetch('https://live.tradovateapi.com/v1/auth/accesstokenrequest', {
11
  method: 'POST',
12
  headers: {
13
    'Content-Type': 'application/json',
14
  },
15
  body: JSON.stringify(YOUR_CREDENTIALS)
16
});
17
18
const { accessToken } = await response.json();
19
console.log('Access token:', accessToken);

Step 3: Make Your First API Call

Now use your access token to fetch your user profile:

1
const userResponse = await fetch('https://live.tradovateapi.com/v1/auth/me', {
2
  headers: {
3
    'Authorization': `Bearer ${accessToken}`,
4
    'Content-Type': 'application/json'
5
  }
6
});
7
8
const user = await userResponse.json();
9
console.log('Current user:', user);

Congratulations! You’ve successfully:

✅ Authenticated with the Tradovate API
✅ Retrieved your user profile

As a next step, we suggest you take a look at the endpoints in the API Reference section, and begin perusing the Partner Operations portion of this guide.