Agent skill

Binance Datatool

by lostleaf in lostleaf/binance-datatool

Manage Binance historical market data from data.binance.vision using the binance-datatool CLI.

BSD-3-ClauseAuto-check: notesBackend & APIs

Install Binance Datatool

skills CLI
$ npx skills add lostleaf/binance-datatool --skill binance-datatool -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install lostleaf/binance-datatool binance-datatool --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/lostleaf/binance-datatool.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/binance-datatool .claude/skills/binance-datatool && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
binance-datatool
GitHub stars
148
Token cost
~2.5k tokens
SKILL.md length
750 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
BSD-3-Clause

At a glance

Manage Binance historical market data from data.binance.vision using the binance-datatool CLI.

  • Works in 3 steps: binance-datatool installed — pip install… → Archive home configured — set… → aria2 installed — required by the…
  • The user mentions Binance historical data
  • SKILL.md covers Verbosity, Prerequisites, Core Concepts and Commands, plus 2 more sections
  • Calls pip, pipx and brew

What it does

Binance Datatool is an agent skill from lostleaf/binance-datatool. Manage Binance historical market data from data.binance.vision using the binance-datatool CLI. List available symbols, browse remote archive files, download klines/trades/funding rates with aria2, and verify SHA256 checksums. Use this skill whenever the user mentions Binance historical data, klines, candlestick data, trade data, funding rates, data.binance.vision, or asks to download, list, or verify Binance market data — even if they don't mention binance-datatool by name. Also use when the user asks about…

Its SKILL.md is about 2.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering Stock and market analysis, Realtime and WebSockets and REST APIs. It works with Binance. The repository describes itself as: A non-official Python toolkit for managing historical market data from data.binance.vision. The licence is BSD-3-Clause.

When your agent uses it

  • The user mentions Binance historical data
  • Candlestick data
  • Data.binance.vision
  • Asks to download

Example prompts

  • “/binance-datatool”

Requirements

  • Python 3

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. binance-datatool installed — pip install binance-datatool or pipx install binance-datatool
  2. Archive home configured — set BINANCE_DATATOOL_ARCHIVE_HOME to a directory for local data
  3. aria2 installed — required by the download command for parallel, resumable downloads.

What it can do on your machine

Read from SKILL.md and the folder at commit 79975f5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • pip
    • pipx
    • brew
    • apt

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pip and pipx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Binance Datatool loads about 2.5k tokens when it runs. Until then it costs about 192 tokens; SKILL.md has 750 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~192
When it runs · the whole SKILL.md, loaded when a task matches
~2.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteRuns commands with sudoSKILL.md:40
    - Ubuntu/Debian: `sudo apt install aria2`

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from lostleaf/binance-datatool at commit 79975f5, republished under its BSD-3-Clause licence (© lostleaf). 750 words, ~2,539 tokens.

Download SKILL.mdSave it as .claude/skills/binance-datatool/SKILL.md (or your agent's skills folder).
name
binance-datatool
description
Manage Binance historical market data from data.binance.vision using the binance-datatool CLI. List available symbols, browse remote archive files, download klines/trades/funding rates with aria2, and verify SHA256 checksums. Use this skill whenever the user mentions Binance historical data, klines, candlestick data, trade data, funding rates, data.binance.vision, or asks to download, list, or verify Binance market data — even if they don't mention binance-datatool by name. Also use when the user asks about available Binance symbols or wants to build a local crypto data archive from Binance. Do NOT use this skill for Binance REST API, WebSocket, or real-time market data — it only covers historical archive downloads from data.binance.vision.

binance-datatool

A CLI for downloading and managing Binance historical market data from data.binance.vision.

Verbosity

By default, the CLI runs at WARNING level and produces almost no log output. For agent use, always pass -v so loguru prints INFO-level progress to stderr. This gives you visibility into what the tool is doing (listing symbols, downloading files, verifying checksums). Use -vv for DEBUG-level output when troubleshooting.

All log output goes to stderr. Command results (symbol lists, file paths, dry-run diffs) go to stdout. This separation means piping stdout is always safe.

Prerequisites

Before running any command, ensure three things are in place:

  1. binance-datatool installed — pip install binance-datatool or pipx install binance-datatool
  2. Archive home configured — set BINANCE_DATATOOL_ARCHIVE_HOME to a directory for local data storage. Required by download and verify. Can also be passed per-command via --archive-home.
    bash
    export BINANCE_DATATOOL_ARCHIVE_HOME="$HOME/crypto_data/binance_archive"
  3. aria2 installed — required by the download command for parallel, resumable downloads.
    • macOS: brew install aria2
    • Ubuntu/Debian: sudo apt install aria2

Core Concepts

Trade Types
ValueMarket segment
spotSpot trading market
umUSD-M perpetual and delivery futures
cmCOIN-M perpetual and delivery futures
Data Frequencies
ValueMeaning
dailyFiles partitioned by day
monthlyFiles partitioned by month
Data Types
CLI valueDescriptionNeeds --interval?
klinesCandlestick (OHLCV) dataYes
aggTradesAggregated tradesNo
tradesIndividual tradesNo
fundingRateFutures funding ratesNo
bookDepthOrder book depthNo
bookTickerBest bid/ask updatesNo
indexPriceKlinesIndex price klinesYes
markPriceKlinesMark price klinesYes
premiumIndexKlinesPremium index klinesYes
metricsFutures metricsNo
liquidationSnapshotLiquidation snapshotsNo
Kline Intervals

1m 3m 5m 15m 30m 1h 2h 4h 6h 8h 12h 1d 3d 1w 1mo

Only required for data types marked "Yes" in the table above.

Contract Types (futures only)
ValueMeaning
perpetualNo expiry; open until closed
deliveryExpires on a fixed settlement date

Commands

All commands accept the global options -v (verbosity) and --archive-home PATH.

list-symbols

List available symbols from the remote archive.

binance-datatool -v list-symbols <TRADE_TYPE> [OPTIONS]
OptionDescription
--freqPartition frequency (default: daily)
--typeDataset type (default: klines)
--quote ASSETFilter by quote asset (repeatable)
--exclude-leverageExclude leveraged tokens (spot only)
--exclude-stablesExclude stablecoin pairs
--contract-typeFilter futures by contract type

Output: one symbol per line to stdout.

list-files

List archive files for given symbols. Reads symbols from stdin if none given as arguments.

binance-datatool -v list-files <TRADE_TYPE> [SYMBOLS...] [OPTIONS]
OptionDescription
--freqPartition frequency (default: daily)
--typeDataset type (default: klines)
--intervalInterval for kline-class data types
-l / --longThree-column TSV output: size, timestamp, path
--only-zipPrint only .zip files
--only-checksumPrint only .CHECKSUM files
--progress-barShow progress bar on stderr

Output: one path per line, or TSV with -l.

Show full SKILL.md (323 more words)Show less
download

Download archive files into the local archive directory using aria2.

binance-datatool -v download <TRADE_TYPE> [SYMBOLS...] [OPTIONS]
OptionDescription
--freqPartition frequency (default: daily)
--typeDataset type (default: klines)
--intervalInterval for kline-class data types
-n / --dry-runPreview what would be downloaded without writing files
--aria2-proxyLet aria2c inherit proxy env vars
--progress-barShow progress bar on stderr

Dry-run output: TSV lines <reason>\t<size>\t<path> where reason is new or updated. Real-run output: download stats on stderr (downloaded/failed/skipped counts).

Exit codes: 0 = success, 2 = partial failure.

verify

Verify local zip files against SHA256 checksums.

binance-datatool -v verify <TRADE_TYPE> [SYMBOLS...] [OPTIONS]
OptionDescription
--freqPartition frequency (default: daily)
--typeDataset type (default: klines)
--intervalInterval for kline-class data types
--keep-failedKeep failed files instead of deleting them
-n / --dry-runScan without verifying
--progress-barShow progress bar on stderr

Exit codes: 0 = all passed, 2 = verification failures.

Workflow Templates

Download Spot USDT 1m Klines

A three-step pipeline: list symbols, download, verify.

bash
# Step 1: List USDT spot symbols (exclude stablecoins and leveraged tokens)
binance-datatool -v list-symbols spot \
  --quote USDT --exclude-stables --exclude-leverage > symbols.txt

# Step 2: Download daily 1m klines
binance-datatool -v download spot \
  --freq daily --type klines --interval 1m < symbols.txt

# Step 3: Verify downloaded files
binance-datatool -v verify spot \
  --freq daily --type klines --interval 1m < symbols.txt
Download USD-M Perpetual 1m Klines
bash
binance-datatool -v list-symbols um \
  --quote USDT --exclude-stables --contract-type perpetual > symbols.txt

binance-datatool -v download um \
  --freq daily --type klines --interval 1m < symbols.txt

binance-datatool -v verify um \
  --freq daily --type klines --interval 1m < symbols.txt
Download USD-M Funding Rates

Note: funding rates use monthly frequency and no interval.

bash
binance-datatool -v list-symbols um \
  --freq monthly --type fundingRate \
  --quote USDT --exclude-stables --contract-type perpetual > symbols.txt

binance-datatool -v download um \
  --freq monthly --type fundingRate < symbols.txt

binance-datatool -v verify um \
  --freq monthly --type fundingRate < symbols.txt

Best Practices

  • Always use -v so you can see INFO-level progress on stderr. Without it the tool is nearly silent under normal operation.
  • Dry-run before downloading. Run download --dry-run first to preview what will be fetched, especially for broad queries like all USDT symbols.
  • Reuse symbol lists. Save list-symbols output to a file and pipe it into both download and verify to keep the symbol set consistent across steps.
  • Check exit codes. Exit code 2 means partial failure — some symbols succeeded while others failed. Review stderr for details.
  • Frequency matters. Some data types are only available at specific frequencies. For example, futures fundingRate typically requires --freq monthly. If list-files returns nothing, try switching the frequency.
  • stdin composition. When no positional SYMBOLS arguments are given, commands read symbols from stdin. This enables list-symbols | download pipelines or file-based workflows.
  • --type values are camelCase. Use the exact values from the Data Types table above (e.g. fundingRate, aggTrades, bookDepth), not snake_case variants like funding_rate.

© lostleaf, BSD-3-Clause. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/binance-datatool of lostleaf/binance-datatool.

Open the folder on GitHubat commit 79975f5

Compare with similar skills

Binance Datatool next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Binance Datatool compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Binance Datatool this skilllostleaf/binance-datatool148—~2.5kAutomated safety check: NotesBSD-3-Clause
Polymarket2025Emma/vibe-coding-cn23k1 repos~1.6kAutomated safety check: PassMIT
Trust Wallet APItrustwallet/tw-agent-skills104—~424Automated safety check: PassMIT
Binance Wallet Trackerbinance/binance-skills-hub1.1k—~5.3kAutomated safety check: PassNone
Crypto ExecutorLeoYeAI/openclaw-master-skills2.2k—~4kAutomated safety check: PassMIT
Web3 PolymarketPolymarket/agent-skills1912 repos~2kAutomated safety check: PassNone

Similar skills

  • Polymarket

    2025Emma/vibe-coding-cn

    Comprehensive Polymarket skill covering prediction markets, API, trading, market data, and real-time WebSocket data streaming.

    23k GitHub starsUsed in 1 repo~1.6k tokens
    Backend & APIsAuto-check passed
  • Trust Wallet API

    trustwallet/tw-agent-skills

    Trust Wallet API for crypto data — token search, prices, trending tokens, swap quotes, market data, security checks, address validation, asset info, and coin status across 100+ blockchains.

    104 GitHub stars~424 tokensUpdated 3 mo ago
    Backend & APIsAuto-check passed
  • Binance Wallet Tracker

    binance/binance-skills-hub

    Wallet tracking and monitoring on Binance Web3. An agent skill from binance/binance-skills-hub.

    1.1k GitHub stars~5.3k tokensUpdated 26 days ago
    Backend & APIsAuto-check passed
  • Crypto Executor

    LeoYeAI/openclaw-master-skills

    Complete autonomous trading engine for Binance with WebSocket real-time, OCO orders, Kelly Criterion position sizing, trailing stops, circuit breakers, daily performance reports, AND NOW adaptive…

    2.2k GitHub stars~4k tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed
  • Web3 Polymarket

    Polymarket/agent-skills

    Polymarket integration for prediction market trading on Polygon.

    191 GitHub starsUsed in 2 repos~2k tokens
    Backend & APIsAuto-check passed
  • Cryptofeed

    2025Emma/vibe-coding-cn

    Cryptofeed - Real-time cryptocurrency market data feeds from 40+ exchanges.

    23k GitHub starsUsed in 1 repo~1.6k tokens
    Backend & APIsAuto-check passed

Works with

Questions about Binance Datatool

What does Binance Datatool do?

Manage Binance historical market data from data.binance.vision using the binance-datatool CLI. Binance Datatool is an agent skill from lostleaf/binance-datatool.vision using the binance-datatool CLI.

When should I use Binance Datatool?

Binance Datatool fits situations like: the user mentions Binance historical data; candlestick data; data.binance.vision; asks to download.

How do I install Binance Datatool in Claude Code?

Run `npx skills add lostleaf/binance-datatool --skill binance-datatool -a claude-code`. Or copy the skill folder (skills/binance-datatool in lostleaf/binance-datatool) into .claude/skills/binance-datatool in your project. Claude Code loads it when a task matches its description.

How do I install Binance Datatool in Codex?

Run `npx skills add lostleaf/binance-datatool --skill binance-datatool -a codex`. Or copy the skill folder (skills/binance-datatool in lostleaf/binance-datatool) into .agents/skills/binance-datatool in your project. Codex loads it when a task matches its description.

Can I use Binance Datatool in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add lostleaf/binance-datatool --skill binance-datatool -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/binance-datatool, .gemini/skills/binance-datatool, .github/skills/binance-datatool and .opencode/skills/binance-datatool in your project.

What does Binance Datatool need to run?

Going by SKILL.md and its folder, Binance Datatool needs the command-line tools its instructions call (pip, pipx, brew and apt). Our summary lists: Python 3.

Does Binance Datatool access the network?

SKILL.md contains no URLs. Its commands use pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Binance Datatool safe to install?

Our automated static check of SKILL.md found notes only (runs commands with sudo), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Binance Datatool use?

Binance Datatool is published under the BSD-3-Clause licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Binance Datatool use?

About 2.5k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Binance Datatool?

Skills that share tags, products or a category with Binance Datatool: Polymarket (2025Emma/vibe-coding-cn, 23k stars), Trust Wallet API (trustwallet/tw-agent-skills, 104 stars), Binance Wallet Tracker (binance/binance-skills-hub, 1.1k stars) and Crypto Executor (LeoYeAI/openclaw-master-skills, 2.2k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Binance Datatool?

lostleaf (a GitHub user) maintains it in lostleaf/binance-datatool, which has 148 GitHub stars. The repository was last updated on May 6, 2026.

Source: lostleaf/binance-datatool on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.