Polygon Etfglobal API
The etfglobal API from Polygon — 5 operation(s) for etfglobal.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/polygon-etfglobal-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
description: The future of fintech.
title: Polygon Etfglobal API
version: 1.0.0
servers:
- description: Polygon Platform API
url: https://api.polygon.io
- description: Polygon Platform API (Staging)
url: https://api.staging.polygon.io
security:
- apiKey: []
tags:
- name: etfglobal
paths:
/etf-global/v1/analytics:
get:
description: ETF Global analytics data containing risk scores, reward metrics, and quantitative analysis for ETF composite tickers.
operationId: get_etf-global_v1_analytics
parameters:
- description: The stock ticker symbol used to identify this ETF product on exchanges.
in: query
name: composite_ticker
schema:
type: string
- description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
in: query
name: composite_ticker.any_of
schema:
type: string
- description: Filter greater than the value.
in: query
name: composite_ticker.gt
schema:
type: string
- description: Filter greater than or equal to the value.
in: query
name: composite_ticker.gte
schema:
type: string
- description: Filter less than the value.
in: query
name: composite_ticker.lt
schema:
type: string
- description: Filter less than or equal to the value.
in: query
name: composite_ticker.lte
schema:
type: string
- description: The date showing when ETF Global received and processed the data. Value must be formatted 'yyyy-mm-dd'.
in: query
name: processed_date
schema:
type: string
- description: Filter greater than the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: processed_date.gt
schema:
type: string
- description: Filter greater than or equal to the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: processed_date.gte
schema:
type: string
- description: Filter less than the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: processed_date.lt
schema:
type: string
- description: Filter less than or equal to the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: processed_date.lte
schema:
type: string
- description: The date showing when the information was accurate or valid; some issuers, such as Vanguard, release their data on a delay, so the effective_date can be several weeks earlier than the processed_date. Value must be formatted 'yyyy-mm-dd'.
in: query
name: effective_date
schema:
type: string
- description: Filter greater than the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: effective_date.gt
schema:
type: string
- description: Filter greater than or equal to the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: effective_date.gte
schema:
type: string
- description: Filter less than the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: effective_date.lt
schema:
type: string
- description: Filter less than or equal to the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: effective_date.lte
schema:
type: string
- description: ETF Global's proprietary Red Diamond overall risk assessment score for the ETF. Value must be a floating point number.
in: query
name: risk_total_score
schema:
format: double
type: number
- description: Filter greater than the value. Value must be a floating point number.
in: query
name: risk_total_score.gt
schema:
format: double
type: number
- description: Filter greater than or equal to the value. Value must be a floating point number.
in: query
name: risk_total_score.gte
schema:
format: double
type: number
- description: Filter less than the value. Value must be a floating point number.
in: query
name: risk_total_score.lt
schema:
format: double
type: number
- description: Filter less than or equal to the value. Value must be a floating point number.
in: query
name: risk_total_score.lte
schema:
format: double
type: number
- description: ETF Global's proprietary Green Diamond score measuring the potential reward and return prospects of the ETF. Value must be a floating point number.
in: query
name: reward_score
schema:
format: double
type: number
- description: Filter greater than the value. Value must be a floating point number.
in: query
name: reward_score.gt
schema:
format: double
type: number
- description: Filter greater than or equal to the value. Value must be a floating point number.
in: query
name: reward_score.gte
schema:
format: double
type: number
- description: Filter less than the value. Value must be a floating point number.
in: query
name: reward_score.lt
schema:
format: double
type: number
- description: Filter less than or equal to the value. Value must be a floating point number.
in: query
name: reward_score.lte
schema:
format: double
type: number
- description: ETF Global's comprehensive quantitative analysis score combining all quantitative factors. Value must be a floating point number.
in: query
name: quant_total_score
schema:
format: double
type: number
- description: Filter greater than the value. Value must be a floating point number.
in: query
name: quant_total_score.gt
schema:
format: double
type: number
- description: Filter greater than or equal to the value. Value must be a floating point number.
in: query
name: quant_total_score.gte
schema:
format: double
type: number
- description: Filter less than the value. Value must be a floating point number.
in: query
name: quant_total_score.lt
schema:
format: double
type: number
- description: Filter less than or equal to the value. Value must be a floating point number.
in: query
name: quant_total_score.lte
schema:
format: double
type: number
- description: Letter grade summarizing the ETF's overall quantitative assessment, where A = 71-100, B = 56-70, etc.
in: query
name: quant_grade
schema:
type: string
- description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
in: query
name: quant_grade.any_of
schema:
type: string
- description: Filter greater than the value.
in: query
name: quant_grade.gt
schema:
type: string
- description: Filter greater than or equal to the value.
in: query
name: quant_grade.gte
schema:
type: string
- description: Filter less than the value.
in: query
name: quant_grade.lt
schema:
type: string
- description: Filter less than or equal to the value.
in: query
name: quant_grade.lte
schema:
type: string
- description: Combined technical analysis score aggregating short, intermediate, and long-term technical factors. Value must be a floating point number.
in: query
name: quant_composite_technical
schema:
format: double
type: number
- description: Filter greater than the value. Value must be a floating point number.
in: query
name: quant_composite_technical.gt
schema:
format: double
type: number
- description: Filter greater than or equal to the value. Value must be a floating point number.
in: query
name: quant_composite_technical.gte
schema:
format: double
type: number
- description: Filter less than the value. Value must be a floating point number.
in: query
name: quant_composite_technical.lt
schema:
format: double
type: number
- description: Filter less than or equal to the value. Value must be a floating point number.
in: query
name: quant_composite_technical.lte
schema:
format: double
type: number
- description: Overall market sentiment score combining put/call ratios, short interest, and implied volatility. Value must be a floating point number.
in: query
name: quant_composite_sentiment
schema:
format: double
type: number
- description: Filter greater than the value. Value must be a floating point number.
in: query
name: quant_composite_sentiment.gt
schema:
format: double
type: number
- description: Filter greater than or equal to the value. Value must be a floating point number.
in: query
name: quant_composite_sentiment.gte
schema:
format: double
type: number
- description: Filter less than the value. Value must be a floating point number.
in: query
name: quant_composite_sentiment.lt
schema:
format: double
type: number
- description: Filter less than or equal to the value. Value must be a floating point number.
in: query
name: quant_composite_sentiment.lte
schema:
format: double
type: number
- description: Behavioral analysis score measuring investor psychology and market behavior patterns. Value must be a floating point number.
in: query
name: quant_composite_behavioral
schema:
format: double
type: number
- description: Filter greater than the value. Value must be a floating point number.
in: query
name: quant_composite_behavioral.gt
schema:
format: double
type: number
- description: Filter greater than or equal to the value. Value must be a floating point number.
in: query
name: quant_composite_behavioral.gte
schema:
format: double
type: number
- description: Filter less than the value. Value must be a floating point number.
in: query
name: quant_composite_behavioral.lt
schema:
format: double
type: number
- description: Filter less than or equal to the value. Value must be a floating point number.
in: query
name: quant_composite_behavioral.lte
schema:
format: double
type: number
- description: Overall fundamental analysis score combining P/E, P/CF, P/B, and dividend yield metrics. Value must be a floating point number.
in: query
name: quant_composite_fundamental
schema:
format: double
type: number
- description: Filter greater than the value. Value must be a floating point number.
in: query
name: quant_composite_fundamental.gt
schema:
format: double
type: number
- description: Filter greater than or equal to the value. Value must be a floating point number.
in: query
name: quant_composite_fundamental.gte
schema:
format: double
type: number
- description: Filter less than the value. Value must be a floating point number.
in: query
name: quant_composite_fundamental.lt
schema:
format: double
type: number
- description: Filter less than or equal to the value. Value must be a floating point number.
in: query
name: quant_composite_fundamental.lte
schema:
format: double
type: number
- description: Overall global theme score combining sector and country analysis for macro investment views. Value must be a floating point number.
in: query
name: quant_composite_global
schema:
format: double
type: number
- description: Filter greater than the value. Value must be a floating point number.
in: query
name: quant_composite_global.gt
schema:
format: double
type: number
- description: Filter greater than or equal to the value. Value must be a floating point number.
in: query
name: quant_composite_global.gte
schema:
format: double
type: number
- description: Filter less than the value. Value must be a floating point number.
in: query
name: quant_composite_global.lt
schema:
format: double
type: number
- description: Filter less than or equal to the value. Value must be a floating point number.
in: query
name: quant_composite_global.lte
schema:
format: double
type: number
- description: Overall quality assessment score combining liquidity, diversification, and issuing firm factors. Value must be a floating point number.
in: query
name: quant_composite_quality
schema:
format: double
type: number
- description: Filter greater than the value. Value must be a floating point number.
in: query
name: quant_composite_quality.gt
schema:
format: double
type: number
- description: Filter greater than or equal to the value. Value must be a floating point number.
in: query
name: quant_composite_quality.gte
schema:
format: double
type: number
- description: Filter less than the value. Value must be a floating point number.
in: query
name: quant_composite_quality.lt
schema:
format: double
type: number
- description: Filter less than or equal to the value. Value must be a floating point number.
in: query
name: quant_composite_quality.lte
schema:
format: double
type: number
- description: Limit the maximum number of results returned. Defaults to '100' if not specified. The maximum allowed limit is '5000'.
in: query
name: limit
schema:
default: 100
maximum: 5000
minimum: 1
type: integer
- description: A comma separated list of sort columns. For each column, append '.asc' or '.desc' to specify the sort direction. The sort column defaults to 'composite_ticker' if not specified. The sort order defaults to 'asc' if not specified.
in: query
name: sort
schema:
default: composite_ticker.asc
type: string
responses:
'200':
content:
application/json:
example:
count: 1
request_id: 1
results:
- composite_ticker: SPY
effective_date: '2025-09-19'
processed_date: '2025-09-19'
quant_composite_behavioral: 67.1535
quant_composite_fundamental: 1.2
quant_composite_global: 52.9
quant_composite_quality: 75.9
quant_composite_sentiment: 54.6
quant_composite_technical: 79.7
quant_fundamental_div: 4.7
quant_fundamental_pb: 0
quant_fundamental_pcf: 0
quant_fundamental_pe: 0
quant_global_country: 85.4
quant_global_sector: 20.4
quant_grade: D
quant_quality_diversification: 29.3
quant_quality_firm: 98.3
quant_quality_liquidity: 100
quant_sentiment_iv: 23
quant_sentiment_pc: 88.9
quant_sentiment_si: 51.6
quant_technical_it: 79
quant_technical_lt: 78.7
quant_technical_st: 83.1
quant_total_score: 40.2
reward_score: 3.12
risk_country: 1.46
risk_deviation: 7.68
risk_efficiency: 1.85
risk_liquidity: 2.5
risk_structure: 2.37
risk_total_score: 9.22
risk_volatility: 4.66
status: OK
schema:
properties:
next_url:
description: If present, this value can be used to fetch the next page.
type: string
request_id:
description: A request id assigned by the server.
type: string
results:
description: The results for this request.
items:
properties:
composite_ticker:
description: The stock ticker symbol used to identify this ETF product on exchanges.
type: string
effective_date:
description: The date showing when the information was accurate or valid; some issuers, such as Vanguard, release their data on a delay, so the effective_date can be several weeks earlier than the processed_date.
format: date
type: string
processed_date:
description: The date showing when ETF Global received and processed the data.
format: date
type: string
quant_composite_behavioral:
description: Behavioral analysis score measuring investor psychology and market behavior patterns.
format: double
type: number
quant_composite_fundamental:
description: Overall fundamental analysis score combining P/E, P/CF, P/B, and dividend yield metrics.
format: double
type: number
quant_composite_global:
description: Overall global theme score combining sector and country analysis for macro investment views.
format: double
type: number
quant_composite_quality:
description: Overall quality assessment score combining liquidity, diversification, and issuing firm factors.
format: double
type: number
quant_composite_sentiment:
description: Overall market sentiment score combining put/call ratios, short interest, and implied volatility.
format: double
type: number
quant_composite_technical:
description: Combined technical analysis score aggregating short, intermediate, and long-term technical factors.
format: double
type: number
quant_fundamental_div:
description: Fundamental analysis score based on dividend yields of the ETF's underlying securities.
format: double
type: number
quant_fundamental_pb:
description: Fundamental analysis score based on price-to-book value ratios of the ETF's holdings.
format: double
type: number
quant_fundamental_pcf:
description: Fundamental analysis score based on price-to-cash-flow ratios of the ETF's underlying assets.
format: double
type: number
quant_fundamental_pe:
description: Fundamental analysis score based on price-to-earnings ratios of the ETF's underlying holdings.
format: double
type: number
quant_global_country:
description: Quantitative score analyzing global country themes and country-specific market factors.
format: double
type: number
quant_global_sector:
description: Quantitative score analyzing global sector themes and sector-specific performance factors.
format: double
type: number
quant_grade:
description: Letter grade summarizing the ETF's overall quantitative assessment, where A = 71-100, B = 56-70, etc.
type: string
quant_quality_diversification:
description: Quality assessment score evaluating the diversification benefits and risk distribution of the ETF.
format: double
type: number
quant_quality_firm:
description: Quality assessment score evaluating the reputation and capabilities of the ETF's issuing firm.
format: double
type: number
quant_quality_liquidity:
description: Quality assessment score measuring the liquidity characteristics and trading ease of the ETF.
format: double
type: number
quant_sentiment_iv:
description: Market sentiment score derived from implied volatility levels in options markets.
format: double
type: number
quant_sentiment_pc:
description: Market sentiment score derived from put/call option ratios and options activity.
format: double
type: number
quant_sentiment_si:
description: Market sentiment score based on short interest levels and short selling activity.
format: double
type: number
quant_technical_it:
description: Intermediate-term technical analysis score evaluating medium-term price trends.
format: double
type: number
quant_technical_lt:
description: Long-term technical analysis score assessing extended price trend patterns.
format: double
type: number
quant_technical_st:
description: Short-term technical analysis score based on recent price movements and trading patterns.
format: double
type: number
quant_total_score:
description: ETF Global's comprehensive quantitative analysis score combining all quantitative factors.
format: double
type: number
reward_score:
description: ETF Global's proprietary Green Diamond score measuring the potential reward and return prospects of the ETF.
format: double
type: number
risk_country:
description: A component score assessing country-specific risks based on the ETF's geographic exposure.
format: double
type: number
risk_deviation:
description: A component score measuring how much the ETF deviates from expected performance.
format: double
type: number
risk_efficiency:
description: A component score assessing the operational efficiency and cost-effectiveness of the ETF.
format: double
type: number
risk_liquidity:
description: A component score measuring the liquidity risk and ease of trading the ETF.
format: double
type: number
risk_structure:
description: A component score evaluating risks related to the ETF's structural design and mechanics.
format: double
type: number
risk_total_score:
description: ETF Global's proprietary Red Diamond overall risk assessment score for the ETF.
format: double
type: number
risk_volatility:
description: A component score measuring the volatility risk of the ETF's price movements.
format: double
type: number
type: object
type: array
status:
description: The status of this request's response.
enum:
- OK
type: string
required:
- status
- request_id
- results
type: object
description: A list of results.
'400':
content:
application/json:
schema:
properties:
error:
description: A message describing the source of the error.
type: string
request_id:
description: A request id assigned by the server.
type: string
status:
description: The status of this request's response.
enum:
- ERROR
type: string
required:
- status
- request_id
- error
type: object
description: An error message.
tags:
- etfglobal
/etf-global/v1/constituents:
get:
description: ETF Global constituents data containing detailed information about the securities held within ETFs, including weights, market values, and security identifiers.
operationId: get_etf-global_v1_constituents
parameters:
- description: The stock ticker symbol of the ETF that holds these constituent securities.
in: query
name: composite_ticker
schema:
type: string
- description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
in: query
name: composite_ticker.any_of
schema:
type: string
- description: Filter greater than the value.
in: query
name: composite_ticker.gt
schema:
type: string
- description: Filter greater than or equal to the value.
in: query
name: composite_ticker.gte
schema:
type: string
- description: Filter less than the value.
in: query
name: composite_ticker.lt
schema:
type: string
- description: Filter less than or equal to the value.
in: query
name: composite_ticker.lte
schema:
type: string
- description: The stock ticker symbol of the individual security held within the ETF.
in: query
name: constituent_ticker
schema:
type: string
- description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
in: query
name: constituent_ticker.any_of
schema:
type: string
- description: Filter greater than the value.
in: query
name: constituent_ticker.gt
schema:
type: string
- description: Filter greater than or equal to the value.
in: query
name: constituent_ticker.gte
schema:
type: string
- description: Filter less than the value.
in: query
name: constituent_ticker.lt
schema:
type: string
- description: Filter less than or equal to the value.
in: query
name: constituent_ticker.lte
schema:
type: string
- description: The date showing when the information was accurate or valid; some issuers, such as Vanguard, release their data on a delay, so the effective_date can be several weeks earlier than the processed_date. Value must be formatted 'yyyy-mm-dd'.
in: query
name: effective_date
schema:
type: string
- description: Filter greater than the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: effective_date.gt
schema:
type: string
- description: Filter greater than or equal to the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: effective_date.gte
schema:
type: string
- description: Filter less than the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: effective_date.lt
schema:
type: string
- description: Filter less than or equal to the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: effective_date.lte
schema:
type: string
- description: The date showing when ETF Global received and processed the data. Value must be formatted 'yyyy-mm-dd'.
in: query
name: processed_date
schema:
type: string
- description: Filter greater than the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: processed_date.gt
schema:
type: string
- description: Filter greater than or equal to the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: processed_date.gte
schema:
type: string
- description: Filter less than the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: processed_date.lt
schema:
type: string
- description: Filter less than or equal to the value. Value must be formatted 'yyyy-mm-dd'.
in: query
name: processed_date.lte
schema:
type: string
- description: A unique identifier code for the constituent security in US markets.
in: query
name: us_code
schema:
type: string
- description: Filter equal to any of the values. Multiple values can be specified by using a comma separated list.
in: query
name: us_code.any_of
schema:
type: string
- description: Filter greater than the value.
in: query
name: us_code.gt
schema:
type: string
- description: Filter greater than or equal to the value.
in: query
name: us_code.gte
schema:
type: string
- description: Filter less than the value.
in: query
name: us_code.lt
schema:
type: string
- description: Filter less than or equal to the value.
in: query
name: us_code.lte
schema:
type: string
- description: The International Securities Identification Nu
# --- truncated at 32 KB (103 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/polygon/refs/heads/main/openapi/polygon-etfglobal-api-openapi.yml