Quickstart
Follow this workflow to go from security discovery to quote, valuation, statement, filing, and earnings data in a few requests.
Overview
Most integrations start with security search, then move into quote data, valuation, statements, filings, and earnings workflows.
Use the examples below as a minimal starting path.
1. Search For A Company
curl -H "Authorization: Bearer $your_api_key" \
"https://api.apifinance.ai/securities/search?query=apple&page=1&per_page=5"
Use search when you need to find the correct ticker before requesting other datasets.
2. Fetch A Quote
curl -H "Authorization: Bearer $your_api_key" \
"https://api.apifinance.ai/securities/AAPL/quote"
This returns current quote fields such as price, open, high, low, volume, and trailing return context.
3. Fetch Current Valuation
curl -H "Authorization: Bearer $your_api_key" \
"https://api.apifinance.ai/securities/AAPL/valuation"
This returns valuation fields such as market cap, enterprise value, P/E, EV/EBITDA, and yield-style ratios.
4. Fetch Statement History
Quarterly income statement:
curl -H "Authorization: Bearer $your_api_key" \
"https://api.apifinance.ai/statements/income?ticker=AAPL&timeframe=quarterly&limit=4"
Annual balance sheet:
curl -H "Authorization: Bearer $your_api_key" \
"https://api.apifinance.ai/statements/balance_sheet?ticker=AAPL&timeframe=annual&limit=3"
Quarterly cash flow statement:
curl -H "Authorization: Bearer $your_api_key" \
"https://api.apifinance.ai/statements/cash_flow?ticker=AAPL&timeframe=quarterly&limit=4"
Use statement endpoints when you need multi-period fundamentals for historical analysis.
5. Fetch Filings
curl -H "Authorization: Bearer $your_api_key" \
"https://api.apifinance.ai/sec_filings?ticker=AAPL&form=10-K&page=1&per_page=20"
This returns filing metadata for the symbol, including filing date, accession number, report period, acceptance time, and amendment flag.
Use it when you need an audit trail back to the underlying SEC filing.
6. Fetch Earnings Calendar
curl -H "Authorization: Bearer $your_api_key" \
"https://api.apifinance.ai/calendar/earnings?ticker=AAPL"
This returns upcoming or current earnings-calendar rows for the ticker with estimate and surprise context when available.
7. Fetch Insider Trading Activity
curl -H "Authorization: Bearer $your_api_key" \
"https://api.apifinance.ai/securities/AAPL/insider_tradings?start=2024-01-01&end=2024-12-31"
This returns insider purchase and sale history filtered to transaction codes P and S.
JavaScript Example
const response = await fetch('https://api.apifinance.ai/securities/MSFT/quote', {
headers: {
Authorization: `Bearer ${process.env.your_api_key}`
}
})
if (!response.ok) {
throw new Error(`Request failed with ${response.status}`)
}
const data = await response.json()
console.log(data)
Next step
Move from docs into a real evaluation flow
Check the playground, review trust details, and create a key only after the response shape and coverage fit your workflow.