Weights - ETFs API - AxionQuant Docs

GET/etfs/:ticker/weights

Retrieves the detailed sector breakdown and geographic exposure of an ETF. Provides both formatted percentages and raw decimal weights for precise analysis. Essential for understanding concentration risk and geographic diversification.

Path Parameters

Parameter	Type	Required	Description
ticker	string	Required	ETF ticker symbol (e.g., "SPY", "QQQ", "VTI")

Examples:

https://api.axionquant.com/etfs/VTI/weights

https://api.axionquant.com/etfs/QQQ/weights

Response Fields

sector array

Array of sector allocations

name string

Sector name (e.g., "Technology Services")

weight string

Formatted weight percentage (e.g., "21.08%")

rawWeight number

Raw weight as decimal (0.0-1.0)

regions array

Array of geographic exposures

name string

Country or region name

weight string

Formatted weight percentage or "--" for negligible

benchmarkWeight string

Benchmark weight percentage

rawWeight number|string

Raw weight as decimal or "--"

Sector & Region Weights

Request

Sample code

1from axion import Axion
2client = Axion(api_key='axn_123')
3
4weights = client.etfs.weights('SPY')
5print(weights)

Response

{
  "sector": [
    {
      "name": "Technology Services",
      "weight": "21.08%",
      "rawWeight": 0.21079285342758
    },
    {
      "name": "Commercial Services",
      "weight": "2.90%",
      "rawWeight": 0.0289666913939312
    }
  ],
  "regions": [
    {
      "name": "United States",
      "weight": "100.00%",
      "benchmarkWeight": "99.89%",
      "rawWeight": 1
    },
    {
      "name": "Canada",
      "weight": "--",
      "benchmarkWeight": "0.11%",
      "rawWeight": "--"
    }
  ]
}

GET/etfs/:ticker/exposure

Identifies all ETFs that hold a particular stock and provides detailed exposure analysis including allocation percentages and market values. Essential for understanding fund-of-funds relationships and analyzing indirect ownership structures.

Path Parameters

Parameter	Type	Required	Description
ticker	string	Required	Stock ticker symbol to analyze (e.g., "AAPL", "NVDA", "MSFT")

Examples:

https://api.axionquant.com/etfs/QQQ/exposure

https://api.axionquant.com/etfs/SPY/exposure

Response Fields

ticker string

ETF ticker that holds the stock

fundName string

ETF fund name

segment string

ETF market segment

allocation string

Formatted allocation percentage

marketValue string

Formatted market value (with B/M/K suffix)

rawAllocation number

Raw allocation as decimal (0.0-1.0)

rawMarketValue number

Raw market value in USD

ETF Exposure Analysis

Request

Sample code

1from axion import Axion
2client = Axion(api_key='axn_123')
3
4exposure = client.etfs.exposure('AAPL')
5print(exposure)

Response

[
  {
    "ticker": "XLK",
    "fundName": "Technology Select Sector SPDR Fund",
    "segment": "Equity: U.S. Information Technology",
    "allocation": "24.17%",
    "marketValue": "$10.46B",
    "rawAllocation": 0.2417,
    "rawMarketValue": 10460000000
  },
  {
    "ticker": "FTEC",
    "fundName": "Fidelity MSCI Information Technology Index ETF",
    "segment": "Equity: U.S. Information Technology",
    "allocation": "23.75%",
    "marketValue": "$1.45B",
    "rawAllocation": 0.2375,
    "rawMarketValue": 1450000000
  },
  {
    "ticker": "IXN",
    "fundName": "iShares Global Tech ETF",
    "segment": "Equity: Global Information Technology",
    "allocation": "23.39%",
    "marketValue": "$737.66M",
    "rawAllocation": 0.2339,
    "rawMarketValue": 737660000
  }
]

GET/etfs/tickers

Retrieves a comprehensive list of all available ETF tickers with support for filtering by country and exchange. Returns essential metadata for each ETF including its full name, ticker symbol, and exchange listing.

Query Parameters

Parameter	Type	Required	Description
country	string	Optional	Filter tickers by listed market's regions (e.g., "america"). view all values
exchange	string	Optional	Filter tickers by exchange (e.g., "NASDAQ").view all values

Examples:

https://api.axionquant.com/etfs/tickers

https://api.axionquant.com/etfs/tickers?country=america&exchange=NASDAQ

Response Fields

id number

Unique identifier for the ETF

name string

Full name of the ETF

ticker string

ETF ticker symbol (e.g., "SPY", "QQQ")

symbol string

Full symbol with exchange prefix (e.g., "NYSEArca:SPY")

exchange string

Exchange where ETF is listed

market string

Market region (e.g., "america")

type string

Fund type (e.g., etf fund)

All ETF Tickers

Request

Sample code

1from axion import Axion
2client = Axion(api_key='axn_123')
3
4tickers = client.etfs.tickers(
5    country='america',
6    exchange='NASDAQ'
7)
8print(tickers)

Response

[
  {
    "id": 23,
    "name": "Aptus International Enhanced Yield",
    "ticker": "IDUB",
    "symbol": "CBOE:IDUB",
    "exchange": "CBOE",
    "market": "america",
    "type": "etf fund"
  },
  {
    "id": 6,
    "name": "ProShares Ultra MSCI Brazil Capped",
    "ticker": "UBR",
    "symbol": "AMEX:UBR",
    "exchange": "AMEX",
    "market": "america",
    "type": "etf fund"
  },
  {
    "id": 20,
    "name": "Amplify CWP Enhanced Dividend Income ETF",
    "ticker": "DIVO",
    "symbol": "AMEX:DIVO",
    "exchange": "AMEX",
    "market": "america",
    "type": "etf fund"
  },
  {
    "id": 3,
    "name": "Thornburg Core Plus Bond ETF",
    "ticker": "TPLS",
    "symbol": "NASDAQ:TPLS",
    "exchange": "NASDAQ",
    "market": "america",
    "type": "etf fund"
  },
  {
    "id": 2,
    "name": "United States Gasoline Fund LP",
    "ticker": "UGA",
    "symbol": "AMEX:UGA",
    "exchange": "AMEX",
    "market": "america",
    "type": "etf fund"
  }
]

GET/etfs/gainers

Retrieves the top gaining ETFs over a specified lookback period. Returns ticker symbols with their percentage change, sorted from highest gainer to lowest. Useful for identifying which ETFs are showing strong momentum.

Query Parameters

Parameter	Type	Required	Description
days	integer	Optional	Lookback period in days (default: 5)
limit	integer	Optional	Maximum number of results to return (default: 10)

Examples:

https://api.axionquant.com/etfs/gainers

https://api.axionquant.com/etfs/gainers?days=30&limit=20

Response Fields

ticker string

ETF ticker symbol

pctchange number

Percentage change over the lookback period

ETF Gainers

Request

Sample code

1from axion import Axion
2client = Axion(api_key='axn_123')
3
4gainers = client.etfs.gainers(days=5, limit=10)
5print(gainers)

Response

[
  {
    "ticker": "SPY",
    "pctchange": 1.234
  },
  {
    "ticker": "QQQ",
    "pctchange": 0.987
  },
  {
    "ticker": "IVV",
    "pctchange": 0.876
  }
]

GET/etfs/losers

Retrieves the top losing ETFs over a specified lookback period. Returns ticker symbols with their percentage change, sorted from most negative to least negative. Useful for identifying which ETFs are showing weakness.

Query Parameters

Parameter	Type	Required	Description
days	integer	Optional	Lookback period in days (default: 5)
limit	integer	Optional	Maximum number of results to return (default: 10)

Examples:

https://api.axionquant.com/etfs/losers

https://api.axionquant.com/etfs/losers?days=30&limit=20

Response Fields

ticker string

ETF ticker symbol

pctchange number

Percentage change over the lookback period

ETF Losers

Request

Sample code

1from axion import Axion
2client = Axion(api_key='axn_123')
3
4losers = client.etfs.losers(days=5, limit=10)
5print(losers)

Response

[
  {
    "ticker": "XLE",
    "pctchange": -2.345
  },
  {
    "ticker": "XLF",
    "pctchange": -1.234
  },
  {
    "ticker": "XLV",
    "pctchange": -0.987
  }
]

ETFs Weights

Path Parameters

Examples:

Response Fields

Sector & Region Weights

Path Parameters

Examples:

Response Fields

ETF Exposure Analysis

Query Parameters

Examples:

Response Fields

All ETF Tickers

Query Parameters

Examples:

Response Fields

ETF Gainers

Query Parameters

Examples:

Response Fields

ETF Losers