# Finage

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

- **Category:** analytics
- **Auth:** API_KEY
- **Tools:** 46
- **Triggers:** 0
- **Slug:** `FINAGE`
- **Version:** 20260217_00

## Tools

### Convert Cryptocurrencies

**Slug:** `FINAGE_CONVERT_CRYPTO`

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

**Slug:** `FINAGE_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

**Slug:** `FINAGE_GET_BONDS_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

**Slug:** `FINAGE_GET_COUNTRY_DETAIL`

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

**Slug:** `FINAGE_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

**Slug:** `FINAGE_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

**Slug:** `FINAGE_GET_CRYPTO_DETAILED`

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

**Slug:** `FINAGE_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

**Slug:** `FINAGE_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

**Slug:** `FINAGE_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

**Slug:** `FINAGE_GET_CRYPTO_PREVIOUS_CLOSE`

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

**Slug:** `FINAGE_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

**Slug:** `FINAGE_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

**Slug:** `FINAGE_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

**Slug:** `FINAGE_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

**Slug:** `FINAGE_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

**Slug:** `FINAGE_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

**Slug:** `FINAGE_GET_FOREX_PREVIOUS_CLOSE`

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

**Slug:** `FINAGE_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 Market News

**Slug:** `FINAGE_GET_MARKET_NEWS`

Tool to retrieve real-time and historical market news for stocks, forex, and crypto from Finage's API. Use when you need market news, updates, or research on market trends for any symbol across stocks, currencies, or cryptocurrencies.

### Get Most Active US Stocks

**Slug:** `FINAGE_GET_MOST_ACTIVE_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

**Slug:** `FINAGE_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

**Slug:** `FINAGE_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

**Slug:** `FINAGE_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 Bid/Ask Quote

**Slug:** `FINAGE_GET_STOCK_DETAILS`

Retrieves real-time bid/ask quote information for a given stock symbol. Returns current bid and ask prices along with their respective order sizes.

### Get Stock End-of-Day Data

**Slug:** `FINAGE_GET_STOCK_END_OF_DAY_DATA`

Retrieves the most recent end-of-day (EOD) OHLCV data for a US stock symbol. Returns the daily opening, high, low, closing prices and trading volume for the previous completed trading day (e.g., yesterday's data if markets are open, or last Friday's data on a Monday before market open). Use cases: - Get the previous trading day's closing price for AAPL - Check yesterday's trading volume for MSFT - Compare previous day performance across multiple stocks Note: For historical EOD data on specific dates, use the 'Get Stock Historical Data' action instead.

### Get Stock Historical Data

**Slug:** `FINAGE_GET_STOCK_HISTORICAL_DATA`

Fetches historical stock data for US stocks from Finage API. This tool retrieves OHLCV (open, high, low, close, volume) data for specified date ranges. Example: Get AAPL stock data for the last 30 days with daily intervals. 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

**Slug:** `FINAGE_GET_STOCK_LAST_QUOTE`

This tool fetches the latest quote information for a specific stock symbol, providing real-time bid and ask prices, along with their respective sizes and a timestamp. It is essential for trading and market analysis, fetching a JSON object with details like symbol, ask, bid, asize, bsize, and timestamp.

### Get Stock Last Trade

**Slug:** `FINAGE_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

**Slug:** `FINAGE_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.

### Get Stock Market News

**Slug:** `FINAGE_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 Snapshot

**Slug:** `FINAGE_GET_STOCK_MARKET_SNAPSHOT`

This tool provides a comprehensive snapshot of the US stock market data, allowing users to get the latest quotes and trades for multiple stocks in a single API request. It is ideal as the first tool because it offers broad market coverage, does not require resource IDs or external dependencies, and can be used independently with just API authentication.

### Get Stock Market Status

**Slug:** `FINAGE_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

**Slug:** `FINAGE_GET_STOCK_PREVIOUS_CLOSE`

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 Previous Close

**Slug:** `FINAGE_GET_STOCK_PREVIOUS_CLOSE2`

Retrieves the previous trading day's closing data for a US stock symbol. Returns OHLCV data (Open, High, Low, Close, Volume) and timestamp for the most recent completed trading day. Use this when you need end-of-day stock prices for analysis, portfolio tracking, or calculating day-over-day price changes. Note: Some symbols may not have data available depending on the API plan.

### Get Stock Snapshot

**Slug:** `FINAGE_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 Stock Tick Data

**Slug:** `FINAGE_GET_STOCK_TICK_DATA`

Retrieves aggregated OHLCV (Open, High, Low, Close, Volume) stock market data for US stocks. Returns candlestick/bar data at configurable time intervals (1min, 5min, 1hour, 1day, etc.). Useful for charting, technical analysis, and historical price research.

### Get Technical Indicators

**Slug:** `FINAGE_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

**Slug:** `FINAGE_GET_TOP_GAINERS`

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

**Slug:** `FINAGE_GET_TOP_LOSERS`

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

**Slug:** `FINAGE_LIST_CRYPTOCURRENCIES`

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

**Slug:** `FINAGE_LIST_SYMBOLS`

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

**Slug:** `FINAGE_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

**Slug:** `FINAGE_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

**Slug:** `FINAGE_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

**Slug:** `FINAGE_SEARCH_MARKET`

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.
