Narwhal API logo

Integrate Narwhal API with your AI CRM

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

Explore Triggers and Actions

Convert FX Currency

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

ActionTry it

Convert Gregorian Date

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

ActionTry it

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.

ActionTry it

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.

ActionTry 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.

ActionTry it

Find Gregorian Dates

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

ActionTry it

Get As Reported

Get As Reported.

ActionTry it

Get Binary Prediction

Get the latest or historical binary probability for an event.

ActionTry it

Get Binary Prediction History

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

ActionTry it

Get Central Bank Balance Sheet

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

ActionTry it

Get Central Bank Reserves

Get central bank reserves for a country and month.

ActionTry it

Get Commodity Price History

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

ActionTry it

Get Commodity Spot Price

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

ActionTry it

Get Company

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

ActionTry it

Get Company Financials

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

ActionTry it

Get Company Sections

Get Company Sections.

ActionTry it

Get CPI

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

ActionTry it

Get CPI History

Get headline CPI observations by period, oldest first.

ActionTry it

Get Crypto Bars

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

ActionTry it

Get Crypto Price

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

ActionTry it

Get Crypto Prices

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

ActionTry it

Get Delivery Event

Get one Narwhal dataset or release delivery event by UUID.

ActionTry it

Get Dividends Calendar

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

ActionTry it

Get Economic Release

Get one economic release calendar entry by release ID.

ActionTry it

Get Equity Bars

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

ActionTry it

Get Equity Cost of Capital

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

ActionTry it

Get Equity Dividends

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

ActionTry it

Get Equity Earnings

Get past earnings reports and EPS surprises for one stock.

ActionTry it

Get Equity Movers

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

ActionTry it

Get Equity Price

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

ActionTry it

Get Equity Prices

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.

ActionTry it

Get Equity Profile

Get the listing and company profile for one stock.

ActionTry it

Get Equity Risk Premium

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

ActionTry it

Get Equity Risk Premium History

Get equity risk premiums by source date for a country.

ActionTry it

Get Equity Splits

Get stock split history for one listing, newest first.

ActionTry it

Get Equity Valuation

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

ActionTry it

Get Equity Valuation History

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

ActionTry it

Get Exchange Closures

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

ActionTry it

Get Extreme Prediction

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

ActionTry it

Get Extreme Prediction History

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

ActionTry it

Get Filing

Get Filing.

ActionTry it

Get Fund Bars

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

ActionTry it

Get Fund Distributions

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

ActionTry it

Get Fund Price

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

ActionTry it

Get Fund Prices

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

ActionTry it

Get Fund Profile

Get the profile of one ETF or mutual fund.

ActionTry it

Get FX Rate Bars

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

ActionTry it

Get FX Rate History

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

ActionTry it

Get FX Rates

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

ActionTry it

Get GDP

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

ActionTry it

Get GDP Growth

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

ActionTry it

Get GDP Growth History

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

ActionTry it

Get GDP History

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

ActionTry it

Get Holidays On Date

Get published public holidays on one date for a country.

ActionTry it

Get HS Code

Get one Harmonized System code and its immediate children.

ActionTry it

Get Inflation

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

ActionTry it

Get Inflation History

Get headline inflation observations by period, oldest first.

ActionTry it

Get Insider Activity

Get Insider Activity.

ActionTry it

Get Labour Force Participation

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

ActionTry it

Get Labour Force Participation History

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

ActionTry it

Get Latest Physical Commodity Price

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

ActionTry it

Get Next Holiday

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

ActionTry it

Get Official Hijri Year

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

ActionTry it

Get Palm Oil Physical Observations

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

ActionTry it

Get Palm Oil Physical Price

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

ActionTry it

Get Physical Commodity Observations

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

ActionTry it

Get Physical Commodity Series

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

ActionTry it

Get Policy Path

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

ActionTry it

Get Policy Path History

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

ActionTry it

Get Policy Rate

Get a central bank policy rate for a country.

ActionTry it

Get Policy Rate History

Get central bank policy rates by effective date.

ActionTry it

Get Population History

Get annual mid-year population observations, oldest first.

ActionTry it

Get Prediction Topic

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

ActionTry it

Get Rate Decisions

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

ActionTry it

Get Regional CPI

Get the latest headline CPI for a supported region.

ActionTry it

Get Regional GDP

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

ActionTry it

Get Scalar Prediction

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

ActionTry it

Get Scalar Prediction History

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

ActionTry it

Get Screen Filters

Get Screen Filters.

ActionTry it

Get Sections

Get Sections.

ActionTry it

Get Splits Calendar

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

ActionTry it

Get Timing Prediction

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

ActionTry it

Get Timing Prediction History

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

ActionTry it

Get Trade

Get latest merchandise trade or one period for a country.

ActionTry it

Get Trade Coverage

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

ActionTry it

Get Trade Flows

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

ActionTry it

Get Trade History

Get merchandise-trade observations by period, oldest first.

ActionTry it

Get Trade Partners

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

ActionTry it

Get Trade Product Partners

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

ActionTry it

Get Trade Products

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

ActionTry it

Get Unemployment

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

ActionTry it

Get Unemployment History

Get unemployment-rate observations by period, oldest first.

ActionTry it

Get Webhook Configuration History

Get the recorded configuration versions of one webhook destination.

ActionTry it

Get Webhook Destination

Get one webhook destination and its current configuration.

ActionTry it

Get Yield Curve

Get a government bond yield curve for one source date.

ActionTry it

Get Yield Curve History

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

ActionTry it

List Beneficial Owners

List Beneficial Owners.

ActionTry it

List Company Filings

List Company Filings.

ActionTry it

List Company Insiders

List Company Insiders.

ActionTry it

List Crypto Pairs

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

ActionTry it

List Data Events

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

ActionTry it

List Economic Releases

List economic release calendar entries by country and date window.

ActionTry it

List Equity Risk Premium

List current equity risk premiums for all covered countries.

ActionTry it

List Holders

List Holders.

ActionTry it

List Holidays

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

ActionTry it

List HS Codes

Search or list Harmonized System codes from one HS edition.

ActionTry it

List Insider Feed

List Insider Feed.

ActionTry it

List Insider Ownership

List Insider Ownership.

ActionTry it

List Insider Person Trades

List Insider Person Trades.

ActionTry it

List Insider Statements

List Insider Statements.

ActionTry it

List Insider Trades

List Insider Trades.

ActionTry it

List Insider Transaction Codes

List Insider Transaction Codes.

ActionTry it

List Institutional Holders

List Institutional Holders.

ActionTry it

List Investor Beneficial Ownership

List Investor Beneficial Ownership.

ActionTry it

List Investor Filings

List Investor Filings.

ActionTry it

List Investor Holdings

List Investor Holdings.

ActionTry it

List Latest Filings

List Latest Filings.

ActionTry it

List Palm Oil Physical Series

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

ActionTry it

List Physical Commodity Series

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

ActionTry it

List Prediction Events

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

ActionTry it

List Prediction Topics

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

ActionTry it

List Registrations

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

ActionTry it

List Section Items

List Section Items.

ActionTry it

List Webhook Deliveries

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

ActionTry it

List Webhook Destinations

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

ActionTry it

Read Catalogue Latest Batch

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

ActionTry it

Read Catalogue Observations

Read observations of one extended catalogue series, oldest first.

ActionTry it

Read Catalogue Series

Read metadata for one extended catalogue series.

ActionTry it

Read Series Observations

Read observations of one economic series, oldest first.

ActionTry it

Replay Webhook Delivery

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

ActionTry it

Revoke Calendar Subscription

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

ActionTry it

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.

ActionTry it

Screen Companies

Screen Companies.

ActionTry it

Search Beneficial Ownership Companies

Search Beneficial Ownership Companies.

ActionTry it

Search Beneficial Ownership Filers

Search Beneficial Ownership Filers.

ActionTry it

Search Companies

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

ActionTry it

Search Economics Catalogue

Search the extended economic series catalogue.

ActionTry it

Search Equities

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.

ActionTry it

Search Funds

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

ActionTry it

Search Investors

Search Investors.

ActionTry it

Search Line Items

Search Line Items.

ActionTry it

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.

ActionTry it

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.

ActionTry it

How the Narwhal API integration works

The Narwhal API integration connects your Dench AI CRM directly to Narwhal API, so agents can read and act on your Narwhal API data as part of everyday work — answering questions in chat, keeping your CRM in sync, and running automations without anyone copying data between tools.

143 actions are available for agents to invoke on your behalf. Every call runs through Narwhal API's own authorization, scoped to the account you connect.

Set up Narwhal API in Dench

  1. 1

    Sign in to your Dench workspace and open Integrations.

  2. 2

    Find Narwhal API and click Connect — you'll authorize access through Narwhal API's own sign-in flow. No API keys or code required.

  3. 3

    Ask an agent to use Narwhal API in chat, or call it from an automation.

  4. 4

    Manage or disconnect the connection any time from workspace settings.

Frequently asked questions

How does the Narwhal API integration work with Dench?

The Dench Narwhal API integration connects your AI CRM to Narwhal API, so AI agents can work with your Narwhal API data as part of chats, automations, and CRM workflows. You connect your account once, and every agent in your workspace can use it — governed by your workspace permissions.

What actions can AI agents perform with Narwhal API via Dench?

The Narwhal API integration currently exposes 143 actions, including Convert FX Currency, Convert Gregorian Date, Create Calendar Subscription, Create Webhook Destination, Delete Webhook Destination, and Find Gregorian Dates. Agents invoke them on your behalf from chat or from automations.

Do I need to write code to connect Narwhal API to Dench?

No. You connect Narwhal API from your Dench workspace using Narwhal API's own sign-in and authorization flow — no API keys to copy, no glue code to maintain.

Is the Narwhal API integration secure?

Connections are authorized through Narwhal API's own authentication flow, and Dench stores only the authorization needed to act on your behalf. You can review and disconnect the Narwhal API connection from your workspace settings at any time.

Narwhal API | Dench AI CRM