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:

<CodeGroup>

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);

1
import requests
2
3
your_credentials = json.dumps({
4
  'name': '<YOUR_USERNAME>',
5
  'password': '<YOUR_PASSWORD>', # or API dedicated password
6
  'appId': '<API_KEY_NAME>',
7
  'appVersion': '1.0.0',
8
  'cid': 1234, # use your API key ID presented when key is created
9
  'sec': '<YOUR_API_SECRET>' # use the secret presented when key is created
10
})
11
12
response = requests.post(
13
    'https://live.tradovateapi.com/v1/auth/accesstokenrequest',
14
    json=your_credentials
15
)
16
17
access_token = response.json()['accessToken']
18
print(f'Access token: {access_token}')

$
curl -X POST https://live.tradovateapi.com/v1/auth/accesstokenrequest \
>
  -H "Content-Type: application/json" \
>
  -d '{
>
    "name": "your_username",
>
    "password": "your_password",
>
    "appId": "your_api_key",
>
    "environment": "demo"
>
  }'

</CodeGroup>

Step 3: Make Your First API Call

Now use your access token to fetch your user profile:

<CodeGroup>

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);

1
headers = {
2
    'Authorization': f'Bearer {access_token}',
3
    'Content-Type': 'application/json'
4
}
5
6
user_response = requests.get(
7
    'https://live.tradovateapi.com/v1/auth/me',
8
    headers=headers
9
)
10
11
user = user_response.json()
12
print(f'Current user: {user}')

</CodeGroup>

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.