Get balances information for a specific user account. Account balances are calculated on each request during market hours. Each night, balance figures are reconciled with our clearing firm and used as starting point for the following market session.
Header | Required | Values/Example | Default |
---|---|---|---|
Accept | Optional | application/xml, application/json | application/xml |
Authorization | Required | Bearer {token} |
Parameter | Type | Param Type | Required | Values/Example | Default |
---|---|---|---|---|---|
account_id | Path | String | Required | VA000000 | |
Account number |
https://sandbox.tradier.com
curl -X GET "https://api.tradier.com/v1/accounts/{account_id}/balances" \
-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/accounts/{account_id}/balances")
.addHeader("Authorization", "Bearer <TOKEN>")
.addHeader("Accept", "application/json")
.addParameter("account_id", "VA000000")
.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/accounts/{account_id}/balances")
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/accounts/{account_id}/balances"
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/accounts/{account_id}/balances");
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/accounts/{account_id}/balances',
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/accounts/{account_id}/balances',
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/accounts/{account_id}/balances');
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;
{
"balances": {
"option_short_value": 0,
"total_equity": 17798.360000000000000000000000,
"account_number": "VA00000000",
"account_type": "margin",
"close_pl": -4813.000000000000000000,
"current_requirement": 2557.00000000000000000000,
"equity": 0,
"long_market_value": 11434.50000000000000000000,
"market_value": 11434.50000000000000000000,
"open_pl": 546.900000000000000000000000,
"option_long_value": 8877.5000000000000000000,
"option_requirement": 0,
"pending_orders_count": 0,
"short_market_value": 0,
"stock_long_value": 2557.00000000000000000000,
"total_cash": 6363.860000000000000000000000,
"uncleared_funds": 0,
"pending_cash": 0,
// if type is 'margin'
"margin": {
"fed_call": 0,
"maintenance_call": 0,
"option_buying_power": 6363.860000000000000000000000,
"stock_buying_power": 12727.7200000000000000,
"stock_short_value": 0,
"sweep": 0
},
// if type is 'cash'
"cash": {
"cash_available": 4343.38000000,
"sweep": 0,
"unsettled_funds": 1310.00000000
},
// if type is 'pdt'
"pdt": {
"fed_call": 0,
"maintenance_call": 0,
"option_buying_power": 6363.860000000000000000000000,
"stock_buying_power": 12727.7200000000000000,
"stock_short_value": 0
}
}
}