Your AI team, working in Narwhal API

Financial and economic data APIs for global and localized markets, including economics, equities, FX, commodities, crypto, calendars, filings, predictions, and webhooks.

Start your company

What your team can do in Narwhal API

143 tools to work with, connected with an API key.

Convert FX CurrencyReads only

Convert a decimal amount between two currencies using the current Narwhal FX rate.

Convert Gregorian DateReads only

Convert one Gregorian date into selected regional, lunisolar, Hijri, Persian, and Hindu calendars.

Create Calendar Subscription

Create a revocable ICS calendar subscription for selected countries, dates, economic releases, and holidays. The response includes a secret feed URL that is returned only once.

Create Webhook Destination

Create an HTTPS webhook destination with country, data-family, and optional company filters. The response contains a signing secret exactly once; store it securely and do not log, publish, or share it.

Delete Webhook Destination

Permanently delete a webhook destination and stop future deliveries to it. This destructive action cannot be undone; verify the destination ID and confirm that the destination should be removed.

Find Gregorian DatesReads only

Find Gregorian date or dates matching a date written in another calendar.

Get As ReportedReads only

Get As Reported.

Get Binary PredictionReads only

Get the latest or historical binary probability for an event.

Get Binary Prediction HistoryReads only

Get one page of binary prediction probability bars for a time window.

Get Central Bank Balance SheetReads only

Get a central bank balance-sheet total for a country and month.

Get Central Bank ReservesReads only

Get central bank reserves for a country and month.

Get Commodity Price HistoryReads only

Get closed price bars for one commodity and quote currency from one minute to one day.

Get Commodity Spot PriceReads only

Get the current indicative spot price for a commodity symbol in a quote currency.

Get CompanyReads only

Get one filing-registry company and its industry, historical names, securities, relationships, and current listing IDs by Narwhal company ID.

Get Company FinancialsReads only

Get normalized financial statements for one company, with optional statement, period, year, basis, version, field, and segment filters.

Get Company SectionsReads only

Get Company Sections.

Get CPIReads only

Get the latest headline consumer price index for a country, or the value for a specific monthly period or publication version.

Get CPI HistoryReads only

Get headline CPI observations by period, oldest first.

Get Crypto BarsReads only

Get daily or one-minute price bars for one cryptocurrency pair.

Get Crypto PriceReads only

Get the latest price, 24-hour change, and freshness for one cryptocurrency pair.

Get Crypto PricesReads only

Get latest prices for up to 50 cryptocurrency pairs, including 24-hour changes and freshness data, with per-pair errors for unavailable prices.

Get Delivery EventReads only

Get one Narwhal dataset or release delivery event by UUID.

Get Dividends CalendarReads only

Get company dividends going ex in an inclusive date window of up to seven days.

Get Economic ReleaseReads only

Get one economic release calendar entry by release ID.

Get Equity BarsReads only

Get adjusted daily or one-minute price bars for one stock.

Get Equity Cost of CapitalReads only

Get beta, cost of equity, cost of debt, capital weights, and WACC for one stock.

Get Equity DividendsReads only

Get dividend history for one stock, newest ex-date first.

Get Equity EarningsReads only

Get past earnings reports and EPS surprises for one stock.

Get Equity MoversReads only

Get the top US equity gainers, losers, or most active names.

Get Equity PriceReads only

Get the latest price, change, session, and freshness for one stock.

Get Equity PricesReads only

Get latest prices for up to 50 equity listing IDs, including change and freshness data, with per-ID errors for listings that have no price.

Get Equity ProfileReads only

Get the listing and company profile for one stock.

Get Equity Risk PremiumReads only

Get an equity risk premium for a country and source date.

Get Equity Risk Premium HistoryReads only

Get equity risk premiums by source date for a country.

Get Equity SplitsReads only

Get stock split history for one listing, newest first.

Get Equity ValuationReads only

Get market cap, valuation ratios, dividend yield, and their filing inputs for one stock.

Get Equity Valuation HistoryReads only

Get fiscal-period valuation history for one stock, oldest first.

Get Exchange ClosuresReads only

Get exchange closure, early-close, and late-open days with normal sessions.

Get Extreme PredictionReads only

Get the latest or historical threshold probabilities for an extreme event.

Get Extreme Prediction HistoryReads only

Get one page of extreme prediction probability bars for a time window.

Get FilingReads only

Get Filing.

Get Fund BarsReads only

Get adjusted daily price or NAV bars for a fund, or one-minute bars for an ETF.

Get Fund DistributionsReads only

Get income and capital-gain distributions for one fund, newest ex-date first.

Get Fund PriceReads only

Get the latest exchange price for an ETF or daily NAV for a mutual fund.

Get Fund PricesReads only

Get latest prices or NAVs for up to 50 ETFs and mutual funds, with per-ID errors.

Get Fund ProfileReads only

Get the profile of one ETF or mutual fund.

Get FX Rate BarsReads only

Get closed OHLC bars for one foreign-exchange pair and time range.

Get FX Rate HistoryReads only

Get daily historical rates from one base currency to selected quote currencies.

Get FX RatesReads only

Get current foreign-exchange rates from one base currency, optionally limited to selected quote currencies.

Get GDPReads only

Get latest GDP at current prices or one quarterly period for a country.

Get GDP GrowthReads only

Get latest real GDP growth or one quarterly period for a country.

Get GDP Growth HistoryReads only

Get real GDP-growth observations by period, oldest first.

Get GDP HistoryReads only

Get GDP-at-current-prices observations by period, oldest first.

Get Holidays On DateReads only

Get published public holidays on one date for a country.

Get HS CodeReads only

Get one Harmonized System code and its immediate children.

Get InflationReads only

Get latest headline inflation or one monthly period for a country.

Get Inflation HistoryReads only

Get headline inflation observations by period, oldest first.

Get Insider ActivityReads only

Get Insider Activity.

Get Labour Force ParticipationReads only

Get the latest labour-force participation rate or one period for a country.

Get Labour Force Participation HistoryReads only

Get labour-force participation observations by period, oldest first.

Get Latest Physical Commodity PriceReads only

Get the latest published price and revision for one physical commodity series.

Get Next HolidayReads only

Get the next published public holiday on or after a date.

Get Official Hijri YearReads only

Get calculated and official starts for all twelve Hijri months in a country and AH year.

Get Palm Oil Physical ObservationsReads only

Get native-period scalar or age-schedule observations for one palm-oil series.

Get Palm Oil Physical PriceReads only

Get the latest approved scalar or age-schedule price for one palm-oil series.

Get Physical Commodity ObservationsReads only

Get published observations for one physical commodity series in an optional half-open date range.

Get Physical Commodity SeriesReads only

Get the complete definition, units, attribution, and coverage of one physical price series.

Get Policy PathReads only

Get current cut, hold, and hike odds across an authority's meetings.

Get Policy Path HistoryReads only

Get daily historical policy-path odds for an authority and time window.

Get Policy RateReads only

Get a central bank policy rate for a country.

Get Policy Rate HistoryReads only

Get central bank policy rates by effective date.

Get Population HistoryReads only

Get annual mid-year population observations, oldest first.

Get Prediction TopicReads only

Get one prediction topic with its open events and five most recent closed, settled, or void events.

Get Rate DecisionsReads only

Get central bank rate decisions, newest first, including holds.

Get Regional CPIReads only

Get the latest headline CPI for a supported region.

Get Regional GDPReads only

Get the latest GDP for a supported Malaysian or US region.

Get Scalar PredictionReads only

Get the latest or historical scalar probability distribution for an event.

Get Scalar Prediction HistoryReads only

Get one page of scalar prediction probability bars for a time window.

Get Screen FiltersReads only

Get Screen Filters.

Get SectionsReads only

Get Sections.

Get Splits CalendarReads only

Get company stock splits taking effect in an inclusive date window of up to seven days.

Get Timing PredictionReads only

Get the latest or historical cumulative timing probabilities for an event.

Get Timing Prediction HistoryReads only

Get one page of timing prediction probability bars for a time window.

Get TradeReads only

Get latest merchandise trade or one period for a country.

Get Trade CoverageReads only

List the trade-data tiers and periods available for each country.

Get Trade FlowsReads only

Query exports and imports across reporters, partners, HS chapters, and available source tiers.

Get Trade HistoryReads only

Get merchandise-trade observations by period, oldest first.

Get Trade PartnersReads only

Get a country's goods exports and imports by trading partner.

Get Trade Product PartnersReads only

Get one HS product's trade for a country, broken down by partner.

Get Trade ProductsReads only

Get a country's goods exports and imports by HS product.

Get UnemploymentReads only

Get the latest unemployment rate or one period for a country.

Get Unemployment HistoryReads only

Get unemployment-rate observations by period, oldest first.

Get Webhook Configuration HistoryReads only

Get the recorded configuration versions of one webhook destination.

Get Webhook DestinationReads only

Get one webhook destination and its current configuration.

Get Yield CurveReads only

Get a government bond yield curve for one source date.

Get Yield Curve HistoryReads only

Get government bond yield curves by source date, oldest first.

List Beneficial OwnersReads only

List Beneficial Owners.

List Company FilingsReads only

List Company Filings.

List Company InsidersReads only

List Company Insiders.

List Crypto PairsReads only

List every cryptocurrency pair Narwhal currently prices, optionally by quote currency.

List Data EventsReads only

List recorded Narwhal dataset and release events in oldest-first order, optionally filtered by country.

List Economic ReleasesReads only

List economic release calendar entries by country and date window.

List Equity Risk PremiumReads only

List current equity risk premiums for all covered countries.

List HoldersReads only

List Holders.

List HolidaysReads only

List published holidays and calendar coverage for a country and year, optionally restricted by holiday scope or immutable version.

List HS CodesReads only

Search or list Harmonized System codes from one HS edition.

List Insider FeedReads only

List Insider Feed.

List Insider OwnershipReads only

List Insider Ownership.

List Insider Person TradesReads only

List Insider Person Trades.

List Insider StatementsReads only

List Insider Statements.

List Insider TradesReads only

List Insider Trades.

List Insider Transaction CodesReads only

List Insider Transaction Codes.

List Institutional HoldersReads only

List Institutional Holders.

List Investor Beneficial OwnershipReads only

List Investor Beneficial Ownership.

List Investor FilingsReads only

List Investor Filings.

List Investor HoldingsReads only

List Investor Holdings.

List Latest FilingsReads only

List Latest Filings.

List Palm Oil Physical SeriesReads only

List approved palm-oil physical price series using combinable market and product filters.

List Physical Commodity SeriesReads only

List physical commodity price series using combinable commodity, category, market, price-type, and currency filters.

List Prediction EventsReads only

List prediction-market events, optionally filtered by topic, outcome shape, status, linked release, or resolution time range.

List Prediction TopicsReads only

List prediction-market topics, optionally restricted to one group.

List RegistrationsReads only

List IPO and other securities-registration filings by date, country, company, class, or form.

List Section ItemsReads only

List Section Items.

List Webhook DeliveriesReads only

List one webhook destination's delivery attempts one page at a time.

List Webhook DestinationsReads only

List webhook destinations configured for the connected Narwhal account and its destination limit.

Read Catalogue Latest BatchReads only

Read the latest observation for a batch of catalogue series IDs.

Read Catalogue ObservationsReads only

Read observations of one extended catalogue series, oldest first.

Read Catalogue SeriesReads only

Read metadata for one extended catalogue series.

Read Series ObservationsReads only

Read observations of one economic series, oldest first.

Replay Webhook Delivery

Replay a webhook delivery. This irreversible action emits another real request to the destination's callback URL.

Revoke Calendar Subscription

Permanently revoke a calendar subscription and invalidate its secret ICS feed URL.

Rotate Webhook Secret

Permanently invalidate a webhook destination's current signing secret and return its replacement exactly once. Store the new secret securely and do not log, publish, or share it.

Screen CompaniesReads only

Screen Companies.

Search Beneficial Ownership CompaniesReads only

Search Beneficial Ownership Companies.

Search Beneficial Ownership FilersReads only

Search Beneficial Ownership Filers.

Search CompaniesReads only

Search filing registries for companies and return company IDs used by company and financial-statement tools.

Search Economics CatalogueReads only

Search the extended economic series catalogue.

Search EquitiesReads only

Search equity listings by ticker or company-name prefix and return listing IDs for equity price tools, plus company IDs when a listing matches a company.

Search FundsReads only

Search ETFs and mutual funds by ticker or fund-name prefix and return stable fund IDs.

Search InvestorsReads only

Search Investors.

Search Line ItemsReads only

Search Line Items.

Test Webhook Destination

Send a provider-generated test delivery to an existing webhook destination and return its queueing result. This has an external side effect: Narwhal sends a real webhook request to the destination's configured callback URL.

Update Webhook Destination

Replace the URL, filters, and enabled state of an existing webhook destination. This PATCH is a full replacement, so provide the complete destination configuration.

More in Analytics

See them all β†’

Your company, run by an AI team

Start your company

BRAINER

Continue to B.R.A.I.N.E.R.

Continue with Google or your email.

or