Get your account
curl --request GET \
--url https://tradingapi.dev/v1/account \
--header 'Authorization: Bearer <token>'import requests
url = "https://tradingapi.dev/v1/account"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://tradingapi.dev/v1/account', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://tradingapi.dev/v1/account"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"object": "account",
"equity": "1412.86",
"available": "212.30",
"unrealized_pnl": "7.17",
"deposit_address": "0x9c0f6f2a5d1b3e4c7a8b9d0e1f2a3b4c5d6e7f80",
"trading": {
"status": "active",
"valid_until": "2026-12-23T00:00:00.000Z"
}
}{
"error": {
"type": "authentication",
"code": "invalid_api_key",
"message": "This API key is not valid. It may have been revoked.",
"param": null,
"hint": "Send a current key as Authorization: Bearer tapi_…. Keys are created and revoked on the account page.",
"details": {},
"errors": [],
"retryable": false,
"doc_url": "https://docs.tradingapi.dev/api-reference/errors#invalid_api_key"
}
}{
"error": {
"type": "rate_limited",
"code": "rate_limited",
"message": "This key made too many requests; retry in 1 s.",
"param": null,
"hint": "Slow down: each key may make 10 requests at once, then 5 a second.",
"details": {},
"errors": [],
"retryable": true,
"retry_after": "2026-09-28T14:05:12.000Z",
"doc_url": "https://docs.tradingapi.dev/api-reference/errors#rate_limited"
}
}{
"error": {
"type": "unavailable",
"code": "unavailable",
"message": "The exchange could not be reached.",
"param": null,
"hint": "Retry the same request with the same client_order_id; an order may already have been recorded.",
"details": {},
"errors": [],
"retryable": true,
"doc_url": "https://docs.tradingapi.dev/api-reference/errors#unavailable"
}
}Account
Get your account
Returns your balance, your deposit address and whether trading is active, read live from
the exchange. If the exchange cannot be read, the response is 503; the API never
guesses.
GET
/
v1
/
account
Get your account
curl --request GET \
--url https://tradingapi.dev/v1/account \
--header 'Authorization: Bearer <token>'import requests
url = "https://tradingapi.dev/v1/account"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://tradingapi.dev/v1/account', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://tradingapi.dev/v1/account"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"object": "account",
"equity": "1412.86",
"available": "212.30",
"unrealized_pnl": "7.17",
"deposit_address": "0x9c0f6f2a5d1b3e4c7a8b9d0e1f2a3b4c5d6e7f80",
"trading": {
"status": "active",
"valid_until": "2026-12-23T00:00:00.000Z"
}
}{
"error": {
"type": "authentication",
"code": "invalid_api_key",
"message": "This API key is not valid. It may have been revoked.",
"param": null,
"hint": "Send a current key as Authorization: Bearer tapi_…. Keys are created and revoked on the account page.",
"details": {},
"errors": [],
"retryable": false,
"doc_url": "https://docs.tradingapi.dev/api-reference/errors#invalid_api_key"
}
}{
"error": {
"type": "rate_limited",
"code": "rate_limited",
"message": "This key made too many requests; retry in 1 s.",
"param": null,
"hint": "Slow down: each key may make 10 requests at once, then 5 a second.",
"details": {},
"errors": [],
"retryable": true,
"retry_after": "2026-09-28T14:05:12.000Z",
"doc_url": "https://docs.tradingapi.dev/api-reference/errors#rate_limited"
}
}{
"error": {
"type": "unavailable",
"code": "unavailable",
"message": "The exchange could not be reached.",
"param": null,
"hint": "Retry the same request with the same client_order_id; an order may already have been recorded.",
"details": {},
"errors": [],
"retryable": true,
"doc_url": "https://docs.tradingapi.dev/api-reference/errors#unavailable"
}
}Authorizations
An API key from the account page, sent as Authorization: Bearer tapi_….
Response
The account.
Allowed value:
"account"Your balance plus unrealized profit and loss, in USD.
What can back new orders or be withdrawn, in USD.
Your deposit address for USDC on Arbitrum. null until your account is set up.