Get a user’s history

  • Available in Sandbox
  • Available in Production
  • Available to Advisors
  • Deprecated
Note: this API will be removed in future versions of the API. Please use the corresponding account-based API in its place.

Get historical activity information for each of a user’s accounts. The activity information is identical to a request made against the accounts/history call. This call should be used when information is required across multiple accounts, as opposed to making multiple account-based calls.

GET

Headers

Header Required Values/Example Default
Accept Optional application/xml, application/json application/xml
Authorization Required Bearer {token}

Code Example

If you're developing in the sandbox, change the hostname to https://sandbox.tradier.com
curl -X GET "https://api.tradier.com/v1/user/history" \
     -H 'Authorization: Bearer <TOKEN>' \
     -H 'Accept: application/json'
// Version 1.8.0_31    
import com.fasterxml.jackson.databind.JsonNode;
import com.fasterxml.jackson.databind.ObjectMapper;
import org.apache.http.HttpEntity;
import org.apache.http.HttpResponse;
import org.apache.http.client.methods.HttpUriRequest;
import org.apache.http.client.methods.RequestBuilder;
import org.apache.http.impl.client.HttpClientBuilder;
import org.apache.http.util.EntityUtils;

import java.io.IOException;

public class MainClass {
  public static void main(String[] args) throws IOException {
    final HttpUriRequest request = RequestBuilder
        .get("https://api.tradier.com/v1/user/history")
        .addHeader("Authorization", "Bearer <TOKEN>")
        .addHeader("Accept", "application/json")
        
        .build();

    final HttpResponse response = HttpClientBuilder.create().build().execute(request);
    final String jsonString = EntityUtils.toString(response.getEntity());
    final JsonNode json = new ObjectMapper().readTree(jsonString);
    
    System.out.println(response.getStatusLine().getStatusCode());
    System.out.println(json);
  }
}
# Version 2.5.0p0    
require 'uri'
require 'net/http'

url = URI("https://api.tradier.com/v1/user/history")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <TOKEN>'
request["Accept"] = 'application/json'

response = http.request(request)
puts response.code
puts response.read_body
// Version go1.12      
package main

import (
    "fmt"
    "net/http"
    "net/url"
    "io/ioutil"
    "log"
)

func main() {
    apiUrl := "https://api.tradier.com/v1/user/history"

    u, _ := url.ParseRequestURI(apiUrl)
    urlStr := u.String()

    client := &http.Client{}
    r, _ := http.NewRequest("GET", urlStr, nil)
    r.Header.Add("Authorization", "Bearer <TOKEN>")
    r.Header.Add("Accept", "application/json")

    resp, _ := client.Do(r)
    responseData, err := ioutil.ReadAll(resp.Body)

    if err != nil {
      log.Fatal(err)
    }

    fmt.Println(resp.Status)
    fmt.Println(string(responseData))
}
// Version 4.6.2.0    
using System;
using System.Net;  
using System.IO;
using System.Text;

public class MainClass {
  public static void Main (string[] args) {
    var request = (HttpWebRequest)WebRequest.Create("https://api.tradier.com/v1/user/history");
    request.Method = "GET";
    request.Headers["Authorization"] = "Bearer <TOKEN>";
    request.Accept = "application/json";

    var response = (HttpWebResponse)request.GetResponse();

    Console.WriteLine (response.StatusCode);
    var responseString = new StreamReader(response.GetResponseStream()).ReadToEnd();
    Console.WriteLine (responseString);
  }
}
// Version 10.15.2    
const request = require('request');

request({
    method: 'get',
    url: 'https://api.tradier.com/v1/user/history',
    qs: {
      
    },
    headers: {
      'Authorization': 'Bearer <TOKEN>',
      'Accept': 'application/json'
    }
  }, (error, response, body) => {
      console.log(response.statusCode);
      console.log(body);
  });
# Version 3.6.1    
import requests

response = requests.get('https://api.tradier.com/v1/user/history',
    params={},
    headers={'Authorization': 'Bearer <TOKEN>', 'Accept': 'application/json'}
)
json_response = response.json()
print(response.status_code)
print(json_response)
<?php
// Version 7.2.17-0ubuntu0.18.04.1
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://api.tradier.com/v1/user/history');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'GET');

$headers = array();
$headers[] = 'Authorization: Bearer <TOKEN>';
$headers[] = 'Accept: application/json';

curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$result = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
}
curl_close ($ch);
echo $http_code;
echo $result;

Response

Response Definition

{
  "accounts": {
    "account": [
      {
        "account_number": "6YA05991",
        "history": {
          "event": [
            {
              "amount": 10.06,
              "date": "2018-10-31T00:00:00Z",
              "type": "trade",
              "trade": {
                "commission": 0.0000000000,
                "description": "GENERAL ELECTRIC COMPANY",
                "price": 10.060000,
                "quantity": -1.00000000,
                "symbol": "GE",
                "trade_type": "Equity"
              }
            },
            {
              "amount": 0.12,
              "date": "2018-10-25T00:00:00Z",
              "type": "dividend",
              "adjustment": {
                "description": "GENERAL ELECTRIC COMPANY",
                "quantity": 0.00000000
              }
            },
            {
              "amount": 0,
              "date": "2018-09-21T00:00:00Z",
              "type": "option",
              "option": {
                "option_type": "OPTEXP",
                "description": "Expired",
                "quantity": -1.00000000
              }
            },
            {
              "amount": -13.05,
              "date": "2018-06-19T00:00:00Z",
              "type": "trade",
              "trade": {
                "commission": 0.0000000000,
                "description": "GENERAL ELECTRIC COMPANY",
                "price": 13.050000,
                "quantity": 1.00000000,
                "symbol": "GE",
                "trade_type": "Equity"
              }
            },
            {
              "amount": -129.05,
              "date": "2018-05-23T00:00:00Z",
              "type": "trade",
              "trade": {
                "commission": 0.0000000000,
                "description": "CALL GE     06\/22\/18    14",
                "price": 1.290000,
                "quantity": 1.00000000,
                "symbol": "GE180622C00014000",
                "trade_type": "Option"
              }
            },
            {
              "amount": -51.05,
              "date": "2018-05-23T00:00:00Z",
              "type": "trade",
              "trade": {
                "commission": 0.0000000000,
                "description": "CALL GE     06\/22\/18    15",
                "price": 0.510000,
                "quantity": 1.00000000,
                "symbol": "GE180622C00015000",
                "trade_type": "Option"
              }
            },
            {
              "amount": 99.95,
              "date": "2018-05-23T00:00:00Z",
              "type": "trade",
              "trade": {
                "commission": 0.0000000000,
                "description": "CALL GE     06\/22\/18    14",
                "price": 1.000000,
                "quantity": -1.00000000,
                "symbol": "GE180622C00014000",
                "trade_type": "Option"
              }
            },
            {
              "amount": -3000.00,
              "date": "2018-05-23T00:00:00Z",
              "type": "journal",
              "journal": {
                "description": "6YA-00005 TO 6YA-00102",
                "quantity": 0.00000000
              }
            },
            {
              "amount": 187.82,
              "date": "2018-05-21T00:00:00Z",
              "type": "trade",
              "trade": {
                "commission": 0.0000000000,
                "description": "APPLE INC",
                "price": 187.820100,
                "quantity": -1.00000000,
                "symbol": "AAPL",
                "trade_type": "Equity"
              }
            },
            {
              "amount": 0.73,
              "date": "2018-05-17T00:00:00Z",
              "type": "DIVADJ",
              "adjustment": {
                "description": "APPLE INC",
                "quantity": 0.00000000
              }
            },
            {
              "amount": 2500.00,
              "date": "2018-05-11T00:00:00Z",
              "type": "journal",
              "journal": {
                "description": "TFR FROM ACCT VA-00000-0",
                "quantity": 0.00000000
              }
            },
            {
              "amount": -79.09,
              "date": "2018-04-19T00:00:00Z",
              "type": "trade",
              "trade": {
                "commission": 0.0000000000,
                "description": "EXXON MOBIL CORP",
                "price": 79.090000,
                "quantity": 1.00000000,
                "symbol": "XOM",
                "trade_type": "Equity"
              }
            },
            {
              "amount": 0,
              "date": "2017-07-19T00:00:00Z",
              "type": "option",
              "option": {
                "option_type": "expiration",
                "description": "Expired",
                "quantity": -2.00000000
              }
            }
          ]
        }
      }
    ]
  }
}