# twelvedata

Fetch stock, forex, and commodity market data through Twelve Data. Built for traditional finance assets, not crypto.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 7700 installs · ★ 29
- Author: Starchild-ai-agent
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Starchild-ai-agent/official-skills/tree/HEAD/twelvedata/SKILL.md
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/skills/twelvedata

## What it does

This skill delivers a single `exports.py` Python script that agents execute via bash commands. It queries real-time quotes, end-of-day values, exchange directories, and OHLCV time series with intervals ranging from 1min to 1month. Support for pre-market and post-market pricing is included for US equities.

Running queries requires the `TWELVEDATA_API_KEY` environment variable. The tool strictly targets traditional markets such as equities, foreign exchange, and commodities like gold or crude oil. Cryptocurrency lookups are unsupported. Quotes provide closing prices rather than bid/ask spreads, while batch functions can fetch up to 120 tickers in a single API call.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill twelvedata -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/twelvedata/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/twelvedata/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill twelvedata -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/twelvedata/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill twelvedata -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/twelvedata/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Starchild-ai-agent/official-skills twelvedata
```

2. **Manually: put the files in place**
- File: `.github/skills/twelvedata/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill twelvedata -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Starchild-ai-agent/official-skills --path twelvedata
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/twelvedata/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Starchild-ai-agent/official-skills --skill twelvedata -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Starchild-ai-agent/official-skills/tree/HEAD/twelvedata/SKILL.md

## When to use it
- retrieve live stock quotes with trading volume and 52-week ranges
- pull OHLCV candlestick time series across minute, hour, or daily intervals
- compare up to 120 market tickers in a single batch request
- track exchange rates and commodity spot prices like gold or crude oil

## Example prompts
- Get the latest quote and volume for AAPL
- Compare prices for AAPL, MSFT, and GOOGL in one batch
- Fetch the last 30 daily candles for EUR/USD

## Similar
- [stock-correlation](https://affpapa.org/en/nevibecode/skills/stock-correlation.md) — skill · 3400 installs
- [alphaear-deepear-lite](https://affpapa.org/en/nevibecode/skills/alphaear-deepear-lite.md) — skill · 334 installs
- [longbridge-market-data](https://affpapa.org/en/nevibecode/skills/longbridge-market-data.md) — skill · 3300 installs
- [market-data](https://affpapa.org/en/nevibecode/skills/rebyteai-template-market-data.md) — skill · 380 installs
- [longbridge](https://affpapa.org/en/nevibecode/skills/longbridge.md) — skill · 4300 installs
- [stock-quote](https://affpapa.org/en/nevibecode/skills/stock-quote.md) — skill · 691 installs

From the same set: [starchild-ai-agent/official-skills](https://affpapa.org/en/nevibecode/by/starchild-ai-agent/official-skills.md) — 30 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md