Barchart Profiles and Financial Data API
The Profiles and Financial Data API from Barchart — 9 operation(s) for profiles and financial data.
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/barchart-profiles-and-financial-data-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: OnDemand Profiles and Financial Data API
version: 1.0.1
description: Barchart features a diverse set of market and information APIs that can be easily integrated into your website. Whether you're looking for a small, medium, large or enterprise solution, we'll create a custom package for you that exceeds your expectations.
contact:
name: onDemand API Support
url: https://www.barchart.com/ondemand
email: support@barchart.com
termsOfService: https://www.barchart.com/solutions/company/terms-and-privacy
servers:
- url: https://ondemand.websol.barchart.com
tags:
- name: Profiles and Financial Data
paths:
/getProfile.json:
get:
tags:
- Profiles and Financial Data
summary: getProfile
operationId: get-getProfile
description: The getProfile API is used to request information about a publicly traded company, such as sector, industry, company description, CEO, recent earnings, P/E ratio, and address, based on symbol.
parameters:
- in: query
name: apikey
description: Enter the secret API key.
required: true
schema:
type: string
example: YOUR_API_KEY
- in: query
name: symbols
description: A symbol or code that identifies a financial instrument. Multiple symbols separated by a comma may be used.
required: true
schema:
type: string
example: AAPL,GOOG
- in: query
name: fields
description: The fields requested.
required: false
schema:
type: string
example: qtrOneEarnings,qtrTwoEarnings,qtrThreeEarnings,qtrFourEarnings
responses:
'200':
description: OK (Success)
content:
application/json:
schema:
type: object
properties:
status:
type: object
description: The status object when an error occurs or when a response is successful.
required:
- code
- message
properties:
code:
description: The status code of the response.
type: integer
example: 200
message:
description: The status message corresponding to the status code.
type: string
example: Success.
results:
description: The results object of the API operation.
type: array
uniqueItems: true
items:
type: object
properties:
symbol:
description: A symbol or code that identifies a financial instrument. Multiple symbols separated by a comma may be used.
type:
- string
- 'null'
example: AAPL
symbolCode:
description: A code denoting the financial instrument type.
type:
- string
- 'null'
example: STK
exchange:
description: Exchange code for the marketplace where the financial instruments are listed.
type:
- string
- 'null'
example: NASDAQ
exchangeName:
description: The name of the instrument.
type:
- string
- 'null'
example: Apple Inc
instrumentName:
description: The name of the instrument.
type:
- string
- 'null'
example: Apple Inc
sicSector:
description: A four-digit code for classifying industries.
type:
- string
- 'null'
example: '3571'
industry:
description: A code that identifies a group of businesses that produce similar products or services.
type:
- string
- 'null'
example: Computer
subIndustry:
description: A more specific group of businesses within an industry that produce similar products or services.
type:
- string
- 'null'
example: Mini
indexMembership:
description: Indices which a stock may be part of, like the DJIA or S&P 500.
type:
- array
- 'null'
items:
anyOf:
- type: string
example: $DOWC
- type: string
example: $DOWC
- type: string
example: $DOWI
- type: string
example: $RUI
- type: string
example: $RUA
- type: string
example: $SPX
- type: string
example: $ONE
businessSummary:
description: A description of the company.
type:
- string
- 'null'
example: Apple Inc. is engaged in designing, manufacturing and marketing mobile communication and media devices, personal computers, and portable digital music players. The Company\u0027s products and services include iPhone, iPad, Mac, iPod, Apple TV, a portfolio of consumer and professional software applications, the iOS and Mac OS X operating systems, iCloud, and a range of accessory, service and support offerings. It sells its products worldwide through its online stores, its retail stores, its direct sales force, third-party wholesalers, and resellers. Apple Inc. is headquartered in Cupertino, California.
ceo:
description: The Chief Executive Officer.
type:
- string
- 'null'
example: Timothy D. Cook
qtrOneEarnings:
description: The most recent 1st quarter earnings.
type:
- number
- 'null'
format: double
example: 1.68
qtrOneEarningsDate:
description: The reported date of the most recent 1st quarter earnings.
type:
- string
- 'null'
format: date
example: '2021-01-27'
qtrOneEarningsEndDate:
description: The end date of the most recent 1st quarter earnings.
type:
- string
- 'null'
format: date
example: '2020-12-31'
qtrTwoEarnings:
description: The most recent 2nd quarter earnings.
type:
- number
- 'null'
format: double
example: 0.73
qtrTwoEarningsDate:
description: The reported date of the most recent 2nd quarter earnings.
type:
- string
- 'null'
format: date
example: '2020-10-29'
qtrTwoEarningsEndDate:
description: The end date of the most recent 2nd quarter earnings.
type:
- string
- 'null'
format: date
example: '2020-09-30'
qtrThreeEarnings:
description: The most recent 3rd quarter earnings.
type:
- number
- 'null'
format: double
example: 0.64
qtrThreeEarningsDate:
description: The reported date of the most recent 3rd quarter earnings.
type:
- string
- 'null'
format: date
example: '2020-07-30'
qtrThreeEarningsEndDate:
description: The end date of the most recent 3rd quarter earnings.
type:
- string
- 'null'
format: date
example: '2020-06-30'
qtrFourEarnings:
description: The most recent 4th quarter earnings.
type:
- number
- 'null'
format: double
example: 0.64
qtrFourEarningsDate:
description: The reported date of the most recent 4th quarter earnings.
type:
- string
- 'null'
format: date
example: '2020-04-30'
qtrFourEarningsEndDate:
description: The end date of the most recent 4th quarter earnings.
type:
- string
- 'null'
format: date
example: '2020-03-31'
peRatio:
description: The ratio of a company's current share price relative to its earnings (price divided by earnings).
type:
- string
- 'null'
example: '36.07'
epsGrowth:
description: The annual rate of earnings per share growth over the trailing one-year period.
type:
- string
- 'null'
example: '36.410000'
recentEarnings:
description: The last reported quarterly earnings value.
type:
- string
- 'null'
example: '1.68'
annualEPS:
description: The most recent annual net income divided by the number of shares outstanding.
type:
- string
- 'null'
example: '3.7'
address:
description: The address of the company's headquarters.
type:
- string
- 'null'
example: ONE APPLE PARK WAY
city:
description: The city where the company's headquarters is located.
type:
- string
- 'null'
example: CUPERTINO
state:
description: The state where the company's headquarters is located.
type:
- string
- 'null'
example: CA
country:
description: The country where the company's headquarters is located.
type:
- string
- 'null'
example: USA
zipCode:
description: The zip code of the company's headquarters.
type:
- string
- 'null'
example: '95014'
phoneNumber:
description: The company's main phone number.
type:
- string
- 'null'
example: 408-996-1010
instrumentType:
description: The type of instrument. Ex. Equity, Future or Mutual Fund etc.
type:
- string
- 'null'
example: Equity
figi:
description: This code is unique at exchange level, a pair of exchange and company is assigned a unique figi.
type:
- string
- 'null'
example: BBG000BLNQ16 (unique code for IBM for NYSE.)
compositeFigi:
description: This code is shared in all exchanges across a country for a given company.
type:
- string
- 'null'
example: BBG000BLNNH6 (unique code for IBM for US exchanges.)
shareClassFigi:
description: This code is shared in all exchanges across the world for a given company.
type:
- string
- 'null'
example: BBG001S5S399
cik:
description: The Central Index Key (CIK) is used on the SEC's computer systems to identify corporations and individual people who have filed disclosure with the SEC.
type:
- integer
- 'null'
example: 1418091
required:
- symbol
- symbolCode
- exchange
- exchangeName
- instrumentName
- sicSector
- industry
- subIndustry
- businessSummary
- ceo
- address
- city
- state
- country
- zipCode
- phoneNumber
- instrumentType
- figi
- compositeFigi
- shareClassFigi
'204':
description: No Content
'400':
description: Bad Request
'500':
description: Internal Server Error
/getFinancialHighlights.json:
get:
tags:
- Profiles and Financial Data
summary: getFinancialHighlights
operationId: get-getFinancialHighlights
description: The getFinancialHighlights API provides key financial highlights, ratios and statistics for equities based on symbol. Fields include market capitalization, revenue, net income, revenue growth and earnings per share.
parameters:
- in: query
name: apikey
description: Enter the secret API key.
required: true
schema:
type: string
example: YOUR_API_KEY
- in: query
name: symbols
description: A symbol or code that identifies a financial instrument.
required: true
schema:
type: string
example: GOOG,YHOO
- in: query
name: fields
description: The fields requested.
required: false
schema:
type: string
example: lastQtrEPS,annualEPS,ttmEPS
responses:
'200':
description: OK (Success)
content:
application/json:
schema:
type: object
properties:
status:
type: object
description: The status object when an error occurs or when a response is successful.
required:
- code
- message
properties:
code:
description: The status code of the response.
type: integer
example: 200
message:
description: The status message corresponding to the status code.
type: string
example: Success.
results:
description: The results object of the API operation.
type: array
uniqueItems: true
items:
type: object
properties:
symbol:
description: A symbol or code that identifies a financial instrument.
type:
- string
- 'null'
example: GOOG
marketCapitalization:
description: The total number of outstanding shares multiplied by the current market value. In thousands.
type:
- integer
- 'null'
example: 1434772640
insiderShareholders:
description: The percent of stock held by insider shareholders.
type:
- number
- 'null'
format: double
example: 0.1299
annualRevenue:
description: The company's annual revenue. In millions.
type:
- integer
- 'null'
example: 182527
ttmRevenue:
description: The company's revenue from the last 12 months.
type:
- integer
- 'null'
example: null
sharesOutstanding:
description: The total number of shares outstanding. In thousands.
type:
- integer
- 'null'
example: 674137
institutionalShareholders:
description: The percent of stock held by institutional shareholders.
type:
- number
- 'null'
format: double
example: 31.940000534058
annualNetIncome:
description: The company's annual income after taxes but before the payout of common and preferred dividends.
type:
- integer
- 'null'
example: 40269000000
ttmNetIncome:
description: The net income from the last 12 months.
type:
- number
- 'null'
format: double
example: 40269
ttmNetProfitMargin:
description: Net income dividend by revenue from the previous 12 months.
type:
- number
- 'null'
format: double
example: 22.0619
oneYearReturn:
description: The percent change in price over a one-year period.
type:
- number
- 'null'
format: double
example: 39.41
threeYearReturn:
description: The percent change in price over a three-year period.
type:
- number
- 'null'
format: double
example: 93.05
fiveYearReturn:
description: The percent change in price over a five-year period.
type:
- number
- 'null'
format: double
example: 201.26
fiveYearRevenueGrowth:
description: The percent growth in revenue over the past 5-years.
type:
- number
- 'null'
format: double
example: 143.41
fiveYearEarningsGrowth:
description: The percent growth in earnings over the past 5-years.
type:
- number
- 'null'
format: double
example: 156.61
fiveYearDividendGrowth:
description: The percent growth in dividends over the past 5-years.
type:
- number
- 'null'
format: double
lastQtrEPS:
description: The earnings per share for the most recent quarter.
type:
- number
- 'null'
format: double
example: 22.299999
annualEPS:
description: The earnings per share for the most recent annual period.
type:
- number
- 'null'
format: double
example: 58.7
ttmEPS:
description: The earnings per share for the previous 12-months.
type:
- number
- 'null'
format: double
example: 58.700001
annualDividendRate:
description: The annual dividend amount.
type:
- number
- 'null'
format: double
annualDividendYield:
description: The dividends per share over the trailing one-year period as a percentage of the current stock price.
type:
- number
- 'null'
format: double
twelveMonthEPSChg:
description: The change in earnings per share over the past 12-months.
type:
- number
- 'null'
format: double
example: 17.49
peRatio:
description: The current price to earnings ratio.
type:
- number
- 'null'
format: double
example: 35.85
recentEarnings:
description: The last reported earnings per share amount.
type:
- number
- 'null'
format: double
example: 22.3
recentDividends:
description: The amount of the most recent dividends issued per share.
type:
- number
- 'null'
format: double
example: 1.52
recentSplit:
description: The most recent stock split and associated ratio.
type:
- string
- 'null'
example: null
beta:
description: A measure of the volatility of a security in comparison to the volatility of the market.
type:
- number
- 'null'
format: double
example: 0.98
weightAlpha:
description: The weighted alpha of the sector.
type:
- number
- 'null'
format: double
example: 56.74
required:
- symbol
- marketCapitalization
- insiderShareholders
- annualRevenue
- ttmRevenue
- sharesOutstanding
- institutionalShareholders
- oneYearReturn
- threeYearReturn
- fiveYearReturn
- fiveYearRevenueGrowth
- fiveYearEarningsGrowth
- fiveYearDividendGrowth
- annualEPS
- annualDividendRate
- annualDividendYield
- weightAlpha
'204':
description: No Content
'400':
description: Bad Request
'500':
description: Internal Server Error
/getFinancialRatios.json:
get:
tags:
- Profiles and Financial Data
summary: getFinancialRatios
operationId: get-getFinancialRatios
description: The getFinancialRatios API provides key financial ratios for equities based on symbol. The fields include earnings per share, return on equity and price to earnings.
parameters:
- in: query
name: apikey
description: Enter the secret API key.
required: true
schema:
type: string
example: YOUR_API_KEY
- in: query
name: symbols
description: A symbol or code that identifies a financial instrument.
required: true
schema:
type: string
example: AAPL,GOOG
- in: query
name: fields
description: The fields requested.
required: false
schema:
type: string
example: debtEquity,interestCoverage,bookValue,dividendPayout
responses:
'200':
description: OK (Success)
content:
application/json:
schema:
type: object
properties:
status:
type: object
description: The status object when an error occurs or when a response is successful.
required:
- code
- message
properties:
code:
description: The status code of the response.
type: integer
example: 200
message:
description: The status message corresponding to the status code.
type: string
example: Success.
results:
description: The results object of the API operation.
type: array
uniqueItems: true
items:
type: object
properties:
symbol:
description: A symbol or code that identifies a financial instrument.
type:
- string
- 'null'
example: AAPL
eps:
description: Earnings per share, calculated by dividing the total net income by the company's outstanding shares.
type:
- number
- 'null'
format: double
example: 3.7
profitMargin:
description: Net profit divided by revenue, expressed as a percentage.
type:
- number
- 'null'
format: double
example: 21.73
roe:
description: Net income divided by shareholder equity, expressed as a percentage.
type:
- number
- 'null'
format: double
example: 90.59
roa:
description: Net income divided by total assets, expressed as a percentage.
type:
- number
- 'null'
format: double
example: 19.44
priceSales:
description: Market capitalization divided by revenue.
type:
- number
- 'null'
format: double
example: 8.14529
priceEarnings:
description: Stock price divided by earnings per share.
type:
- number
- 'null'
format: double
example: 36.07
priceBook:
description: Market capitalization divided by total book value.
type:
- number
- 'null'
format: double
example: 21.13
debtEquity:
description: Total debt divided by equity.
type:
- number
- 'null'
format: double
example: 1.49916
interestC
# --- truncated at 32 KB (87 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/barchart/refs/heads/main/openapi/barchart-profiles-and-financial-data-api-openapi.yml