> **Building with AI coding agents?** Install the authstack plugin with one command. This equips your agent with accurate Scalekit implementation patterns.
>
> **Recommended** (the `-y` flags skip prompts, so the command runs without an interactive terminal):
> ```bash
> npx -y @scalekit-inc/cli setup -y
> ```
>
> Global:
> ```bash
> npm install -g @scalekit-inc/cli
> scalekit setup -y
> ```
>
> Supports Claude Code, Cursor, GitHub Copilot, Codex + skills for other Agent Skills-compatible agents in `~/.agents/skills`.
> Skills: integrate-agentkit, implement-saaskit, add-mcp-oauth, implement-sso, implement-scim.
> [Full setup guide](https://docs.scalekit.com/dev-kit/build-with-ai/)

---

# Connect AI agents to Finage

The Finage connector lets your AI agent act in each user's Finage account. Each user connects their own Finage API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 60 tools.

**Authentication:** API Key
**Categories:** Accounting & Finance, Analytics
**Tools:** 60: 60 read, 0 write, 0 destructive
**Users sign in with:** API key
**Built by:** Scalekit connector
**Try it:** [Playground in the Scalekit dashboard](https://app.scalekit.com/ws/signup?sk_intent=playground&provider=FINAGE)

## Setup

1. ### Install the SDK

   **Node.js**

   ```bash
   npm install @scalekit-sdk/node dotenv
   ```

   **Python**

   ```bash
   pip install scalekit-sdk-python python-dotenv
   ```

2. ### Set your credentials

   Add your Scalekit credentials to your `.env` file. Find values in **[app.scalekit.com](https://app.scalekit.com)** > **Developers** > **API Credentials**.

   ```sh title=".env"
   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>
   ```

3. ### Create the Finage connection

   In **AgentKit > Connections**, create a Finage connection. The name you give it is the `connection_name` your code passes. See [Configure connections](/agentkit/connections/).

4. ### Authorize a user and make your first call

   **Node.js** (`quickstart.mts`)

   ```typescript
   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   import { createInterface } from 'node:readline/promises'

   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENVIRONMENT_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions

   const connector = 'finage'
   const identifier = 'user_123'

   // Generate an authorization link for the user
   const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
   console.log('Authorize Finage:', link)
   const rl = createInterface({ input: process.stdin, output: process.stdout })
   await rl.question('Press Enter after authorizing...')
   rl.close()

   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'finage_crypto_market_cap_ranks_list',
     toolInput: {},
   })
   console.log(result)
   ```

   ```bash
   npx tsx quickstart.mts
   ```

   **Python** (`quickstart.py`)

   ```python
   import os
   from scalekit import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()

   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions

   connection_name = "finage"
   identifier = "user_123"

   # Generate an authorization link for the user
   link_response = actions.get_authorization_link(
       connection_name=connection_name,
       identifier=identifier,
   )
   print("Authorize Finage:", link_response.link)
   input("Press Enter after authorizing...")

   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="finage_crypto_market_cap_ranks_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)
   ```

   ```bash
   python quickstart.py
   ```

   Each user opens the link once and enters their Finage credentials there. See [Authorize a user](/agentkit/tools/authorize/) for the full flow and statuses.

## Tools

Pass the exact name to `execute_tool`, with an input like each tool's example. To ask for a tool that's missing, use the [request form](https://scalekitsupport.portal.usepylon.com/forms/request-a-connector-tool).

**Node.js**

```typescript
const result = await actions.executeTool({
  toolName: 'finage_balance_sheet_statements_get',
  toolInput: {
    symbol: '<symbol>',
  },
  connector: 'finage',
  identifier: 'user_123',
})
```

**Python**

```python
result = actions.execute_tool(
    tool_name="finage_balance_sheet_statements_get",
    tool_input={
        "symbol": "<symbol>",
    },
    connection_name="finage",
    identifier="user_123",
)
```

`result.data` is the app's response as JSON, and `result.execution_id` (`executionId` in Node.js) is the ID of the call.

### `finage_balance_sheet_statements_get`

Get Balance Sheet Statements · Read-only

Get a US company's balance sheets, annual or quarterly. Returns statements with assets, liabilities and equity.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): US Stock symbol. Example: AAPL.
- `limit` (`integer`, optional): Number of statements to return. Example: 4.
- `period` (`string`, optional): Statement period: annual (default) or quarter. Example: quarter. One of: `annual`, `quarter`.

Example input: `{"symbol":"<symbol>"}`

### `finage_bond_rate_get`

Get US Bond Rate · Read-only

Get the latest yield (percent) of a US Treasury bond, for example DGS10 for the 10-year. Returns the rate and date.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): Bond symbol, for example DGS1, DGS2, DGS10 or DGS30. Example: DGS10.

Example input: `{"symbol":"<symbol>"}`

### `finage_ca_stock_aggregates_get`

Get Canadian Stock Aggregates · Read-only

Get OHLC bars for a Canadian stock over a date range at a chosen bar size. Returns bars with open, high, low, close, volume and timestamp.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `from_date` (`string`, required): Start date (YYYY-MM-DD). Example: 2026-01-05.
- `symbol` (`string`, required): Canadian stock symbol, for example BMO. Example: BMO.
- `time` (`string`, required): Bar size unit. Example: 1day. One of: `1min`, `5min`, `15min`, `30min`, `45min`, `1h`, `2h`, `4h`, `1day`, `1week`, `1month`.
- `to_date` (`string`, required): End date (YYYY-MM-DD). Example: 2026-01-09.
- `date_format` (`string`, optional): Date format of the results: dt for datetime or ts for timestamp (default). Example: dt. One of: `dt`, `ts`.
- `dbt_filter` (`boolean`, optional): Set to true to apply the st/et time filter to every day instead of only trimming the start and end. Example: false.
- `et` (`string`, optional): End time of day in UTC, for example 21:00. Example: 21:00.
- `limit` (`integer`, optional): Limit of the results. Default is 100, maximum allowed limit is 5000. Please set a limit if you are using the API in the production. Example: 100.
- `sort` (`string`, optional): Sort by timestamp: asc (oldest first, the default) or desc. Example: asc. One of: `asc`, `desc`.
- `st` (`string`, optional): Start time of day in UTC, for example 14:30. Example: 14:30.

Example input: `{"from_date":"<from_date>","symbol":"<symbol>","time":"1min","to_date":"<to_date>"}`

### `finage_ca_stock_last_price_get`

Get Canadian Stock Last Price · Read-only

Get the latest price of a Toronto Stock Exchange share such as BMO. Returns price and timestamp.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): Canadian stock symbol, for example BMO. Example: BMO.

Example input: `{"symbol":"<symbol>"}`

### `finage_cash_flow_statements_get`

Get Cash Flow Statements · Read-only

Get a US company's cash flow statements, annual or quarterly. Returns statements with operating, investing and financing cash flows.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): US Stock symbol. Example: AAPL.
- `limit` (`integer`, optional): Number of statements to return. Example: 4.
- `period` (`string`, optional): Statement period: annual (default) or quarter. Example: quarter. One of: `annual`, `quarter`.

Example input: `{"symbol":"<symbol>"}`

### `finage_crypto_aggregates_get`

Get Crypto Aggregates · Read-only

Get OHLCV bars for a crypto pair over a date range at a chosen bar size. Returns open, high, low, close, volume and timestamp per bar.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `from_date` (`string`, required): Start date (YYYY-MM-DD). Example: 2026-01-05.
- `multiply` (`integer`, required): Number of time units per bar, for example 1 with time day for daily bars. Example: 1.
- `symbol` (`string`, required): Crypto pair, for example BTCUSD. Example: BTCUSD.
- `time` (`string`, required): Bar size unit. Example: day. One of: `minute`, `hour`, `day`, `week`, `month`, `quarter`, `year`.
- `to_date` (`string`, required): End date (YYYY-MM-DD). Example: 2026-01-09.
- `limit` (`integer`, optional): Limit of the results. Default is 100, maximum allowed limit is 50000. Please set a limit if you are using the API in the production. Example: 100.
- `sort` (`string`, optional): Sort by timestamp: asc (oldest first, the default) or desc. Example: asc. One of: `asc`, `desc`.

Example input: `{"from_date":"<from_date>","multiply":1,"symbol":"<symbol>","time":"minute","to_date":"<to_date>"}`

### `finage_crypto_convert`

Convert Cryptocurrency · Read-only

Convert an amount between two cryptocurrencies at the real-time rate. Returns the converted value. Use finage_forex_convert for fiat currencies.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `amount` (`number`, required): Amount to convert. Example: 100.
- `from_currency` (`string`, required): Crypto symbol to convert from, for example BTC. Example: BTC.
- `to_currency` (`string`, required): Crypto symbol to convert to, for example ETH. Example: ETH.

Example input: `{"amount":100,"from_currency":"<from_currency>","to_currency":"<to_currency>"}`

### `finage_crypto_detailed_price_get`

Get Crypto Detailed Price · Read-only

Get a detailed real-time snapshot of a crypto pair: price, 24-hour change, volume and market data. Returns the detailed price.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): Crypto pair, for example btcusd. Example: btcusd.

Example input: `{"symbol":"<symbol>"}`

### `finage_crypto_details_get`

Get Cryptocurrency Details · Read-only

Get details of a cryptocurrency by name or symbol: description, links, market cap and supply. Returns the coin profile.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `key` (`string`, required): Name or symbol of the cryptocurrency, for example bitcoin. Example: bitcoin.

Example input: `{"key":"<key>"}`

### `finage_crypto_last_quote_get`

Get Crypto Last Quote · Read-only

Get the latest bid and ask quote for a crypto pair. Returns ask, bid and timestamp.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): Crypto pair, for example BTCUSD. Example: BTCUSD.

Example input: `{"symbol":"<symbol>"}`

### `finage_crypto_last_trade_get`

Get Crypto Last Trade · Read-only

Get the latest traded price for a crypto pair such as BTCUSD. Returns price, size and timestamp.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): Crypto pair, for example BTCUSD. Example: BTCUSD.

Example input: `{"symbol":"<symbol>"}`

### `finage_crypto_market_cap_ranks_list`

List Crypto Market Cap Ranks · Read-only

List cryptocurrencies ranked by market cap with price, thumbnail and all-time high, a page at a time. Returns ranked coins.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `limit` (`integer`, optional): Number of results. Defaults to 10. Example: 100.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `sort` (`string`, optional): DESC for the most valuable first (default) or ASC. Example: DESC. One of: `DESC`, `ASC`.

Example input: `{}`

### `finage_crypto_news_list`

List Crypto News · Read-only

Get the latest news about a cryptocurrency. Returns headlines, sources, URLs and dates.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): Crypto symbol, for example BTC. Example: BTC.
- `limit` (`integer`, optional): Number of articles, up to 30. Defaults to 10. Example: 10.

Example input: `{"symbol":"<symbol>"}`

### `finage_crypto_previous_close_get`

Get Crypto Previous Close · Read-only

Get the previous day's OHLCV bar for a crypto pair. Returns open, high, low, close and volume.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): Crypto pair, for example BTCUSD. Example: BTCUSD.

Example input: `{"symbol":"<symbol>"}`

### `finage_crypto_search`

Search Cryptocurrencies · Read-only

Search cryptocurrencies by name or symbol. Returns matching coins with symbols and names.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `key` (`string`, required): Search text. Example: bitcoin.
- `limit` (`integer`, optional): Result limit. Example: 5.

Example input: `{"key":"<key>"}`

### `finage_crypto_snapshot_get`

Get Crypto Snapshot · Read-only

Get the latest quotes and/or trades for several crypto pairs in one call. Returns per-pair prices.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbols` (`string`, required): Comma-separated crypto pairs to return. Example: BTCUSD,ETHUSD.
- `quotes` (`boolean`, optional): Set to false to leave out last quotes. Defaults to true. Example: true.
- `trades` (`boolean`, optional): Set to true to include last trades. Defaults to false. Example: true.

Example input: `{"symbols":"<symbols>"}`

### `finage_dividend_calendar_list`

List Dividend Calendar · Read-only

List dividends in a date range. Returns symbols with ex-date, payment date and amount. Use finage_dividends_history_get for one company.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `from_date` (`string`, required): Start date (YYYY-MM-DD). Example: 2026-01-05.
- `to_date` (`string`, required): End date (YYYY-MM-DD). Example: 2026-01-09.

Example input: `{"from_date":"<from_date>","to_date":"<to_date>"}`

### `finage_dividends_history_get`

Get Dividend History · Read-only

Get the dividend history of one company, going back up to 30 years. Returns dividends with dates and amounts.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): Stock symbol name. Example: AAPL.

Example input: `{"symbol":"<symbol>"}`

### `finage_earnings_calendar_list`

List Earnings Calendar · Read-only

List upcoming company earnings releases. Returns symbols with dates, EPS and revenue estimates and actuals.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `finage_economic_calendar_list`

List Economic Calendar · Read-only

List past and upcoming economic events (central bank decisions, CPI, jobs reports) in a date range. Returns events with country, actual, forecast and previous values.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `from_date` (`string`, required): Start date (YYYY-MM-DD). Example: 2026-01-05.
- `to_date` (`string`, required): End date (YYYY-MM-DD). Example: 2026-01-09.

Example input: `{"from_date":"<from_date>","to_date":"<to_date>"}`

### `finage_etf_aggregates_get`

Get ETF Aggregates · Read-only

Get OHLC bars for an ETF over a date range at a chosen bar size. Returns bars with open, high, low, close and timestamp.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `from_date` (`string`, required): Start date (YYYY-MM-DD). Example: 2026-01-05.
- `symbol` (`string`, required): ETF symbol, for example QQQ. Example: QQQ.
- `time` (`string`, required): Bar size unit. Example: 1day. One of: `1min`, `5min`, `15min`, `30min`, `45min`, `1h`, `2h`, `4h`, `1day`, `1week`, `1month`.
- `to_date` (`string`, required): End date (YYYY-MM-DD). Example: 2026-01-09.
- `date_format` (`string`, optional): Date format of the results: dt for datetime or ts for timestamp (default). Example: dt. One of: `dt`, `ts`.
- `dbt_filter` (`boolean`, optional): Set to true to apply the st/et time filter to every day instead of only trimming the start and end. Example: false.
- `et` (`string`, optional): End time of day in UTC, for example 21:00. Example: 21:00.
- `limit` (`integer`, optional): Limit of the results. Default is 100, maximum allowed limit is 5000. Please set a limit if you are using the API in the production. Example: 100.
- `sort` (`string`, optional): Sort by timestamp: asc (oldest first, the default) or desc. Example: asc. One of: `asc`, `desc`.
- `st` (`string`, optional): Start time of day in UTC, for example 14:30. Example: 14:30.

Example input: `{"from_date":"<from_date>","symbol":"<symbol>","time":"1min","to_date":"<to_date>"}`

### `finage_etf_last_price_get`

Get ETF Last Price · Read-only

Get the latest price of an ETF such as QQQ or SPY. Returns price and timestamp.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): ETF symbol, for example QQQ. Example: QQQ.

Example input: `{"symbol":"<symbol>"}`

### `finage_etf_previous_close_get`

Get ETF Previous Close · Read-only

Get the previous day's OHLC bar for an ETF. Returns open, high, low and close.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): ETF symbol, for example QQQ. Example: QQQ.

Example input: `{"symbol":"<symbol>"}`

### `finage_financial_ratios_get`

Get Financial Ratios · Read-only

Get a company's financial ratios: profitability, liquidity, leverage and efficiency. Returns ratios by period.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): Symbol name (eg. AAPL, AMZN). Example: TSLA.

Example input: `{"symbol":"<symbol>"}`

### `finage_forex_aggregates_get`

Get Forex Aggregates · Read-only

Get OHLCV bars for a currency pair over a date range at a chosen bar size. Returns open, high, low, close and timestamp per bar.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `from_date` (`string`, required): Start date (YYYY-MM-DD). Example: 2026-01-05.
- `multiply` (`integer`, required): Number of time units per bar, for example 1 with time day for daily bars. Example: 1.
- `symbol` (`string`, required): Currency pair, for example GBPUSD. Example: GBPUSD.
- `time` (`string`, required): Bar size unit. Example: day. One of: `minute`, `hour`, `day`, `week`, `month`, `quarter`, `year`.
- `to_date` (`string`, required): End date (YYYY-MM-DD). Example: 2026-01-09.
- `date_format` (`string`, optional): Date format of the results: dt for datetime or ts for timestamp (default). Example: dt. One of: `dt`, `ts`.
- `dbt_filter` (`boolean`, optional): Set to true to apply the st/et time filter to every day instead of only trimming the start and end. Example: false.
- `et` (`string`, optional): End time of day in UTC, for example 21:00. Example: 21:00.
- `limit` (`integer`, optional): Limit of the results. Default is 100, maximum allowed limit is 50000. Please set a limit if you are using the API in the production. Example: 100.
- `sort` (`string`, optional): Sort by timestamp: asc (oldest first, the default) or desc. Example: asc. One of: `asc`, `desc`.
- `st` (`string`, optional): Start time of day in UTC, for example 14:30. Example: 14:30.

Example input: `{"from_date":"<from_date>","multiply":1,"symbol":"<symbol>","time":"minute","to_date":"<to_date>"}`

### `finage_forex_convert`

Convert Currency · Read-only

Convert an amount between two fiat currencies at the real-time rate. Returns the converted value and rate. Use finage_crypto_convert for cryptocurrencies.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `amount` (`number`, required): Amount to convert. Example: 100.
- `from_currency` (`string`, required): Currency code to convert from, for example GBP. Example: GBP.
- `to_currency` (`string`, required): Currency code to convert to, for example USD. Example: USD.

Example input: `{"amount":100,"from_currency":"<from_currency>","to_currency":"<to_currency>"}`

### `finage_forex_last_quote_get`

Get Forex Last Quote · Read-only

Get the latest bid and ask quote for a currency pair such as GBPUSD. Returns ask, bid and timestamp.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): Currency pair, for example GBPUSD. Example: GBPUSD.

Example input: `{"symbol":"<symbol>"}`

### `finage_forex_last_trade_get`

Get Forex Last Trade · Read-only

Get the latest traded price for a currency pair. Returns price and timestamp.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): Currency pair, for example GBPUSD. Example: GBPUSD.

Example input: `{"symbol":"<symbol>"}`

### `finage_forex_news_list`

List Forex News · Read-only

Get the latest news about a currency and the countries that use it. Returns headlines, sources, URLs and dates.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): Currency code, for example GBP. Example: GBP.
- `limit` (`integer`, optional): Number of articles, up to 30. Defaults to 10. Example: 10.

Example input: `{"symbol":"<symbol>"}`

### `finage_forex_previous_close_get`

Get Forex Previous Close · Read-only

Get the previous day's OHLC bar for a currency pair. Returns open, high, low and close.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): Currency pair, for example GBPUSD. Example: GBPUSD.

Example input: `{"symbol":"<symbol>"}`

### `finage_forex_signal_get`

Get Forex Trading Signal · Read-only

Get a buy, sell or neutral trading signal for a currency pair, derived from RSI, MACD, SMA and Bollinger Bands. Returns the signal with the indicator values.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `interval` (`string`, required): Time frame of the signal: daily or weekly. Example: daily. One of: `daily`, `weekly`.
- `symbol` (`string`, required): The market symbol for which the signal should be generated. Accepts currency pairs such as GBPUSD, EURUSD, USDJPY, etc. Example: GBPUSD.

Example input: `{"interval":"daily","symbol":"<symbol>"}`

### `finage_forex_snapshot_get`

Get Forex Snapshot · Read-only

Get the latest quotes and/or trades for several currency pairs in one call. Returns per-pair prices.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbols` (`string`, required): Comma-separated currency pairs to return. Example: EURUSD,GBPUSD.
- `quotes` (`boolean`, optional): Set to false to leave out last quotes. Defaults to true. Example: true.
- `trades` (`boolean`, optional): Set to true to include last trades. Defaults to false. Example: true.

Example input: `{"symbols":"<symbols>"}`

### `finage_income_statements_get`

Get Income Statements · Read-only

Get a US company's income statements, annual or quarterly. Returns statements with revenue, expenses, net income and EPS.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): US Stock symbol. Example: AAPL.
- `limit` (`integer`, optional): Number of statements to return. Example: 4.
- `period` (`string`, optional): Statement period: annual (default) or quarter. Example: quarter. One of: `annual`, `quarter`.

Example input: `{"symbol":"<symbol>"}`

### `finage_index_aggregates_get`

Get Index Aggregates · Read-only

Get OHLC bars for a CFD index over a date range at a chosen bar size. Returns bars with open, high, low, close and timestamp.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `from_date` (`string`, required): Start date (YYYY-MM-DD). Example: 2026-01-05.
- `symbol` (`string`, required): Index symbol, for example US500. Example: US500.
- `time` (`string`, required): Bar size unit. Example: 1day. One of: `1min`, `5min`, `15min`, `30min`, `45min`, `1h`, `2h`, `4h`, `1day`, `1week`, `1month`.
- `to_date` (`string`, required): End date (YYYY-MM-DD). Example: 2026-01-09.
- `date_format` (`string`, optional): Date format of the results: dt for datetime or ts for timestamp (default). Example: dt. One of: `dt`, `ts`.
- `dbt_filter` (`boolean`, optional): Set to true to apply the st/et time filter to every day instead of only trimming the start and end. Example: false.
- `et` (`string`, optional): End time of day in UTC, for example 21:00. Example: 21:00.
- `limit` (`integer`, optional): Limit of the results. Default is 100, maximum allowed limit is 5000. Please set a limit if you are using the API in the production. Example: 100.
- `sort` (`string`, optional): Sort by timestamp: asc (oldest first, the default) or desc. Example: asc. One of: `asc`, `desc`.
- `st` (`string`, optional): Start time of day in UTC, for example 14:30. Example: 14:30.

Example input: `{"from_date":"<from_date>","symbol":"<symbol>","time":"1min","to_date":"<to_date>"}`

### `finage_index_last_price_get`

Get Index Last Price · Read-only

Get the latest price of a CFD index such as US500 or US2000. Returns price and timestamp.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): Index symbol, for example US500. Example: US500.

Example input: `{"symbol":"<symbol>"}`

### `finage_index_previous_close_get`

Get Index Previous Close · Read-only

Get the previous day's OHLC bar for a CFD index. Returns open, high, low and close.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): Index symbol, for example US500. Example: US500.

Example input: `{"symbol":"<symbol>"}`

### `finage_institutional_holders_get`

Get Institutional Holders · Read-only

List the institutions that hold a stock with their share counts and changes. Returns holders.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): Symbol of the stock. Example: AAPL.

Example input: `{"symbol":"<symbol>"}`

### `finage_ipo_calendar_list`

List IPO Calendar · Read-only

List recent and upcoming IPOs in a date range. Returns companies with date, exchange, shares and price range.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `from_date` (`string`, required): Start date (YYYY-MM-DD). Example: 2026-01-05.
- `to_date` (`string`, required): End date (YYYY-MM-DD). Example: 2026-01-09.

Example input: `{"from_date":"<from_date>","to_date":"<to_date>"}`

### `finage_market_news_list`

List Stock News · Read-only

Get the latest news articles about a US stock. Returns headlines, sources, URLs and dates.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): Stock symbol name. Example: AAPL.
- `limit` (`integer`, optional): Number of articles, up to 30. Defaults to 10. Example: 10.

Example input: `{"symbol":"<symbol>"}`

### `finage_market_search`

Search US Stocks · Read-only

Search US stocks by company name or description. Returns matching symbols with names and exchanges. Use finage_symbols_list for a full symbol list.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `key` (`string`, required): Search text. Example: apple.
- `market` (`string`, required): Market to search; only us is supported. Example: us. One of: `us`.
- `limit` (`integer`, optional): Result limit. Example: 5.

Example input: `{"key":"<key>","market":"us"}`

### `finage_market_status_get`

Get Market Status · Read-only

Check whether the stock, forex and crypto markets are open, closed or in extended hours, optionally with holidays and trading hours. Returns market statuses.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `country` (`string`, optional): Country code of the market. Defaults to us. Example: us.
- `currencies` (`boolean`, optional): Set to false to hide the currencies section. Defaults to true. Example: true.
- `extended_hours` (`boolean`, optional): Set to true to include extended-hours status. Example: true.
- `holidays` (`boolean`, optional): Set to true to include the market's holidays. Example: true.
- `trading_hours` (`boolean`, optional): Set to true to include trading hours. Example: true.

Example input: `{}`

### `finage_most_active_stocks_list`

List Most Active US Stocks · Read-only

List the most actively traded US stocks today. Returns symbols with price, change and volume.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `finage_mutual_fund_holders_get`

Get Mutual Fund Holders · Read-only

List the mutual funds that hold a stock or ETF with their share counts. Returns holders.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): Symbol of the stock. Example: QQQ.

Example input: `{"symbol":"<symbol>"}`

### `finage_sector_performance_get`

Get Sector Performance · Read-only

Get today's percentage change of each US market sector. Returns sectors with their change.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `finage_shares_float_get`

Get Shares Float · Read-only

Get a stock's free float: shares outstanding and shares available to trade. Returns float figures.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): Symbol name (eg. AAPL, AMZN). Example: AMZN.

Example input: `{"symbol":"<symbol>"}`

### `finage_stock_aggregates_get`

Get US Stock Aggregates · Read-only

Get OHLCV bars for a US stock over a date range at a chosen bar size (for example 1 day or 5 minute). Returns open, high, low, close, volume and timestamp per bar. Use finage_stock_previous_close_get for just the last daily bar.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `from_date` (`string`, required): Start date (YYYY-MM-DD). Example: 2026-01-05.
- `multiply` (`integer`, required): Number of time units per bar, for example 1 with time day for daily bars. Example: 1.
- `symbol` (`string`, required): Symbol Name. Example: AAPL.
- `time` (`string`, required): Bar size unit. Example: day. One of: `minute`, `hour`, `day`, `week`, `month`, `quarter`, `year`.
- `to_date` (`string`, required): End date (YYYY-MM-DD). Example: 2026-01-09.
- `date_format` (`string`, optional): Date format of the results: dt for datetime or ts for timestamp (default). Example: dt. One of: `dt`, `ts`.
- `dbt_filter` (`boolean`, optional): Set to true to apply the st/et time filter to every day instead of only trimming the start and end. Example: false.
- `et` (`string`, optional): End time of day in UTC, for example 21:00. Example: 21:00.
- `limit` (`integer`, optional): Limit of the results. Default is 100, maximum allowed limit is 50000. Please set a limit if you are using the API in the production. Example: 100.
- `sort` (`string`, optional): Sort by timestamp: asc (oldest first, the default) or desc. Example: asc. One of: `asc`, `desc`.
- `st` (`string`, optional): Start time of day in UTC, for example 14:30. Example: 14:30.

Example input: `{"from_date":"<from_date>","multiply":1,"symbol":"<symbol>","time":"minute","to_date":"<to_date>"}`

### `finage_stock_details_get`

Get Stock Company Details · Read-only

Get a US company's profile: name, sector, industry, description, CEO, website and market cap. Returns the company details.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): Symbol of the stock. Example: AAPL.

Example input: `{"symbol":"<symbol>"}`

### `finage_stock_last_quote_get`

Get US Stock Last Quote · Read-only

Get the latest bid and ask quote for a US stock symbol. Returns ask, bid, sizes and timestamp. Use finage_stock_last_trade_get for the last traded price.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): Symbol Name (eg: AAPL). Example: AAPL.

Example input: `{"symbol":"<symbol>"}`

### `finage_stock_last_trade_get`

Get US Stock Last Trade · Read-only

Get the latest trade (price and size) for a US stock symbol. Returns price, size and timestamp. Use finage_stock_snapshot_get for many symbols at once.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): Symbol Name. Example: AAPL.

Example input: `{"symbol":"<symbol>"}`

### `finage_stock_previous_close_get`

Get US Stock Previous Close · Read-only

Get the previous trading day's OHLCV bar for a US stock. Returns open, high, low, close and volume.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): Symbol of the stock. Example: AAPL.

Example input: `{"symbol":"<symbol>"}`

### `finage_stock_snapshot_get`

Get US Stock Snapshot · Read-only

Get the latest quotes and/or trades for several US stocks in one call. Returns per-symbol price, bid, ask and sizes.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbols` (`string`, required): Comma-separated symbols to return. Example: AAPL,MSFT,TSLA.
- `quotes` (`boolean`, optional): Set to false to leave out last quotes. Defaults to true. Example: true.
- `trades` (`boolean`, optional): Set to true to include last trades. Defaults to false. Example: true.

Example input: `{"symbols":"<symbols>"}`

### `finage_stock_split_calendar_list`

List Stock Split Calendar · Read-only

List stock splits in a date range. Returns symbols with split date and ratio. Use finage_stock_splits_history_get for one company's history.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `from_date` (`string`, required): Start date (YYYY-MM-DD). Example: 2026-01-05.
- `to_date` (`string`, required): End date (YYYY-MM-DD). Example: 2026-01-09.

Example input: `{"from_date":"<from_date>","to_date":"<to_date>"}`

### `finage_stock_splits_history_get`

Get Stock Split History · Read-only

Get the history of stock splits for one company. Returns split dates and ratios.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): Stock symbol name. Example: AAPL.

Example input: `{"symbol":"<symbol>"}`

### `finage_symbols_list`

List Symbols · Read-only

List the symbols Finage supports in a market (US, Canadian, Indian or Russian stocks, forex, crypto or indices), optionally searched by symbol or name, a page at a time. Returns symbols with names.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `type` (`string`, required): Market type. Example: us-stock. One of: `us-stock`, `ca-stock`, `in-stock`, `ru-stock`, `forex`, `crypto`, `index`.
- `page` (`integer`, optional): Page number, starting at 1. Example: 1.
- `search` (`string`, optional): Search text matched against symbol or name. Example: Apple.

Example input: `{"type":"us-stock"}`

### `finage_technical_indicator_get`

Get Technical Indicator · Read-only

Calculate a technical indicator (SMA, EMA, DEMA, WMA, TEMA, RSI, Williams or ADX) for a stock at a chosen interval. Returns indicator values over time.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): Symbol of the stock. Example: AAPL.
- `time` (`string`, required): Time interval. Example: daily. One of: `daily`, `1min`, `5min`, `15min`, `30min`, `1hour`, `4hour`.
- `type` (`string`, required): Indicator type. Example: sma. One of: `sma`, `ema`, `dema`, `wma`, `tema`, `rsi`, `williams`, `adx`.
- `period` (`integer`, optional): Number of periods for the calculation. Defaults to 10. Example: 10.

Example input: `{"symbol":"<symbol>","time":"daily","type":"sma"}`

### `finage_top_gainers_list`

List Top US Gainers · Read-only

List the US stocks with the largest gains today. Returns symbols with price and change.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `finage_top_losers_list`

List Top US Losers · Read-only

List the US stocks with the largest losses today. Returns symbols with price and change.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs: none.

Example input: `{}`

### `finage_uk_stock_aggregates_get`

Get UK Stock Aggregates · Read-only

Get OHLC bars for a UK stock over a date range at a chosen bar size. Returns bars with open, high, low, close, volume and timestamp.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `from_date` (`string`, required): Start date (YYYY-MM-DD). Example: 2026-01-05.
- `symbol` (`string`, required): UK stock symbol, for example BP. Example: BP.
- `time` (`string`, required): Bar size unit. Example: 1day. One of: `1min`, `5min`, `15min`, `30min`, `45min`, `1h`, `2h`, `4h`, `1day`, `1week`, `1month`.
- `to_date` (`string`, required): End date (YYYY-MM-DD). Example: 2026-01-09.
- `date_format` (`string`, optional): Date format of the results: dt for datetime or ts for timestamp (default). Example: dt. One of: `dt`, `ts`.
- `dbt_filter` (`boolean`, optional): Set to true to apply the st/et time filter to every day instead of only trimming the start and end. Example: false.
- `et` (`string`, optional): End time of day in UTC, for example 21:00. Example: 21:00.
- `limit` (`integer`, optional): Limit of the results. Default is 100, maximum allowed limit is 5000. Please set a limit if you are using the API in the production. Example: 100.
- `sort` (`string`, optional): Sort by timestamp: asc (oldest first, the default) or desc. Example: asc. One of: `asc`, `desc`.
- `st` (`string`, optional): Start time of day in UTC, for example 14:30. Example: 14:30.

Example input: `{"from_date":"<from_date>","symbol":"<symbol>","time":"1min","to_date":"<to_date>"}`

### `finage_uk_stock_last_price_get`

Get UK Stock Last Price · Read-only

Get the latest price of a London Stock Exchange share such as BP. Returns price and timestamp.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `symbol` (`string`, required): UK stock symbol, for example BP. Example: BP.

Example input: `{"symbol":"<symbol>"}`

### `finage_us_stock_signal_get`

Get US Stock Trading Signal · Read-only

Get a buy, sell or neutral trading signal for a US stock, derived from RSI, MACD, SMA and Bollinger Bands. Returns the signal with the indicator values.

Read only: yes. Destructive: no. Idempotent (safe to retry): yes.

Inputs:

- `interval` (`string`, required): Time frame of the signal: daily or weekly. Example: daily. One of: `daily`, `weekly`.
- `symbol` (`string`, required): The market symbol for which the signal should be generated. Accepts us stocks symbols such as AAPL,TSLA,GOOGL, etc. Example: AAPL.

Example input: `{"interval":"daily","symbol":"<symbol>"}`

## Related

Other Accounting & Finance connectors ([all 82](/agentkit/connectors/?category=accounting-finance)):

- [QuickBooks](/agentkit/connectors/quickbooks/): Scalekit connector, OAuth, 117 tools
- [Xero](/agentkit/connectors/xero/): Scalekit connector, OAuth, 94 tools
- [Stripe](/agentkit/connectors/stripe/): Scalekit connector, Access token, 178 tools


---

## More Scalekit documentation

| Resource | What it contains | When to use it |
|----------|-----------------|----------------|
| [/llms.txt](/llms.txt) | Structured index with routing hints per product area | Start here — find which documentation set covers your topic before loading full content |
| [/llms-full.txt](/llms-full.txt) | Complete documentation for all Scalekit products in one file | Use when you need exhaustive context across multiple products or when the topic spans several areas |
| [sitemap-0.xml](https://docs.scalekit.com/sitemap-0.xml) | Full URL list of every documentation page | Use to discover specific page URLs you can fetch for targeted, page-level answers |
