Get exposure over time

GET

positions

exposure

curl --request GET \
  --url https://api.anthid.com/v1/positions/exposure \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.anthid.com/v1/positions/exposure', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.anthid.com/v1/positions/exposure",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.anthid.com/v1/positions/exposure"

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

}

require 'uri'
require 'net/http'

url = URI("https://api.anthid.com/v1/positions/exposure")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "gross_notional": "46050.00",
      "instruments": [
        {
          "instrument": {
            "asset_class": "EQUITY",
            "exchange": null,
            "symbol": "AAPL"
          },
          "long_count": 1,
          "long_notional": "20000.00",
          "short_count": 0,
          "short_notional": "0"
        },
        {
          "instrument": {
            "asset_class": "EQUITY",
            "exchange": null,
            "symbol": "MSFT"
          },
          "long_count": 1,
          "long_notional": "6050.00",
          "short_count": 0,
          "short_notional": "0"
        },
        {
          "instrument": {
            "asset_class": "EQUITY",
            "exchange": null,
            "symbol": "TSLA"
          },
          "long_count": 0,
          "long_notional": "0",
          "short_count": 1,
          "short_notional": "20000.00"
        }
      ],
      "long_count": 2,
      "long_notional": "26050.00",
      "net_notional": "6050.00",
      "short_count": 1,
      "short_notional": "20000.00",
      "timestamp": "2026-08-05T04:00:00Z"
    }
  ],
  "granularity": "day",
  "opening_position_count": 2
}

"<string>"

"<string>"

"<string>"

"<string>"

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

account_id

string<uuid>

Trading account ID. Omitted, the window covers every account in the organization

environment

enum<string>

required

Required broker environment. Includes disabled and deleted accounts. A named account must belong to this environment.

Available options:

paper,

live

days

integer<int64>

required

Trailing day count. Clamped to 1..=90 and then to the window the caller's plan grants; a single day is reported as 24 hourly buckets

symbol

string

Filter by symbol. Symbols are normalized to uppercase; a blank value is treated as no filter

asset_class

enum<string>

Filter by instrument type. Narrows the totals, the per-instrument breakdown and opening_position_count alike. UNSPECIFIED names no instrument and is rejected with 400; omit the parameter to read every class The kind of thing an Instrument [blocked] is, without its payload.

Separate from the sum type because the discriminant travels where the payload cannot: a column, a metric label, a capability check asking whether this deployment is cleared to trade futures at all. It is Copy and string-convertible for exactly those uses.

Unspecified is what an unset column reads back as, the same role it plays on Feed [blocked] and Broker [blocked]. Instrument::asset_class [blocked] never returns it.

Available options:

UNSPECIFIED,

EQUITY,

FUTURE,

OPTION,

CURRENCY,

CRYPTO,

PERPETUAL,

PREDICTION

Response

Exposure retrieved

Exposure over a trailing window, oldest bucket first.

data

object[]

required

One entry per bucket in the window, including buckets in which nothing was held or nothing traded, so the series can be plotted without the caller filling gaps.

Show child attributes

granularity

enum<string>

required

Width of one bucket: hour for a single-day window, day otherwise.

Available options:

hour,

day

opening_position_count

integer<int64>

required

Instruments the account had ever held, and not yet flattened, when the window opened.

The series carries positions forward from before its own start, so a non-zero figure here is what makes the left-hand end a real level rather than an artefact of where the scan began.

Required range: x >= 0

Get exposure over time

curl --request GET \
  --url https://api.anthid.com/v1/positions/exposure \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.anthid.com/v1/positions/exposure', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.anthid.com/v1/positions/exposure",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.anthid.com/v1/positions/exposure"

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

}

require 'uri'
require 'net/http'

url = URI("https://api.anthid.com/v1/positions/exposure")

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "gross_notional": "46050.00",
      "instruments": [
        {
          "instrument": {
            "asset_class": "EQUITY",
            "exchange": null,
            "symbol": "AAPL"
          },
          "long_count": 1,
          "long_notional": "20000.00",
          "short_count": 0,
          "short_notional": "0"
        },
        {
          "instrument": {
            "asset_class": "EQUITY",
            "exchange": null,
            "symbol": "MSFT"
          },
          "long_count": 1,
          "long_notional": "6050.00",
          "short_count": 0,
          "short_notional": "0"
        },
        {
          "instrument": {
            "asset_class": "EQUITY",
            "exchange": null,
            "symbol": "TSLA"
          },
          "long_count": 0,
          "long_notional": "0",
          "short_count": 1,
          "short_notional": "20000.00"
        }
      ],
      "long_count": 2,
      "long_notional": "26050.00",
      "net_notional": "6050.00",
      "short_count": 1,
      "short_notional": "20000.00",
      "timestamp": "2026-08-05T04:00:00Z"
    }
  ],
  "granularity": "day",
  "opening_position_count": 2
}

"<string>"

"<string>"

"<string>"

"<string>"

Connections

Organizations

Controls

Accounts

Intents

Ledger

Instruments

Stream

MCP

Billing

Get exposure over time

Authorizations

Query Parameters

Response