---
title: "Twelve Data integration for LuumenAI"
url: "https://www.luumen.ai/integrations/twelve-data/"
entity: SoftwareIntegration
category: "Databases & data platforms"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Twelve Data integration for LuumenAI

Market data on demand: quotes, fundamentals, and currency conversion

## What LuumenAI can do with Twelve Data

LuumenAI connects to Twelve Data with an API token and exposes 100 tools (100 read-only). Every tool is read-only, so it can answer questions from Twelve Data but cannot change anything in it. Read actions still follow the configured access and approval policy.

## Key facts

- Authentication: API token
- Tools available: 100 tools (100 read-only)
- Deployment: scoped as part of your Pilot, Platform, or Managed rollout
- Category: Databases & data platforms

## About Twelve Data with LuumenAI

Connect Twelve Data with an API key and ask for market context in the terminal. Pull quotes for up to eight symbols at once with TWELVE_DATA_BATCH_GET_QUOTES, check payout history through TWELVE_DATA_DIVIDENDS, or convert an amount at a current or historical rate with TWELVE_DATA_CONVERT_CURRENCY. Every tool here is read-only, so answers come back right away.

## Example tools

Read-only (100 in total):

- `TWELVE_DATA_BATCH_GET_QUOTES` — Fetch quotes for 1-8 symbols in one batch, returning success or error for every symbol; partial child failures do not fail successful quotes.
- `TWELVE_DATA_CASH_FLOW` — Get company cash flow statement.
- `TWELVE_DATA_CASH_FLOW_CONSOLIDATED` — Get raw consolidated cash flow statements.
- `TWELVE_DATA_COMMODITIES_LIST` — Retrieve the complete list of supported commodities.
- `TWELVE_DATA_CONVERT_CURRENCY` — Convert an amount from the base to the quote currency using a current or historical forex or cryptocurrency rate.
- `TWELVE_DATA_CORREL` — Fetch Pearson correlation coefficient between two series over a period.
- `TWELVE_DATA_COUNTRIES_LIST` — Retrieve country metadata including ISO codes, names, capitals, and currencies.
- `TWELVE_DATA_CROSS_LISTINGS` — Retrieve cross-listed symbols for a security across multiple exchanges.

## Frequently asked questions

### How does LuumenAI connect to Twelve Data?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Twelve Data on its own?

No. Every one of the 100 tools is read-only, so LuumenAI can answer questions from Twelve Data but cannot change anything in it. Read actions still follow the configured access and approval policy.

### Is there an audit trail?

Every call to Twelve Data is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/twelve-data/