Your First API Call

This guide walks you through making your first successful API call to the Tradovate Partner API, covering authentication, request structure, and response handling.

Prerequisites

Before making your first API call, ensure you have:

• ✅ Partner API credentials (API key and secret)
• ✅ Development environment set up
• ✅ HTTP client ready (curl, Postman, or code library)

If you haven’t completed these steps, start with our 5-Minute Quickstart.

Step 1: Authenticate and Get Access Token

All API requests require a valid access token. Here’s how to obtain one:

1
curl -X POST https://demo.tradovateapi.com/v1/auth/accesstokenrequest \
2
     -H "Content-Type: application/json" \
3
     -d '{
4
  "name": "string",
5
  "password": "string"
6
}'

1
{
2
  "errorText": "string",
3
  "accessToken": "string",
4
  "expirationTime": "2024-01-15T09:30:00Z",
5
  "passwordExpirationTime": "2024-01-15T09:30:00Z",
6
  "userStatus": "Active",
7
  "userId": 1,
8
  "name": "string",
9
  "hasLive": true
10
}

If you’re unfamiliar with authentication, please read the API Authentication section.

Step 2: Make Your First Data Request

Now let’s retrieve your user profile information:

1
curl https://demo.tradovateapi.com/v1/auth/me \
2
     -H "Authorization: Bearer <token>"

1
{
2
  "errorText": "string",
3
  "userId": 1,
4
  "name": "string",
5
  "fullName": "string",
6
  "email": "string",
7
  "emailVerified": true,
8
  "isTrial": true,
9
  "organizationName": "string"
10
}