Polygon Fx:snapshot API
The fx:snapshot API from Polygon — 3 operation(s) for fx:snapshot.
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-fx-snapshot-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 Fx:snapshot 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: fx:snapshot
paths:
/v2/snapshot/locale/global/markets/forex/tickers:
get:
description: 'Get the current minute, day, and previous day’s aggregate, as well as the last trade and quote for all traded forex symbols.
<br />
<br />
Note: Snapshot data is cleared at 12am EST and gets populated as data is received from the exchanges. This can happen as early as 4am EST.
'
operationId: GetForexSnapshotTickers
parameters:
- description: A case-sensitive comma separated list of tickers to get snapshots for. For example, C:EURUSD, C:GBPCAD, and C:AUDINR. Empty string defaults to querying all tickers.
in: query
name: tickers
schema:
items:
type: string
type: array
responses:
'200':
content:
application/json:
example:
status: OK
tickers:
- day:
c: 0.11778221
h: 0.11812263
l: 0.11766631
o: 0.11797149
v: 77794
lastQuote:
a: 0.11780678
b: 0.11777952
t: 1605280919000
x: 48
min:
c: 0.117769
h: 0.11779633
l: 0.11773698
n: 1
o: 0.11778
t: 1684422000000
v: 202
prevDay:
c: 0.11797258
h: 0.11797258
l: 0.11797149
o: 0.11797149
v: 2
vw: 0
ticker: C:HKDCHF
todaysChange: -0.00019306
todaysChangePerc: -0.1636482
updated: 1605280919000
schema:
allOf:
- properties:
status:
description: The status of this request's response.
type: string
required:
- status
type: object
- properties:
tickers:
description: An array of snapshot data for the specified tickers.
items:
properties:
day:
description: The most recent daily bar for this ticker.
properties:
c:
description: The close price for the symbol in the given time period.
format: double
type: number
h:
description: The highest price for the symbol in the given time period.
format: double
type: number
l:
description: The lowest price for the symbol in the given time period.
format: double
type: number
o:
description: The open price for the symbol in the given time period.
format: double
type: number
v:
description: The trading volume of the symbol in the given time period.
format: double
type: number
required:
- o
- h
- l
- c
- v
type: object
fmv:
description: Fair market value is only available on Business plans. It is our proprietary algorithm to generate a real-time, accurate, fair market value of a tradable security. For more information, <a rel="nofollow" target="_blank" href="https://massive.com/contact">contact us</a>.
format: double
type: number
lastQuote:
description: The most recent quote for this ticker.
properties:
a:
description: The ask price.
format: double
type: number
b:
description: The bid price.
format: double
type: number
t:
description: The millisecond accuracy timestamp of the quote.
type: integer
x:
description: The exchange ID on which this quote happened.
type: integer
required:
- a
- b
- t
- x
type: object
min:
description: The most recent minute bar for this ticker.
properties:
c:
description: The close price for the symbol in the given time period.
format: double
type: number
h:
description: The highest price for the symbol in the given time period.
format: double
type: number
l:
description: The lowest price for the symbol in the given time period.
format: double
type: number
n:
description: The number of transactions in the aggregate window.
type: integer
o:
description: The open price for the symbol in the given time period.
format: double
type: number
t:
description: The Unix millisecond timestamp for the start of the aggregate window.
type: integer
v:
description: The trading volume of the symbol in the given time period.
format: double
type: number
type: object
prevDay:
description: The previous day's bar for this ticker.
properties:
c:
description: The close price for the symbol in the given time period.
format: double
type: number
h:
description: The highest price for the symbol in the given time period.
format: double
type: number
l:
description: The lowest price for the symbol in the given time period.
format: double
type: number
o:
description: The open price for the symbol in the given time period.
format: double
type: number
v:
description: The trading volume of the symbol in the given time period.
format: double
type: number
vw:
description: The volume weighted average price.
format: double
type: number
required:
- o
- h
- l
- c
- v
- vw
type: object
ticker:
description: The exchange symbol that this item is traded under.
type: string
todaysChange:
description: The value of the change from the previous day.
format: double
type: number
todaysChangePerc:
description: The percentage change since the previous day.
format: double
type: number
updated:
description: The last updated timestamp.
type: integer
required:
- day
- lastQuote
- min
- prevDay
- ticker
- todaysChange
- todaysChangePerc
- updated
type: object
type: array
type: object
text/csv:
example: 'day_c,day_h,day_l,day_o,day_v,lastQuote_a,lastQuote_b,lastQuote_i,lastQuote_t,lastQuote_x,min_c,min_h,min_l,min_o,min_v,prevDay_c,prevDay_h,prevDay_l,prevDay_o,prevDay_v,prevDay_vw
1.18403,1.1906,1.18001,1.18725,83578,1.18403,1.18398,0,1606163759000,48,1.18396,1.18423,1.1838,1.18404,41,1.18724,1.18727,1.18725,1.18725,5,0
'
schema:
type: string
description: Get current state for all tickers
default:
description: Unexpected error
summary: All Tickers
tags:
- fx:snapshot
x-polygon-entitlement-allowed-timeframes:
- description: Real Time Data
name: realtime
- description: 15 minute delayed data
name: delayed
x-polygon-entitlement-data-type:
description: Aggregate data
name: aggregates
x-polygon-entitlement-market-type:
description: Forex data
name: fx
/v2/snapshot/locale/global/markets/forex/tickers/{ticker}:
get:
description: 'Get the current minute, day, and previous day’s aggregate, as well as the last trade and quote for a single traded currency symbol.
<br />
<br />
Note: Snapshot data is cleared at 12am EST and gets populated as data is received from the exchanges.
'
operationId: GetForexSnapshotTicker
parameters:
- description: The forex ticker.
example: C:EURUSD
in: path
name: ticker
required: true
schema:
type: string
responses:
'200':
content:
application/json:
example:
request_id: ad76e76ce183002c5937a7f02dfebde4
status: OK
ticker:
day:
c: 1.18403
h: 1.1906
l: 1.18001
o: 1.18725
v: 83578
lastQuote:
a: 1.18403
b: 1.18398
i: 0
t: 1606163759000
x: 48
min:
c: 1.18396
h: 1.18423
l: 1.1838
n: 85
o: 1.18404
t: 1684422000000
v: 41
prevDay:
c: 1.18724
h: 1.18727
l: 1.18725
o: 1.18725
v: 5
vw: 0
ticker: C:EURUSD
todaysChange: -0.00316
todaysChangePerc: -0.27458312
updated: 1606163759000
schema:
allOf:
- properties:
status:
description: The status of this request's response.
type: string
required:
- status
type: object
- properties:
request_id:
description: A request id assigned by the server.
type: string
required:
- request_id
type: object
- properties:
ticker:
description: Contains the requested snapshot data for the specified ticker.
properties:
day:
description: The most recent daily bar for this ticker.
properties:
c:
description: The close price for the symbol in the given time period.
format: double
type: number
h:
description: The highest price for the symbol in the given time period.
format: double
type: number
l:
description: The lowest price for the symbol in the given time period.
format: double
type: number
o:
description: The open price for the symbol in the given time period.
format: double
type: number
v:
description: The trading volume of the symbol in the given time period.
format: double
type: number
required:
- o
- h
- l
- c
- v
type: object
fmv:
description: Fair market value is only available on Business plans. It is our proprietary algorithm to generate a real-time, accurate, fair market value of a tradable security. For more information, <a rel="nofollow" target="_blank" href="https://massive.com/contact">contact us</a>.
format: double
type: number
lastQuote:
description: The most recent quote for this ticker.
properties:
a:
description: The ask price.
format: double
type: number
b:
description: The bid price.
format: double
type: number
t:
description: The millisecond accuracy timestamp of the quote.
type: integer
x:
description: The exchange ID on which this quote happened.
type: integer
required:
- a
- b
- t
- x
type: object
min:
description: The most recent minute bar for this ticker.
properties:
c:
description: The close price for the symbol in the given time period.
format: double
type: number
h:
description: The highest price for the symbol in the given time period.
format: double
type: number
l:
description: The lowest price for the symbol in the given time period.
format: double
type: number
n:
description: The number of transactions in the aggregate window.
type: integer
o:
description: The open price for the symbol in the given time period.
format: double
type: number
t:
description: The Unix millisecond timestamp for the start of the aggregate window.
type: integer
v:
description: The trading volume of the symbol in the given time period.
format: double
type: number
type: object
prevDay:
description: The previous day's bar for this ticker.
properties:
c:
description: The close price for the symbol in the given time period.
format: double
type: number
h:
description: The highest price for the symbol in the given time period.
format: double
type: number
l:
description: The lowest price for the symbol in the given time period.
format: double
type: number
o:
description: The open price for the symbol in the given time period.
format: double
type: number
v:
description: The trading volume of the symbol in the given time period.
format: double
type: number
vw:
description: The volume weighted average price.
format: double
type: number
required:
- o
- h
- l
- c
- v
- vw
type: object
ticker:
description: The exchange symbol that this item is traded under.
type: string
todaysChange:
description: The value of the change from the previous day.
format: double
type: number
todaysChangePerc:
description: The percentage change since the previous day.
format: double
type: number
updated:
description: The last updated timestamp.
type: integer
required:
- day
- lastQuote
- min
- prevDay
- ticker
- todaysChange
- todaysChangePerc
- updated
type: object
type: object
text/csv:
example: 'day_c,day_h,day_l,day_o,day_v,lastQuote_a,lastQuote_b,lastQuote_i,lastQuote_t,lastQuote_x,min_c,min_h,min_l,min_o,min_v,prevDay_c,prevDay_h,prevDay_l,prevDay_o,prevDay_v,prevDay_vw
1.18403,1.1906,1.18001,1.18725,83578,1.18403,1.18398,0,1606163759000,48,1.18396,1.18423,1.1838,1.18404,41,1.18724,1.18727,1.18725,1.18725,5,0
'
schema:
type: string
description: Get current state for a ticker
default:
description: Unexpected error
summary: Ticker
tags:
- fx:snapshot
x-polygon-entitlement-allowed-timeframes:
- description: Real Time Data
name: realtime
- description: 15 minute delayed data
name: delayed
x-polygon-entitlement-data-type:
description: Aggregate data
name: aggregates
x-polygon-entitlement-market-type:
description: Forex data
name: fx
/v2/snapshot/locale/global/markets/forex/{direction}:
get:
description: 'Get the current top 20 gainers or losers of the day in forex markets.
<br />
<br />
Top gainers are those tickers whose price has increased by the highest percentage since the previous day''s close.
Top losers are those tickers whose price has decreased by the highest percentage since the previous day''s close.
<br />
<br />
Note: Snapshot data is cleared at 12am EST and gets populated as data is received from the exchanges.
'
operationId: GetForexSnapshotDirection
parameters:
- description: 'The direction of the snapshot results to return.
'
example: gainers
in: path
name: direction
required: true
schema:
enum:
- gainers
- losers
type: string
responses:
'200':
content:
application/json:
example:
status: OK
tickers:
- day:
c: 0.886156
h: 0.887111
l: 0.8825327
o: 0.8844732
v: 1041
lastQuote:
a: 0.8879606
b: 0.886156
t: 1605283204000
x: 48
min:
c: 0.886156
h: 0.886156
l: 0.886156
n: 1
o: 0.886156
t: 1684422000000
v: 1
prevDay:
c: 0.8428527
h: 0.889773
l: 0.8428527
o: 0.8848539
v: 1078
vw: 0
ticker: C:PLNILS
todaysChange: 0.0433033
todaysChangePerc: 5.13770674
updated: 1605330008999
schema:
allOf:
- properties:
status:
description: The status of this request's response.
type: string
required:
- status
type: object
- properties:
tickers:
description: An array of snapshot data for the specified tickers.
items:
properties:
day:
description: The most recent daily bar for this ticker.
properties:
c:
description: The close price for the symbol in the given time period.
format: double
type: number
h:
description: The highest price for the symbol in the given time period.
format: double
type: number
l:
description: The lowest price for the symbol in the given time period.
format: double
type: number
o:
description: The open price for the symbol in the given time period.
format: double
type: number
v:
description: The trading volume of the symbol in the given time period.
format: double
type: number
required:
- o
- h
- l
- c
- v
type: object
fmv:
description: Fair market value is only available on Business plans. It is our proprietary algorithm to generate a real-time, accurate, fair market value of a tradable security. For more information, <a rel="nofollow" target="_blank" href="https://massive.com/contact">contact us</a>.
format: double
type: number
lastQuote:
description: The most recent quote for this ticker.
properties:
a:
description: The ask price.
format: double
type: number
b:
description: The bid price.
format: double
type: number
t:
description: The millisecond accuracy timestamp of the quote.
type: integer
x:
description: The exchange ID on which this quote happened.
type: integer
required:
- a
- b
- t
- x
type: object
min:
description: The most recent minute bar for this ticker.
properties:
c:
description: The close price for the symbol in the given time period.
format: double
type: number
h:
description: The highest price for the symbol in the given time period.
format: double
type: number
l:
description: The lowest price for the symbol in the given time period.
format: double
type: number
n:
description: The number of transactions in the aggregate window.
type: integer
o:
description: The open price for the symbol in the given time period.
format: double
type: number
t:
description: The Unix millisecond timestamp for the start of the aggregate window.
type: integer
v:
description: The trading volume of the symbol in the given time period.
format: double
type: number
type: object
prevDay:
description: The previous day's bar for this ticker.
properties:
c:
description: The close price for the symbol in the given time period.
format: double
type: number
h:
description: The highest price for the symbol in the given time period.
format: double
type: number
l:
description: The lowest price for the symbol in the given time period.
format: double
type: number
o:
description: The open price for the symbol in the given time period.
format: double
type: number
v:
description: The trading volume of the symbol in the given time period.
format: double
type: number
vw:
description: The volume weighted average price.
format: double
type: number
required:
- o
- h
- l
- c
- v
- vw
type: object
ticker:
description: The exchange symbol that this item is traded under.
type: string
todaysChange:
description: The value of the change from the previous day.
format: double
type: number
todaysChangePerc:
description: The percentage change since the previous day.
format: double
type: number
updated:
description: The last updated timestamp.
type: integer
required:
- day
- lastQuote
- min
- prevDay
- ticker
- todaysChange
- todaysChangePerc
- updated
type: object
type: array
type: object
text/csv:
example:
tickers: 'day_c,day_h,day_l,day_o,day_v,lastQuote_a,lastQuote_b,lastQuote_t,lastQuote_x,min_c,min_h,min_l,min_o,min_v,prevDay_c,prevDay_h,prevDay_l,prevDay_o,prevDay_v,prevDay_vw
0.886156,0.887111,0.8825327,0.8844732,1041,0.8879606,0.8
# --- truncated at 32 KB (39 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/polygon/refs/heads/main/openapi/polygon-fx-snapshot-api-openapi.yml