evidinvest-com Financial Data API
The Financial Data API from evidinvest-com — 13 operation(s) for 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/evidinvest-com:evidinvest-com-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: EvidInvest Financial Data API
version: 1.0.0
description: 'REST API exposing 54 financial data, valuation, SEC filing, and portfolio tools, every figure traceable to an SEC filing. Designed for AI agents and external LLMs. Two ways to pay: (1) Bearer API key from https://evidinvest.com/settings/api-keys, 1 MCP credit per call; (2) NO ACCOUNT NEEDED — pay per request with the Machine Payments Protocol (https://mpp.dev) on the /v1/paid/* routes. Prices are dynamic and quoted free at GET /v1/quote.'
contact:
name: EvidInvest
url: https://evidinvest.com
servers:
- url: https://mcp.evidinvest.com
description: Production
security:
- BearerAuth: []
tags:
- name: Financial Data
paths:
/v1/tools/get_company_profile:
post:
operationId: call_get_company_profile
summary: Get company profile information including name, sector, industry, exchange, and…
description: Get company profile information including name, sector, industry, exchange, and description
tags:
- Financial Data
x-mcp-title: Company profile
x-mcp-annotations:
title: Company profile
readOnlyHint: true
destructiveHint: false
idempotentHint: true
openWorldHint: false
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
arguments:
type: object
properties:
symbol:
type: string
description: Stock symbol (e.g., AAPL, MSFT)
required:
- symbol
required:
- arguments
responses:
'200':
description: Tool result
content:
application/json:
schema:
type: object
properties:
result: {}
toolName:
type: string
creditsUsed:
type: integer
required:
- result
- toolName
- creditsUsed
'400':
description: Invalid arguments — e.g. a fetch-mode filing search (no `query`) that names no document; the body says which fields to pass
'401':
description: Missing or invalid API key
'402':
description: No MCP credits remaining
'404':
description: Tool not found
'429':
description: Rate limit or monthly tool call limit reached
'500':
description: Tool execution error
/v1/tools/get_income_statement:
post:
operationId: call_get_income_statement
summary: Get income statement data with key metrics like revenue, gross profit…
description: Get income statement data with key metrics like revenue, gross profit, operating income, EBITDA, and net income
tags:
- Financial Data
x-mcp-title: Income statement
x-mcp-annotations:
title: Income statement
readOnlyHint: true
destructiveHint: false
idempotentHint: true
openWorldHint: false
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
arguments:
type: object
properties:
symbol:
type: string
description: Stock symbol (e.g., AAPL, MSFT)
period:
type: string
enum:
- annual
- quarterly
description: 'Period type (default: annual)'
limit:
type: number
description: Number of periods to return
required:
- symbol
required:
- arguments
responses:
'200':
description: Tool result
content:
application/json:
schema:
type: object
properties:
result: {}
toolName:
type: string
creditsUsed:
type: integer
required:
- result
- toolName
- creditsUsed
'400':
description: Invalid arguments — e.g. a fetch-mode filing search (no `query`) that names no document; the body says which fields to pass
'401':
description: Missing or invalid API key
'402':
description: No MCP credits remaining
'404':
description: Tool not found
'429':
description: Rate limit or monthly tool call limit reached
'500':
description: Tool execution error
/v1/tools/get_balance_sheet:
post:
operationId: call_get_balance_sheet
summary: Get balance sheet data with assets, liabilities, equity, and debt information
tags:
- Financial Data
x-mcp-title: Balance sheet
x-mcp-annotations:
title: Balance sheet
readOnlyHint: true
destructiveHint: false
idempotentHint: true
openWorldHint: false
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
arguments:
type: object
properties:
symbol:
type: string
description: Stock symbol (e.g., AAPL, MSFT)
period:
type: string
enum:
- annual
- quarterly
description: 'Period type (default: annual)'
limit:
type: number
description: Number of periods to return
required:
- symbol
required:
- arguments
responses:
'200':
description: Tool result
content:
application/json:
schema:
type: object
properties:
result: {}
toolName:
type: string
creditsUsed:
type: integer
required:
- result
- toolName
- creditsUsed
'400':
description: Invalid arguments — e.g. a fetch-mode filing search (no `query`) that names no document; the body says which fields to pass
'401':
description: Missing or invalid API key
'402':
description: No MCP credits remaining
'404':
description: Tool not found
'429':
description: Rate limit or monthly tool call limit reached
'500':
description: Tool execution error
/v1/tools/get_cash_flow:
post:
operationId: call_get_cash_flow
summary: Get cash flow statement with operating, investing, and financing activities
tags:
- Financial Data
x-mcp-title: Cash flow statement
x-mcp-annotations:
title: Cash flow statement
readOnlyHint: true
destructiveHint: false
idempotentHint: true
openWorldHint: false
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
arguments:
type: object
properties:
symbol:
type: string
description: Stock symbol (e.g., AAPL, MSFT)
period:
type: string
enum:
- annual
- quarterly
description: 'Period type (default: annual)'
limit:
type: number
description: Number of periods to return
required:
- symbol
required:
- arguments
responses:
'200':
description: Tool result
content:
application/json:
schema:
type: object
properties:
result: {}
toolName:
type: string
creditsUsed:
type: integer
required:
- result
- toolName
- creditsUsed
'400':
description: Invalid arguments — e.g. a fetch-mode filing search (no `query`) that names no document; the body says which fields to pass
'401':
description: Missing or invalid API key
'402':
description: No MCP credits remaining
'404':
description: Tool not found
'429':
description: Rate limit or monthly tool call limit reached
'500':
description: Tool execution error
/v1/tools/get_growth_rates:
post:
operationId: call_get_growth_rates
summary: Get compound annual growth rates (CAGR) for revenue, net income, EPS, equity…
description: Get compound annual growth rates (CAGR) for revenue, net income, EPS, equity, and cash flow
tags:
- Financial Data
x-mcp-title: Growth rates
x-mcp-annotations:
title: Growth rates
readOnlyHint: true
destructiveHint: false
idempotentHint: true
openWorldHint: false
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
arguments:
type: object
properties:
symbol:
type: string
description: Stock symbol (e.g., AAPL, MSFT)
periods:
type: array
items:
type: string
enum:
- 1Y
- 2Y
- 3Y
- 5Y
- 10Y
- 15Y
- 20Y
- 30Y
description: 'Specific periods to return (default: all)'
required:
- symbol
required:
- arguments
responses:
'200':
description: Tool result
content:
application/json:
schema:
type: object
properties:
result: {}
toolName:
type: string
creditsUsed:
type: integer
required:
- result
- toolName
- creditsUsed
'400':
description: Invalid arguments — e.g. a fetch-mode filing search (no `query`) that names no document; the body says which fields to pass
'401':
description: Missing or invalid API key
'402':
description: No MCP credits remaining
'404':
description: Tool not found
'429':
description: Rate limit or monthly tool call limit reached
'500':
description: Tool execution error
/v1/tools/get_pe_ratios:
post:
operationId: call_get_pe_ratios
summary: Get price-to-earnings ratios (basic and diluted) with historical data.
description: 'Get price-to-earnings ratios (basic and diluted) with historical data. Each row states its eps_basis: ttm_quarterly (four de-duplicated interim periods spanning 240-370 days) or annual (the filed fiscal year). A null ratio means no twelve-month window exists for that period, e.g. a company that reports twice a year.'
tags:
- Financial Data
x-mcp-title: P/E ratios
x-mcp-annotations:
title: P/E ratios
readOnlyHint: true
destructiveHint: false
idempotentHint: true
openWorldHint: false
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
arguments:
type: object
properties:
symbol:
type: string
description: Stock symbol (e.g., AAPL, MSFT)
period:
type: string
enum:
- quarterly
- yearly
- both
description: 'Which filing frequency to return: quarterly (interim periods, trailing-twelve-month ratios), yearly (filed fiscal years), or both (default, interleaved by date).'
limit:
type: number
description: 'Number of periods to return (default: 10)'
required:
- symbol
required:
- arguments
responses:
'200':
description: Tool result
content:
application/json:
schema:
type: object
properties:
result: {}
toolName:
type: string
creditsUsed:
type: integer
required:
- result
- toolName
- creditsUsed
'400':
description: Invalid arguments — e.g. a fetch-mode filing search (no `query`) that names no document; the body says which fields to pass
'401':
description: Missing or invalid API key
'402':
description: No MCP credits remaining
'404':
description: Tool not found
'429':
description: Rate limit or monthly tool call limit reached
'500':
description: Tool execution error
/v1/tools/get_segment_revenue:
post:
operationId: call_get_segment_revenue
summary: Revenue by product or operating segment, cut from the filer's own inline XBRL…
description: Revenue by product or operating segment, cut from the filer's own inline XBRL in its 10-K, with the accession and a completeness check per period (revenue only — no segment operating income)
tags:
- Financial Data
x-mcp-title: Segment revenue
x-mcp-annotations:
title: Segment revenue
readOnlyHint: true
destructiveHint: false
idempotentHint: true
openWorldHint: false
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
arguments:
type: object
properties:
symbol:
type: string
description: Stock symbol (e.g., AAPL, MSFT)
segment_type:
type: string
enum:
- operating
- product
- both
description: 'Which XBRL axis to return: product, operating (reportable segments), or both (default) — a filer usually publishes one or the other'
years:
type: number
description: 'How many of the most recent filed annual periods to return, 1-5 (default: 3)'
required:
- symbol
required:
- arguments
responses:
'200':
description: Tool result
content:
application/json:
schema:
type: object
properties:
result: {}
toolName:
type: string
creditsUsed:
type: integer
required:
- result
- toolName
- creditsUsed
'400':
description: Invalid arguments — e.g. a fetch-mode filing search (no `query`) that names no document; the body says which fields to pass
'401':
description: Missing or invalid API key
'402':
description: No MCP credits remaining
'404':
description: Tool not found
'429':
description: Rate limit or monthly tool call limit reached
'500':
description: Tool execution error
/v1/tools/get_geographic_revenue:
post:
operationId: call_get_geographic_revenue
summary: Revenue by region or country as the filer labels it, cut from the 10-K's inline…
description: Revenue by region or country as the filer labels it, cut from the 10-K's inline XBRL, with the accession and a completeness check per period
tags:
- Financial Data
x-mcp-title: Geographic revenue
x-mcp-annotations:
title: Geographic revenue
readOnlyHint: true
destructiveHint: false
idempotentHint: true
openWorldHint: false
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
arguments:
type: object
properties:
symbol:
type: string
description: Stock symbol (e.g., AAPL, MSFT)
years:
type: number
description: 'How many of the most recent filed annual periods to return, 1-5 (default: 3)'
required:
- symbol
required:
- arguments
responses:
'200':
description: Tool result
content:
application/json:
schema:
type: object
properties:
result: {}
toolName:
type: string
creditsUsed:
type: integer
required:
- result
- toolName
- creditsUsed
'400':
description: Invalid arguments — e.g. a fetch-mode filing search (no `query`) that names no document; the body says which fields to pass
'401':
description: Missing or invalid API key
'402':
description: No MCP credits remaining
'404':
description: Tool not found
'429':
description: Rate limit or monthly tool call limit reached
'500':
description: Tool execution error
/v1/tools/get_major_customers:
post:
operationId: call_get_major_customers
summary: 'Customer concentration from the 10-K: customers above the 10% disclosure…'
description: 'Customer concentration from the 10-K: customers above the 10% disclosure threshold with their revenue share and the filer''s own sentence as evidence, plus concentration-of-risk paragraphs. Narrow per-issuer coverage; an uncovered symbol returns available:false'
tags:
- Financial Data
x-mcp-title: Major customers
x-mcp-annotations:
title: Major customers
readOnlyHint: true
destructiveHint: false
idempotentHint: true
openWorldHint: false
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
arguments:
type: object
properties:
symbol:
type: string
description: Stock symbol (e.g., AAPL, MSFT)
years:
type: number
description: 'How many of the most recent filed 10-K years to return, 1-5 (default: 3)'
required:
- symbol
required:
- arguments
responses:
'200':
description: Tool result
content:
application/json:
schema:
type: object
properties:
result: {}
toolName:
type: string
creditsUsed:
type: integer
required:
- result
- toolName
- creditsUsed
'400':
description: Invalid arguments — e.g. a fetch-mode filing search (no `query`) that names no document; the body says which fields to pass
'401':
description: Missing or invalid API key
'402':
description: No MCP credits remaining
'404':
description: Tool not found
'429':
description: Rate limit or monthly tool call limit reached
'500':
description: Tool execution error
/v1/tools/get_company_peers:
post:
operationId: call_get_company_peers
summary: Get peer/comparable companies for a stock
tags:
- Financial Data
x-mcp-title: Company peers
x-mcp-annotations:
title: Company peers
readOnlyHint: true
destructiveHint: false
idempotentHint: true
openWorldHint: false
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
arguments:
type: object
properties:
symbol:
type: string
description: Stock symbol (e.g., AAPL, MSFT)
required:
- symbol
required:
- arguments
responses:
'200':
description: Tool result
content:
application/json:
schema:
type: object
properties:
result: {}
toolName:
type: string
creditsUsed:
type: integer
required:
- result
- toolName
- creditsUsed
'400':
description: Invalid arguments — e.g. a fetch-mode filing search (no `query`) that names no document; the body says which fields to pass
'401':
description: Missing or invalid API key
'402':
description: No MCP credits remaining
'404':
description: Tool not found
'429':
description: Rate limit or monthly tool call limit reached
'500':
description: Tool execution error
/v1/tools/get_peer_multiples:
post:
operationId: call_get_peer_multiples
summary: Get trading multiples for a company's peer group
tags:
- Financial Data
x-mcp-title: Peer multiples
x-mcp-annotations:
title: Peer multiples
readOnlyHint: true
destructiveHint: false
idempotentHint: true
openWorldHint: false
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
arguments:
type: object
properties:
symbol:
type: string
description: Stock symbol (e.g., AAPL, MSFT)
maxPeers:
type: number
description: 'Maximum number of peers to include (default: 10)'
required:
- symbol
required:
- arguments
responses:
'200':
description: Tool result
content:
application/json:
schema:
type: object
properties:
result: {}
toolName:
type: string
creditsUsed:
type: integer
required:
- result
- toolName
- creditsUsed
'400':
description: Invalid arguments — e.g. a fetch-mode filing search (no `query`) that names no document; the body says which fields to pass
'401':
description: Missing or invalid API key
'402':
description: No MCP credits remaining
'404':
description: Tool not found
'429':
description: Rate limit or monthly tool call limit reached
'500':
description: Tool execution error
/v1/tools/get_company_snapshot:
post:
operationId: call_get_company_snapshot
summary: 'Get a rich financial snapshot of a company: price, market cap, sector, PE, P/S…'
description: 'Get a rich financial snapshot of a company: price, market cap, sector, PE, P/S, EV/EBITDA, revenue, EBITDA, net income, description, and next_earnings (next report date; confirmed=true only when the company announced it in an 8-K)'
tags:
- Financial Data
x-mcp-title: Company snapshot
x-mcp-annotations:
title: Company snapshot
readOnlyHint: true
destructiveHint: false
idempotentHint: true
openWorldHint: false
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
arguments:
type: object
properties:
symbol:
type: string
description: Stock symbol (e.g., AAPL, MSFT)
required:
- symbol
required:
- arguments
responses:
'200':
description: Tool result
content:
application/json:
schema:
type: object
properties:
result: {}
toolName:
type: string
creditsUsed:
type: integer
required:
- result
- toolName
- creditsUsed
'400':
description: Invalid arguments — e.g. a fetch-mode filing search (no `query`) that names no document; the body says which fields to pass
'401':
description: Missing or invalid API key
'402':
description: No MCP credits remaining
'404':
description: Tool not found
'429':
description: Rate limit or monthly tool call limit reached
'500':
description: Tool execution error
/v1/tools/get_growth_trajectory:
post:
operationId: call_get_growth_trajectory
summary: Get a company's EPS growth trajectory and two-stage DCF fair value range.
description: Get a company's EPS growth trajectory and two-stage DCF fair value range. Returns trajectory shape (ACCELERATING/STABLE/RECOVERY/DECELERATING/DETERIORATING), near-term growth rate (g_near), long-term industry rate (g_long), and a conservative–moderate–bull fair value range.
tags:
- Financial Data
x-mcp-title: Growth trajectory
x-mcp-annotations:
title: Growth trajectory
readOnlyHint: true
destructiveHint: false
idempotentHint: true
openWorldHint: false
requestBody:
required: true
content:
application/json:
schema:
type: object
properties:
arguments:
type: object
properties:
symbol:
type: string
description: Stock symbol (e.g., AAPL, MSFT)
required:
- symbol
required:
- arguments
responses:
'200':
description: Tool result
content:
application/json:
schema:
type: object
properties:
result: {}
toolName:
type: string
creditsUsed:
type: integer
required:
- result
- toolName
- creditsUsed
'400':
description: Invalid arguments — e.g. a fetch-mode filing search (no `query`) that names no document; the body says which fields to pass
'401':
description: Missing or invalid API key
'402':
description: No MCP credits remaining
'404':
description: Tool not found
'429':
description: Rate limit or monthly tool call limit reached
'500':
description: Tool execution error
components:
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: EvidInvest API key (evid_sk_...)