Twelve Data Forex Pairs Scraper

Twelve Data Forex Pairs Scraper

Scrape forex pairs from Twelve Data by country, up to a million per run. Every pair comes with its symbol, base and quote currency, and currency group. No login or API key required for the demo endpoint. Export to CSV, JSON, Excel, or XML.

Twelve Data's official API needs a paid plan for full access and rate-limits you. This reads the public forex pairs endpoint directly, filtered by country code, and returns each match in one fixed schema. You get the complete list of available forex pairs without writing a single API call.

Who uses it	What they scrape Twelve Data for
Forex traders	Build a watchlist of all available pairs for a specific country
Quantitative analysts	Seed a backtesting database with the universe of tradeable forex symbols
Fintech developers	Populate a currency pair picker inside a trading application
Data journalists	Audit which minor and exotic pairs a data provider covers

What it does

This Actor collects forex pairs from the Twelve Data API by country and returns each one as a flat row with symbol, currency group, base currency, and quote currency.

• 🌍 Country filter: pull only pairs relevant to a single market, or leave empty for the global list.
• 📊 Structured output: every row is a flat object with symbol, currency_group, currency_base, and currency_quote.
• ⚡ Direct API read: no browser, no headless rendering, a fast HTTP call to the verified endpoint.

Results export to CSV, JSON, Excel, or XML, or straight from the API.

What you can do with Twelve Data data

🇺🇸 Build a US forex watchlist.

A retail trader sets the country filter to US and exports all USD-cross pairs into a trading journal.

📈 Seed a backtesting universe.

A quant researcher pulls the full global list of pairs and cross-references it with historical price data to find new trading opportunities.

💱 Populate a currency picker.

A fintech startup uses the Actor to load every available pair into their app's dropdown so users can select any supported market.

🔍 Audit exotic pair coverage.

A data journalist scrapes all pairs and compares the list against other providers to see which exotic currencies are tracked.

Why choose this scraper

	What you get
No API coding	The Actor handles the HTTP request and pagination for you
Clean schema	Every pair arrives with the same four fields, ready for a database or spreadsheet
Free tier ready	Works with the demo API key so you can test without a Twelve Data account
Bulk export	Save results as CSV, JSON, Excel, or XML in one click

What a Twelve Data record looks like

Every record returns as one flat JSON row. Here is a real one from a run:

{
 "symbol": "AED/ARS",
 "currency_group": "Exotic-Cross",
 "currency_base": "UAE Dirham",
 "currency_quote": "Argentinian Peso"
}

Every value above comes from a real run. A field a record does not have comes back as null.

Configure the run

Drive the Actor with a country code and a max items limit, and the filter runs before data reaches your dataset so you only pay for the rows you keep. The Input tab lists every parameter.

A first run with the defaults:

{
 "maxItems": 10,
 "country": "US"
}

A larger pull:

{
 "maxItems": 200,
 "country": "US"
}

Free users

Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.

Run it

1. Create a free Apify account with $5 in credit.
2. Open the Twelve Data Forex Pairs Scraper.
3. Set your inputs and any filters, then click Start.
4. Export the results as CSV, Excel, JSON, or XML from the Dataset tab.

Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.

Use with AI agents (MCP)

Give an AI agent live access to Twelve Data through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:

$claude mcp add --transport http apify "https://mcp.apify.com?tools=acquistion-automation/twelve-data-forex-pairs-scraper"

Then prompt it in plain language to run the scraper and read back the results.

Troubleshooting

Why am I getting no results?

Check your country code. It must be a valid ISO 3166-1 alpha-2 code like US or GB. If the code is valid but still returns nothing, that country may not have any forex pairs listed by Twelve Data. Try leaving the country field empty to see the full list.

Why did my run fail with an HTTP error?

The Twelve Data demo endpoint may be temporarily unavailable or rate-limited. Wait a few minutes and retry. If the error persists, check the Apify platform status and Twelve Data's service status page.

I only got 10 items but I am a paid Apify user.

The maxItems input field defaults to 10. Increase it to a higher number, up to 1,000,000, and rerun the Actor.

The output is missing a field I expected.

This Actor returns only the fields provided by the Twelve Data forex pairs endpoint: symbol, currency_group, currency_base, and currency_quote. If you need additional fields like exchange name or timezone, you will need a different Twelve Data API endpoint.

FAQ

Question	Answer
Do I need a Twelve Data API key?	No. The Actor uses the public demo endpoint, which returns data without authentication. You can upgrade to a paid Twelve Data plan later if you need higher rate limits, but the Actor itself does not require a key.
What countries can I filter by?	You can pass any ISO 3166-1 alpha-2 country code, such as US, GB, JP, or CH. Leave the country field empty to receive all available forex pairs across every country.
How many pairs can I get in one run?	Free Apify users are limited to 10 items. Paid Apify users can set maxItems up to 1,000,000, which is more than the total number of pairs Twelve Data publishes.
What fields does each row contain?	Every row includes the symbol, currency_group, currency_base, and currency_quote. The exact field list is shown in the sample output on the Actor's page.
Can I get historical forex data with this Actor?	No. This Actor only returns the current list of available forex pairs. For historical price data you would need a different Twelve Data endpoint or a dedicated historical data scraper.
Does this Actor respect rate limits?	Yes. The Actor makes a single API call per run and respects the server's response headers. If you run it too frequently you may hit Twelve Data's demo rate limit, but the Actor will surface the error clearly.
Can I schedule this Actor to run daily?	Yes. You can set up an Apify schedule to run the Actor every day and receive the latest forex pair list automatically.
What output formats are supported?	You can export your dataset as CSV, JSON, Excel, or XML directly from the Apify console.

Related actors

Browse the full Acquisition Automation collection for more scrapers.

🆘 Need help? Open an issue in the Issues tab of this Actor with your run ID, your input, and what you expected.

Pricing

This Actor uses pay-per-result pricing: $0.004 per result collected. You are billed only for the results you receive, so a run that returns nothing costs nothing.

⚠️ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Twelve Data Pte. Ltd. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.