Finage US Stocks API
The US Stocks API from Finage — 5 operation(s) for us stocks.
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/finage-us-stocks-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:
title: Finage Market Data US Stocks API
description: Finage is a real-time and historical market data provider covering US and global stocks, forex, cryptocurrencies, indices, ETFs, bonds, and company fundamentals. This OpenAPI was generated by API Evangelist from Finage's own machine-readable docs database (https://api.finage.co.uk/op/v1/endpoints/list — the same JSON the docs at https://finage.co.uk/docs/api render); every path, parameter, and example comes from that source. All endpoints are read-only GET requests authenticated with an apikey query parameter. Responses must be requested with gzip Accept-Encoding (the API returns 406 "GZip compression required" otherwise).
version: 1.0.0
contact:
name: Finage Support
email: support@finage.co.uk
url: https://finage.co.uk
x-apievangelist:
generated: '2026-07-22'
method: generated
source: https://api.finage.co.uk/op/v1/endpoints/list
servers:
- url: https://api.finage.co.uk
security:
- apiKey: []
tags:
- name: US Stocks
paths:
/last/stock/{symbol}:
get:
operationId: stockLastQuote
summary: Stock Last Quote
description: You can get the last quote for a symbol with this endpoint.
tags:
- US Stocks
parameters:
- name: symbol
in: path
required: true
description: 'Symbol Name (eg: AAPL)'
schema:
type: string
responses:
'200':
description: Stock Last Quote response.
content:
application/json:
schema:
type: object
properties:
symbol:
type: string
description: Symbol Name
ask:
type: number
description: Ask Price
bid:
type: number
description: Bid Price
asize:
type: integer
description: Ask Size
bsize:
type: integer
description: Bid Size
timestamp:
type: integer
format: int64
description: Last Update Time
example:
symbol: AAPL
ask: 118.55
bid: 118.53
asize: 3
bsize: 1
timestamp: 1604710766331
'401':
$ref: '#/components/responses/Unauthorized'
/last/trade/stock/{symbol}:
get:
operationId: stockLastTrade
summary: Stock Last Trade
description: You can get the last trade for a symbol with this endpoint.
tags:
- US Stocks
parameters:
- name: symbol
in: path
required: true
description: Symbol Name
schema:
type: string
responses:
'200':
description: Stock Last Trade response.
content:
application/json:
schema:
type: object
properties:
symbol:
type: string
description: Symbol Name
price:
type: number
description: Trade Price
size:
type: integer
description: Trade Size
timestamp:
type: integer
format: int64
description: Last Update Time
example:
symbol: AAPL
price: 131.99
size: 5
timestamp: 1608847193770
'401':
$ref: '#/components/responses/Unauthorized'
/agg/stock/{symbol}/{multiply}/{time}/{from}/{to}:
get:
operationId: stockMarketAggregatesApi
summary: Stock Market Aggregates API
description: With the Stock Market Aggregates endpoint, you can get the OHLCV bars of the stock market.
tags:
- US Stocks
parameters:
- name: symbol
in: path
required: true
description: Symbol Name
schema:
type: string
- name: multiply
in: path
required: true
description: Time Multiplier
schema:
type: string
- name: time
in: path
required: true
description: Size of the time. [minute, hour, day, week, month, quarter, year]
schema:
type: string
- name: from
in: path
required: true
description: Start date
schema:
type: string
- name: to
in: path
required: true
description: End date
schema:
type: string
- name: limit
in: query
required: false
description: Limit of the results. Default is 100, maximum allowed limit is 50000. Please set a limit if you are using the API in the production.
schema:
type: string
- name: sort
in: query
required: false
description: You can sort the results by timestamp. asc will return ascending results oldest to newest, desc will return descending results newest to oldest. Default is asc.
schema:
type: string
- name: dbt_filter
in: query
required: false
description: Daily-based time filter. You can allow the time filters to filter daily based. Otherwise, the filter will only trim the start and end of the output. Default is false.
schema:
type: string
- name: st
in: query
required: false
description: Start time in UTC. (Eg. 17:30)
schema:
type: string
- name: et
in: query
required: false
description: End time in UTC. (Eg. 17:45)
schema:
type: string
- name: date_format
in: query
required: false
description: 'Choose date format: ''dt'' for datetime or ''ts'' for timestamp. [Default: timestamp]'
schema:
type: string
responses:
'200':
description: Stock Market Aggregates API response.
content:
application/json:
schema:
type: object
properties:
symbol:
type: string
description: Symbol Name
totalResults:
type: integer
description: Result Count
o:
type: number
description: Open Price
h:
type: number
description: Highest Price
l:
type: number
description: Lowest Price
c:
type: number
description: Close Price
v:
type: integer
description: Volume
t:
type: integer
format: int64
description: Timestamp
example:
symbol: AAPL
totalResults: 3
results:
- o: 80.88
h: 81.19
l: 79.7375
c: 80.3625
v: 118746872
t: 1580878800000
- o: 80.6425
h: 81.305
l: 80.0662
c: 81.3025
v: 105392140
t: 1580965200000
- o: 80.5925
h: 80.85
l: 79.5
c: 80.0075
v: 117684048
t: 1581051600000
'401':
$ref: '#/components/responses/Unauthorized'
/agg/stock/prev-close/{symbol}:
get:
operationId: stockMarketPreviousClose
summary: Stock Market Previous Close
description: With the Stock Market Previous Close API, you can get the historiacal end of day data and also previous day's last tick bar of the stock market.
tags:
- US Stocks
parameters:
- name: symbol
in: path
required: true
description: Symbol of the stock
schema:
type: string
responses:
'200':
description: Stock Market Previous Close response.
content:
application/json:
schema:
type: object
properties:
symbol:
type: string
description: Symbol of the stock
totalResults:
type: integer
description: Total result size
o:
type: number
description: Open price
h:
type: number
description: High price
l:
type: number
description: Low price
c:
type: number
description: Close price
v:
type: integer
description: Volume
t:
type: integer
format: int64
description: Timestamp [ms]
example:
symbol: AAPL
totalResults: 1
results:
- o: 124.81
h: 125.71
l: 121.84
c: 122.06
v: 112966340
t: 1614805200000
'401':
$ref: '#/components/responses/Unauthorized'
/snapshot/stock:
get:
operationId: stockSnapshotApi
summary: Stock Snapshot API
description: Stock Snapshot API will give you access to all U.S Market with one single API request. You can get the latest trades, quotes or both of them with one request.
tags:
- US Stocks
parameters:
- name: quotes
in: query
required: true
description: Enable or disable last quotes. Default is true.
schema:
type: string
- name: trades
in: query
required: true
description: Enable or disable last trades. Default is false.
schema:
type: string
- name: symbols
in: query
required: true
description: You can get the data from specific symbols by using this query. If you leave it empty, you will get the all available last data. (Separate symbols with commas.)
schema:
type: string
responses:
'200':
description: Stock Snapshot API response.
content:
application/json:
schema:
type: object
properties:
s:
type: string
description: Stock symbol
p:
type: number
description: Last trade price
a:
type: number
description: Last ask price
b:
type: number
description: Last bid price
asz:
type: integer
description: Ask size
bsz:
type: integer
description: Bid size
sz:
type: integer
description: Trade size
t:
type: integer
format: int64
description: Timestamp (microseconds)
totalResults:
type: integer
description: Total incoming symbol number.
example:
totalResults: 1
lastQuotes:
- s: AAPL
a: 215.604252
b: 215.407484
asz: 1
bsz: 5
t: 1726494971049
lastTrades:
- s: AAPL
p: 215.505522
sz: 1
t: 1726494971049
'401':
$ref: '#/components/responses/Unauthorized'
components:
responses:
Unauthorized:
description: Missing or invalid API key, or your plan does not include this market.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: Please use your APIKey to make a request.
schemas:
Error:
type: object
description: Finage error envelope — a single error string.
properties:
error:
type: string
description: Human-readable error message.
securitySchemes:
apiKey:
type: apiKey
name: apikey
in: query
description: Finage API key, passed as the apikey query parameter on every request. Get one at https://moon.finage.co.uk/register.
externalDocs:
description: Finage API documentation
url: https://finage.co.uk/docs/api