Finage

40 tools available

Finage provides secure RESTful APIs for real-time and historical financial market data covering stocks, forex, cryptocurrencies, indices, ETFs, and commodities.

Connect Finage to Definable to answer ad-hoc analytics questions, detect anomalies, auto-generate weekly summaries. Personas call Finage's 40 tools directly from chat or scheduled flows. Plug into a data-analysis persona to ask questions in plain English — the agent runs the queries.

Common workflows with Finage

01

Weekly anomaly digest

  1. Query metrics from this tool
  2. Compare against rolling baseline
  3. Surface anomalies with reasoning
02

Funnel deep-dive

  1. Pull funnel events for a date range
  2. Compute drop-offs at each step
  3. Generate a written analysis
03

Cohort answers on demand

  1. User asks a question in chat
  2. Agent translates it to a query
  3. Returns numbers + a chart-ready summary

Finage actions 40

Every Finage action below is a callable tool any Definable persona can invoke.

Convert Cryptocurrencies

Tool to convert cryptocurrencies using real-time exchange rates from the Finage API. Use when you need to convert between different cryptocurrencies (e.g., BTC to ETH, USD to DOGE, SHIB to BTC).

Convert Currency

Tool to convert currencies using real-time forex exchange rates from Finage API. Use when you need to convert an amount from one currency to another with current market rates.

Get US Treasury Bond Rate

Retrieve the current interest rate for a US Treasury bond by maturity. Returns the Federal Reserve's constant maturity Treasury (CMT) rate as a percentage. Useful for tracking benchmark interest rates, yield curve analysis, and financial market research.

Get Country Details

Tool to retrieve detailed information about a country including currency, phone code, and flag. Use when you need country metadata for financial or geographical context.

Get Crypto Aggregates

Tool to retrieve aggregated OHLCV time-series data for cryptocurrency pairs over specified time periods. Use when you need historical tick bars (candlestick data) for crypto trading pairs with customizable timeframes.

Get Crypto Detail

Tool to get detailed fundamental information about a cryptocurrency including description, developers, website, social media links, and technical details. Use when you need comprehensive background information about a cryptocurrency beyond just price data.

Get Detailed Crypto Information

This tool fetches detailed cryptocurrency information including current price, price changes, volume, market cap, and historical highs/lows for a specific cryptocurrency pair. Use when comprehensive crypto market data is needed beyond basic price quotes.

Get Crypto Last Quote

Tool to get the last quote with bid/ask prices in real-time for a cryptocurrency pair. Use when you need current market data for crypto trading pairs including bid/ask spreads and order sizes.

Get Crypto Last Trade

Tool to get the latest trade information and prices in real-time for a cryptocurrency pair. Use when you need current pricing data for cryptocurrencies like Bitcoin, Ethereum, or other digital assets.

Get Crypto News

Tool to retrieve real-time and historical news for cryptocurrency markets with fast In-Memory Cache Engine. Use when you need crypto market news, updates on cryptocurrencies, or research on crypto trends for a specific symbol.

Get Crypto Previous Close Data

Tool to get the previous day's closing data for a cryptocurrency pair. Use when you need historical end-of-day data including opening price, highest price, lowest price, closing price, trading volume, and timestamp for crypto pairs.

Get Crypto Snapshot

Tool to get a comprehensive snapshot of cryptocurrency market data with latest quotes and trades in one request. Use when you need broad crypto market coverage or real-time data for multiple cryptocurrency pairs simultaneously.

Get Currency Detail

Tool to get detailed information about a forex currency pair including currency codes and country flags. Use when you need to retrieve metadata about a specific currency pair such as the base and quote currencies.

Get Forex Last Quote

Tool to get the latest real-time bid/ask quote for a forex pair or metal (e.g., GBPUSD, XAUUSD). Use when you need current market data for forex trading pairs or commodities including bid/ask spreads.

Get Forex Last Trade

Tool to get the last trade information for a forex currency pair. Use when you need current price data for forex trading pairs like EURUSD or GBPUSD.

Get Forex Market Aggregates

Tool to retrieve aggregated OHLCV (Open, High, Low, Close, Volume) data for forex and metal pairs over specified time periods. Use when you need historical or intraday bars for forex pairs (e.g., GBPUSD, EURUSD) or metals (e.g., XAUUSD for gold). Supports multiple timeframes from minute-level to yearly aggregations for trends, highs/lows, and backtesting use cases.

Get Forex News

Tool to retrieve real-time and historical news for forex markets from Finage's API. Use when you need forex market news, currency updates, or research on forex trends for a specific currency symbol.

Get Forex Previous Close Data

Tool to get the previous day's closing data for a forex currency pair. Use when you need historical end-of-day data including opening price, highest price, lowest price, closing price, trading volume, and timestamp for forex pairs.

Get Forex Snapshot

Tool to get a comprehensive snapshot of forex market data with latest quotes and trades in one request. Use when you need broad forex market coverage or real-time data for multiple currency pairs simultaneously.

Get Most Active US Stocks

Tool to get a list of the most actively traded US stocks. Use when you need to identify which stocks are experiencing the highest trading volume in the current market session.

Get SEC RSS Feed

Tool to retrieve the SEC RSS feed for recent EDGAR filings. Use when you need information about recent SEC filings including title, date, link, CIK, form type, and ticker symbol.

Get Sector Performance

Tool to retrieve performance metrics across US market sectors. Use when you need to analyze sector-level market trends or compare performance across different industries.

Get Stock Company Details

Tool to retrieve detailed company information and stock fundamentals for a given ticker symbol. Use when you need comprehensive information about a company including CEO, description, industry, sector, market cap, employee count, and headquarters details.

Get Stock Historical Data (Deprecated)

DEPRECATED: Use FINAGE_GET_STOCK_MARKET_AGGREGATES instead. Fetches historical OHLCV (open, high, low, close, volume) data for US stocks from Finage API. Returned timestamps are UTC-aligned; non-trading days are omitted entirely — do not treat date gaps as zero values. Ensure from_date/to_date are past UTC dates to avoid partial or future bars. Requirements: - Symbols must be alphabetic US ticker symbols in English - No numeric-only symbols - No exchange prefixes or suffixes - Standard ticker format only (typically 1-5 characters) For supported symbols and complete documentation, visit: https://finage.co.uk/docs

Get Stock Last Quote

Fetches the latest single-tick quote for a stock symbol, returning a JSON object with fields: symbol, ask, bid, asize, bsize, and timestamp. Suitable for real-time trading and market analysis. During pre/post-market or closed sessions, the returned quote may be stale — always compare the timestamp field against current UTC before treating data as live. Returns only the latest tick; not a substitute for historical or charted series data. Rate-limited: throttle to 2–5 requests/second and honor Retry-After headers on HTTP 429.

Get Stock Last Trade

Tool to get the most recent trade information for a specified US stock symbol. Use when you need real-time price and volume data from the latest executed trade.

Get Stock Market Aggregates

Retrieves aggregated OHLCV (Open, High, Low, Close, Volume) data for US stocks only. Supports stock symbols like AAPL, MSFT, GOOGL. Does NOT support forex pairs (EUR/USD, GBP/USD), commodities (XAU/USD for gold), or cryptocurrencies - those require separate forex/crypto endpoints. All returned timestamps are in UTC.

Get Stock Market News

This tool retrieves the latest market news from Finage's API. It provides comprehensive market news and updates, including news filtering by specific stock symbols, thereby supporting real-time market insights, investment decisions, and research on market trends.

Get Stock Market Status

Tool to check if stock, forex, and crypto markets are open, closed, or in extended hours. Use when you need to determine current market status with optional country, holidays, and trading hours information.

Get Stock Previous Close Data

This tool retrieves the previous day's closing data for a specific stock symbol. It provides essential trading information including the opening price, highest price, lowest price, closing price, trading volume, and timestamp for the previous trading day. It complements other Finage tools by offering detailed previous day data, which is useful for computing day-over-day change and informing daily trading analysis. REQUIRED PARAMETERS: - symbol: A valid stock ticker symbol (e.g., 'AAPL', 'MSFT', 'GOOGL'). You MUST provide this parameter. OPTIONAL PARAMETERS: - date: Specific date in YYYY-MM-DD format for historical data - unadjusted: Boolean to control whether prices are adjusted for splits

Get Stock Snapshot

Tool to get comprehensive snapshot of all US stock market data including latest quotes and trades with one single API request. Use when you need current market data for multiple stocks efficiently.

Get Technical Indicators

Tool to get technical indicators and signals for stocks from Finage API. Use when you need to analyze stock trends with technical indicators like moving averages (SMA, EMA, WMA), momentum indicators (RSI, Williams %R), or trend indicators (ADX). Returns historical OHLCV data along with calculated indicator values.

Get Top Gaining US Stocks

Tool to get list of top gaining US stocks by percentage change. Use when you need to identify the best performing stocks in the US market. Returns symbol, price, change amount, change percentage, and company name for each stock.

Get Top Losing US Stocks

Tool to get list of top losing US stocks by percentage change. Use when you need to identify the worst performing stocks in the US market. Returns symbol, price, change amount, change percentage, and company name for each stock.

List Cryptocurrencies by Market Cap

Tool to get a list of all available cryptocurrencies ranked by market capitalization. Use when you need to discover cryptocurrencies by market cap, find top crypto assets, or browse paginated crypto data. Results can be sorted by market cap in ascending or descending order.

List Symbols by Market Type

Tool to get a paginated list of all available symbols for a specified market type (us-stock, ca-stock, in-stock, ru-stock, forex, crypto, index). Use when you need to discover available symbols for trading, search for specific symbols by name or ticker, or browse symbols by market category. Supports pagination for large result sets and optional search filtering.

Search Country

Tool to search for countries by name and retrieve their details including country code, currency, flag, and phone code. Use when you need to find country information based on a partial or full country name match.

Search Cryptocurrency

Tool to search for cryptocurrencies by name or symbol. Use when you need to find cryptocurrency information, discover available crypto symbols, or validate cryptocurrency identifiers.

Search Currency

Tool to search for currency pairs and forex symbols by currency code or partial match. Use when you need to discover available currency pairs, find forex symbols, or search for currencies by code (e.g., USD, EUR).

Search Market for Stocks

Tool to search for stocks in a specific market by company name or symbol. Use when you need to find stock symbols by partial matches, discover available stocks, or look up ticker symbols by company name.

Frequently asked questions

What can I automate with Finage on Definable?

Anything Finage exposes through its API. Common analytics workflows on Definable include answer ad-hoc analytics questions, detect anomalies, auto-generate weekly summaries. Personas can call any of the 40 Finage tools directly, then chain the result into another integration without you writing code.

How does Finage authentication work?

Finage uses API_KEY on Definable. You connect once from the integrations page, scoped to the permissions you choose, and from then on any persona that has the integration enabled can act on your behalf. Tokens are encrypted at rest and rotated automatically.

Is the Finage integration included in my Definable plan?

Yes — every Definable plan, including Starter, includes access to all 40 Finage tools. You only need a separate Finage subscription if Finage itself charges per seat or per API call.

Is using Finage through Definable secure?

Every call from a persona to Finage is logged with the user, persona, prompt, and response. Tokens never leave Definable's secrets vault, scopes are configurable per persona, and you can revoke access at any time from the integration page.

How do I get started with Finage on Definable?

Sign up for Definable, open the integrations page, find Finage, and connect via OAuth or API key. You can immediately attach Finage to any persona and start running workflows. The free Starter plan includes 5,000 credits/month.

What Finage actions does Definable expose?

Definable exposes all 40 Finage actions as callable tools — including `Convert Cryptocurrencies`, `Convert Currency`, `Get US Treasury Bond Rate`, plus 37 more. Each tool gets a typed parameter schema so personas know exactly how to call it.

Ready to automate with Finage?

Wire it up in minutes. No coding required.

← All integrations