How do I install the Data Routing skill?

Run npx skillmds@latest add charliedream1/data-routing in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Data Routing safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Data Routing?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Data Routing free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Data Routing?

charliedream1 (@charliedream1) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Data Routing by charliedream1 — Agent Skill

Name: Data Routing
Author: charliedream1

File contents

Data Source Overview

Source	Markets	Auth Required	Network	Skill
tushare	A-shares, funds, futures, macro	Yes (`TUSHARE_TOKEN`)	China network	tushare
akshare	A-shares, US, HK, futures, macro, forex	No	Unrestricted	akshare
yfinance	US stocks, HK stocks, ETFs	No	Needs Yahoo Finance access	yfinance
okx	Crypto (OKX exchange)	No	Needs okx.com access	okx-market
ccxt	Crypto (100+ exchanges)	No	Needs exchange access	ccxt

Decision Tree

Backtest Scenario (writing config.json)

Use source: "auto" — the runner automatically routes by symbol pattern and falls back to alternative sources if the primary one is unavailable.

You do NOT need to specify a concrete data source in config.json unless the user explicitly asks for one.

Analysis / Research Scenario (writing Python scripts)

Identify the market type from the user's request
Pick the source by priority:

A-shares: tushare (if TUSHARE_TOKEN is set) > akshare (free fallback) US stocks: yfinance > akshare HK stocks: yfinance > akshare Crypto: okx (single exchange) > ccxt (multi-exchange) Futures: tushare > akshare Macro / economics: akshare > tushare Forex: akshare > yfinance

Load the corresponding skill for API details: load_skill("akshare")

Availability Check

tushare: check if TUSHARE_TOKEN environment variable exists
yfinance / okx / ccxt / akshare: free but may have network restrictions
If the user reports "connection timeout" or "cannot access", switch to the same-market fallback

Symbol Format Reference

Market	Format	Examples
A-shares	`NNNNNN.SZ/SH/BJ`	000001.SZ, 600000.SH
US stocks	`TICKER.US`	AAPL.US, MSFT.US
HK stocks	`NNN(N).HK`	700.HK, 9988.HK
Crypto	`SYMBOL-USDT`	BTC-USDT, ETH-USDT
Futures	`XXNNNN.EXCHANGE`	CU2406.SHFE
Forex	`XXX/YYY`	USD/CNY, EUR/USD

Fallback Chain (Runner Layer)

The backtest runner implements automatic fallback at the market level:

User requests 000001.SZ (A-share)
  -> detect market: a_share
  -> try tushare: TUSHARE_TOKEN missing -> skip
  -> try akshare: available -> use akshare
  -> success (zero config required)

This is transparent to the user — they just see results.

---name: data-routingdescription: Data source selection decision tree. Load this skill BEFORE any backtest or data-fetching task to choose the best available data source.---## Data Source Overview| Source | Markets | Auth Required | Network | Skill ||--------|---------|---------------|---------|-------|| tushare | A-shares, funds, futures, macro | Yes (`TUSHARE_TOKEN`) | China network | tushare || akshare | A-shares, US, HK, futures, macro, forex | No | Unrestricted | akshare || yfinance | US stocks, HK stocks, ETFs | No | Needs Yahoo Finance access | yfinance || okx | Crypto (OKX exchange) | No | Needs okx.com access | okx-market || ccxt | Crypto (100+ exchanges) | No | Needs exchange access | ccxt |## Decision Tree### Backtest Scenario (writing config.json)Use `source: "auto"` — the runner automatically routes by symbol pattern and falls back to alternative sources if the primary one is unavailable.You do NOT need to specify a concrete data source in config.json unless the user explicitly asks for one.### Analysis / Research Scenario (writing Python scripts)1. Identify the market type from the user's request2. Pick the source by priority:**A-shares**: tushare (if TUSHARE_TOKEN is set) > akshare (free fallback)**US stocks**: yfinance > akshare**HK stocks**: yfinance > akshare**Crypto**: okx (single exchange) > ccxt (multi-exchange)**Futures**: tushare > akshare**Macro / economics**: akshare > tushare**Forex**: akshare > yfinance3. Load the corresponding skill for API details: `load_skill("akshare")`### Availability Check- **tushare**: check if `TUSHARE_TOKEN` environment variable exists- **yfinance / okx / ccxt / akshare**: free but may have network restrictions- If the user reports "connection timeout" or "cannot access", switch to the same-market fallback## Symbol Format Reference| Market | Format | Examples ||--------|--------|---------|| A-shares | `NNNNNN.SZ/SH/BJ` | 000001.SZ, 600000.SH || US stocks | `TICKER.US` | AAPL.US, MSFT.US || HK stocks | `NNN(N).HK` | 700.HK, 9988.HK || Crypto | `SYMBOL-USDT` | BTC-USDT, ETH-USDT || Futures | `XXNNNN.EXCHANGE` | CU2406.SHFE || Forex | `XXX/YYY` | USD/CNY, EUR/USD |## Fallback Chain (Runner Layer)The backtest runner implements automatic fallback at the market level:```User requests 000001.SZ (A-share) -> detect market: a_share -> try tushare: TUSHARE_TOKEN missing -> skip -> try akshare: available -> use akshare -> success (zero config required)```This is transparent to the user — they just see results.

Frequently asked questions

Data Routing