Agent skill

Crypto Price Data Guide

by nirholas in nirholas/three.ws

How cryptocurrency prices work — the complete data pipeline from CEX order books and DEX pools through oracle networks to aggregators.

MITAuto-check passedData & Analytics

Install Crypto Price Data Guide

skills CLI
$ npx skills add nirholas/three.ws --skill crypto-price-data-guide -a claude-code

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

GitHub CLI
$ gh skill install nirholas/three.ws crypto-price-data-guide --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/nirholas/three.ws.git skills-src && mkdir -p .claude/skills && cp -r skills-src/data/skills/analysis/crypto-price-data-guide .claude/skills/crypto-price-data-guide && 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
crypto-price-data-guide
GitHub stars
226
Token cost
~2.7k tokens
SKILL.md length
737 words
Files
1
Skills in repo
165
Repo updated
First seen
Licence
MIT

At a glance

How cryptocurrency prices work — the complete data pipeline from CEX order books and DEX pools through oracle networks to aggregators.

  • Works in 3 steps: Direct RPC — Call pool contracts to read… → The Graph — Query indexed swap events… → DexScreener API — Aggregated DEX data…
  • Explaining price sources
  • SKILL.md covers The Price Data Pipeline, Layer 1: Primary Price Sources, Layer 2: Oracle Networks and Layer 3: Free Aggregator APIs, plus 4 more sections
  • Reaches api.binance.com and api.dexscreener.com

What it does

Crypto Price Data Guide is an agent skill from nirholas/three.ws. How cryptocurrency prices work — the complete data pipeline from CEX order books and DEX pools through oracle networks to aggregators. Covers free API alternatives to CoinGecko, VWAP/TWAP calculations, and building price feeds without paid APIs. Use when explaining price sources, building market data features, or comparing data providers.

Its SKILL.md is about 2.7k 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 Data & Analytics, covering Crypto and DeFi analysis, Data pipelines and ETL and Stock and market analysis. It works with Binance, Arbitrum and Uniswap. The repository describes itself as: Open-source platform for 3D AI agents. Turn text or a photo into a rigged, animated GLB avatar, give it an LLM brain, memory and a wallet, and embed it anywhere with one web… The licence is MIT.

When your agent uses it

  • Explaining price sources
  • Building market data features
  • Comparing data providers

Example prompts

  • “/crypto-price-data-guide”

Workflow steps

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

  1. Direct RPC — Call pool contracts to read reserves/sqrtPrice
  2. The Graph — Query indexed swap events via GraphQL
  3. DexScreener API — Aggregated DEX data across 80+ chains

What it can do on your machine

Read from SKILL.md and the folder at commit 238ef60. 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

    No scripts in the folder and no shell commands in SKILL.md.

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.binance.com
    • api.dexscreener.com
    • hermes.pyth.network
    • coins.llama.fi
    • api.coincap.io
    • api.coinpaprika.com
    • min-api.cryptocompare.com

    Also links to:

    • defillama.com
    • binance-docs.github.io
    • data.chain.link
    • docs.dexscreener.com
    • docs.coincap.io
    • pyth.network

    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

Crypto Price Data Guide loads about 2.7k tokens when it runs. Until then it costs about 91 tokens; SKILL.md has 737 words of instructions outside code blocks.

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

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 passed

The automated check found no risky patterns in SKILL.md.

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 nirholas/three.ws at commit 238ef60, republished under its MIT licence (© nirholas). 737 words, ~2,681 tokens.

Download SKILL.mdSave it as .claude/skills/crypto-price-data-guide/SKILL.md (or your agent's skills folder).
name
crypto-price-data-guide
description
How cryptocurrency prices work — the complete data pipeline from CEX order books and DEX pools through oracle networks to aggregators. Covers free API alternatives to CoinGecko, VWAP/TWAP calculations, and building price feeds without paid APIs. Use when explaining price sources, building market data features, or comparing data providers.
license
MIT
metadata.category
analysis
metadata.difficulty
intermediate
metadata.author
clawhub
metadata.tags
analysis, crypto-price-data-guide

Crypto Price Data Guide

Where do crypto prices actually come from? This guide breaks down the entire data pipeline — from raw exchange data to the numbers you see in apps.

The Price Data Pipeline

┌──────────────────────────────────────────────────────────┐
│  LAYER 1: Primary Sources (where prices originate)       │
│                                                          │
│  CEX Order Books          DEX AMM Pools                  │
│  ┌──────────────┐        ┌──────────────┐                │
│  │ Binance      │        │ Uniswap V3   │                │
│  │ Coinbase     │        │ Curve        │                │
│  │ Kraken       │        │ Camelot      │                │
│  │ OKX, Bybit   │        │ Balancer     │                │
│  └──────┬───────┘        └──────┬───────┘                │
│         │                       │                        │
├─────────┼───────────────────────┼────────────────────────┤
│  LAYER 2: Oracle Networks (aggregate + post on-chain)    │
│         │                       │                        │
│         ▼                       ▼                        │
│  ┌──────────────────────────────────────┐                │
│  │ Chainlink     Pyth     Redstone      │                │
│  │ (median of multiple data sources)    │                │
│  └──────────────────┬───────────────────┘                │
│                     │                                    │
├─────────────────────┼────────────────────────────────────┤
│  LAYER 3: Aggregators (combine everything)               │
│                     ▼                                    │
│  ┌──────────────────────────────────────┐                │
│  │ CoinGecko  DeFi Llama  CoinMarketCap │                │
│  │ DexScreener  CoinCap   CoinPaprika   │                │
│  └──────────────────┬───────────────────┘                │
│                     │                                    │
├─────────────────────┼────────────────────────────────────┤
│  LAYER 4: Consumer Apps                                  │
│                     ▼                                    │
│  Portfolio trackers, trading bots, DeFi protocols,       │
│  AI agents (like SperaxOS), wallets                      │
└──────────────────────────────────────────────────────────┘

Layer 1: Primary Price Sources

Centralized Exchange (CEX) APIs

CEXes are the dominant price source for high-cap tokens. Their order books determine the "true" price through supply/demand matching.

ExchangePublic APIRate LimitWebSocket
Binanceapi.binance.com/api/v3/1200 req/min✅ Real-time
Coinbaseapi.exchange.coinbase.com/10 req/sec✅ Real-time
Krakenapi.kraken.com/0/public/1 req/sec✅ Real-time
OKXokx.com/api/v5/market/20 req/2sec✅ Real-time
Bybitapi.bybit.com/v5/market/120 req/sec✅ Real-time

All of these are free, no API key required for public market data.

Example: Binance Spot Price
GET https://api.binance.com/api/v3/ticker/price?symbol=BTCUSDT

Response: { "symbol": "BTCUSDT", "price": "64523.45000000" }
Example: Binance 24h Ticker
GET https://api.binance.com/api/v3/ticker/24hr?symbol=ETHUSDT

Response: {
  "symbol": "ETHUSDT",
  "priceChange": "45.20",
  "priceChangePercent": "1.42",
  "lastPrice": "3245.67",
  "volume": "584231.45",
  "highPrice": "3289.00",
  "lowPrice": "3178.23"
}
DEX On-Chain Data

For tokens that aren't listed on CEXes (the long tail), DEX pools are the only price source.

SourceChainsHow Price Is Determined
Uniswap V2ETH, Arbitrum, etc.Constant product: price = reserveB / reserveA
Uniswap V3ETH, Arbitrum, etc.Square root price from pool slot0: sqrtPriceX96
CurveETH, Arbitrum, etc.StableSwap invariant (optimized for pegged assets)
CamelotArbitrumV2 + V3 pools (Arbitrum-native)

Reading DEX prices:

  1. Direct RPC — Call pool contracts to read reserves/sqrtPrice
  2. The Graph — Query indexed swap events via GraphQL
  3. DexScreener API — Aggregated DEX data across 80+ chains
DexScreener Example
GET https://api.dexscreener.com/latest/dex/tokens/0xD74f5255D557944cf7Dd0E45FF521520002D5748

Returns: SPA pair data across all DEXes
How CEX and DEX Prices Stay in Sync

Arbitrage bots. If ETH is $3,200 on Binance but $3,210 on Uniswap:

  1. Bot buys on Binance (cheaper)
  2. Bot sells on Uniswap (expensive)
  3. Price difference narrows until it's less than gas + bridge costs

This is why prices across venues are usually within 0.1–0.5% of each other.

Layer 2: Oracle Networks

Oracles aggregate CEX + DEX data and make it available on-chain for smart contracts.

The dominant oracle network. ~1000+ price feeds across EVM chains.

How it works:

  1. Multiple independent oracle nodes fetch prices from CEXes and DEXes
  2. Each node submits its observation to the aggregator contract
  3. The contract takes the median of all observations
  4. Updates when: deviation > threshold (typically 0.5–1%) OR heartbeat time passes

Reading a Chainlink feed on-chain:

// ETH/USD on Ethereum: 0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419
// SPA/USD on Arbitrum: Available via Chainlink

function getPrice() {
    (, int256 price,,,) = priceFeed.latestRoundData();
    return uint256(price); // 8 decimals
}

Key feeds:

FeedAddress (Ethereum)Decimals
ETH/USD0x5f4eC3Df9cbd43714FE2740f5E3616155c5b84198
BTC/USD0xF4030086522a5bEEa4988F8cA5B36dbC97BeE88c8
USDC/USD0x8fFfFfd4AfB6115b954Bd326cbe7B4BA576818f68

Sperax Context: USDs uses Chainlink price feeds via its MasterPriceOracle to value collateral (USDC, USDT) and maintain its peg.

Pyth Network

Pull oracle — prices update sub-second but consumers must "pull" the latest update on-chain.

GET https://hermes.pyth.network/api/latest_price_feeds?ids[]=0xff61491a931112ddf1bd8147cd1b641375f79f5825126d665480874634fd0ace

Returns: { price: "6452345000000", expo: -8, conf: "2500000" }
FeatureChainlinkPyth
ModelPush (auto-updates)Pull (consumer requests)
Latency1–60 min heartbeat~400ms
CostGas paid by oracle networkGas paid by consumer
Coverage1000+ feeds500+ feeds
SecurityBattle-tested (5+ years)Newer but growing fast

Layer 3: Free Aggregator APIs

These combine CEX + DEX + oracle data into convenient APIs.

Show full SKILL.md (291 more words)Show less
DeFi Llama (Best Free Option)

Zero rate limiting. Zero API key. Most generous free API in crypto.

EndpointWhat It Returns
coins.llama.fi/prices/current/{coins}Current prices for any token
api.llama.fi/protocolsAll tracked protocols with TVL
yields.llama.fi/poolsAll yield pools across DeFi
stablecoins.llama.fi/stablecoinsAll stablecoin market data

Price query example:

GET https://coins.llama.fi/prices/current/arbitrum:0xD74f5255D557944cf7Dd0E45FF521520002D5748

Returns: USDs price from on-chain sources
CoinCap

Simple, clean API for top 2000 coins.

GET https://api.coincap.io/v2/assets?limit=10

Returns: Top 10 coins by market cap with price, volume, change
CoinPaprika

Decent free tier with ATH data and social links.

GET https://api.coinpaprika.com/v1/tickers/btc-bitcoin

Returns: Price, ATH, ATH date, volume, market cap, beta, supply
CryptoCompare

Good for OHLCV (candlestick) data.

GET https://min-api.cryptocompare.com/data/v2/histoday?fsym=BTC&tsym=USD&limit=30

Returns: 30 days of daily OHLCV data

Building Without CoinGecko

A practical multi-source approach:

Data NeedPrimary SourceFallback
Top coin pricesBinance APICoinCap
Long-tail tokensDexScreenerDeFi Llama
Historical OHLCVCryptoCompareBinance klines
TVL / protocol dataDeFi Llama— (only source)
Yield / APY dataDeFi Llama yields—
On-chain accurate priceChainlink feedsPyth
Token metadataCoinPaprikaToken Lists
Market sentimentFear & Greed API—

Waterfall strategy (what production apps use):

1. Try Binance (fastest, most liquid)
2. Fall back to CoinCap (broader coverage)
3. Fall back to DexScreener (on-chain tokens)
4. Fall back to DeFi Llama (universal)

SperaxOS uses a similar multi-provider waterfall: Binance → CoinCap → DexScreener → CoinGecko for maximum reliability.

Price Calculation Methods

VWAP (Volume-Weighted Average Price)

How aggregators compute a single price from multiple exchanges:

VWAP = Σ(Price_i × Volume_i) / Σ(Volume_i)

Example:

ExchangePrice24h Volume
Binance$3,200$2B
Coinbase$3,205$500M
Kraken$3,198$100M
VWAP = (3200×2B + 3205×500M + 3198×100M) / (2B + 500M + 100M)
     = $3,200.96
TWAP (Time-Weighted Average Price)

Used by Uniswap V3 oracle and some protocols:

TWAP = Average price over a time window (e.g., last 30 minutes)

More resistant to manipulation than spot price.

Agent Tips

  1. Never rely on a single source — always implement fallbacks
  2. CEX data is freshest for major tokens — use Binance/Coinbase first
  3. DEX data is essential for tokens not listed on CEXes
  4. DeFi Llama is the best free API — zero rate limiting, comprehensive
  5. Chainlink feeds are the gold standard for on-chain price verification
  6. Always show the data source — users should know where prices come from

© nirholas, MIT. 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 data/skills/analysis/crypto-price-data-guide of nirholas/three.ws.

Open the folder on GitHubat commit 238ef60

Compare with similar skills

Crypto Price Data Guide 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.

Crypto Price Data Guide compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Crypto Price Data Guide this skillnirholas/three.ws226—~2.7kAutomated safety check: PassMIT
Aomi Transactmajiayu000/claude-skill-registry6662 repos~2.3kAutomated safety check: PassMIT
Ethskillsaustintgriffith/ethskills294—~3kAutomated safety check: PassNone
Onchainsundial-org/awesome-openclaw-skills663—~2.2kAutomated safety check: PassNone
Onchain Pay Open APInpc-live/clawfirm1561 repos~4.9kAutomated safety check: PassMIT
Oracle Flashloan Analysisquillai-network/quillshield_skills129—~2.8kAutomated safety check: PassMIT

Similar skills

  • Aomi Transact

    majiayu000/claude-skill-registry

    Build natural-language crypto/DeFi agents and EVM MCP plugins (Claude Code, Cursor, Codex, Gemini).

    666 GitHub starsUsed in 2 repos~2.3k tokens
    Business, Finance & HRAuto-check passed
  • Ethskills

    austintgriffith/ethskills

    A skill your agent uses when a request involves Ethereum, the EVM, or blockchain systems.

    294 GitHub stars~3k tokensUpdated 1 mo ago
    Backend & APIsAuto-check passed
  • Onchain

    sundial-org/awesome-openclaw-skills

    CLI for crypto portfolio tracking, market data, CEX history, and transaction lookups.

    663 GitHub stars~2.2k tokensUpdated 7 mo ago
    Business, Finance & HRAuto-check passed
  • Onchain Pay Open API

    npc-live/clawfirm

    Binance Onchain Pay enables users to buy cryptocurrency with fiat (e.g., EUR, USD) or send existing crypto from their Binance account directly to any external on-chain wallet address in a single…

    156 GitHub starsUsed in 1 repo~4.9k tokens
    Business, Finance & HRAuto-check passed
  • Oracle Flashloan Analysis

    quillai-network/quillshield_skills

    Detects price oracle manipulation and flash loan attack vectors in DeFi smart contracts.

    129 GitHub stars~2.8k tokensUpdated 6 mo ago
    Business, Finance & HRAuto-check passed
  • Trading Evm

    alsk1992/CloddsBot

    Trade tokens on EVM chains - Uniswap V3, 1inch on Ethereum, Arbitrum, Optimism, Base, Polygon

    2.9k GitHub stars~1.9k tokensUpdated 4 days ago
    Backend & APIsAuto-check passed

More from nirholas/three.ws

All 165 skills in this repo
  • Add Shader Cursor Trail

    nirholas/three.ws

    Add the Shaders WebGPU mouse effect used for the Tidal Commons hero: a white twinkling halftone cursor trail driven by ChromaFlow, masked through a DotGrid, finished with chromatic ripples and film…

    226 GitHub starsUsed in 1 repo~760 tokens
    Auto-check passed
  • Publish Project To GitHub

    nirholas/three.ws

    Package a finished local project into an intentional GitHub repository, create a strong README and visual preview, push it safely, configure a public GitHub Pages URL when the project is compatible…

    226 GitHub starsUsed in 1 repo~2.2k tokens
    Auto-check: notes
  • Audit a website or digital experience against its supplied source references for originality and plagiarism risk.

    226 GitHub starsUsed in 1 repo~1.8k tokens
    Auto-check passed
  • Turn a completed daily UI inspiration capture into exactly five original landing-page builds, one per separate Codex task, using Sites.

    226 GitHub starsUsed in 1 repo~1.9k tokens
    Auto-check passed
  • Write Like Meng On X

    nirholas/three.ws

    Write, rewrite, review, or continuously refine X/Twitter posts in Meng To's current voice using his deduplicated authored-post corpus, personal and product context, shared resources, and Content…

    226 GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Browser Video Recording

    nirholas/three.ws

    Create polished 60 fps 4:3 4K browser screen-recording style videos from Codex in-app browser captures, with browser-only crop, natural macOS cursor styling, deliberate click choreography…

    226 GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed

Questions about Crypto Price Data Guide

What does Crypto Price Data Guide do?

How cryptocurrency prices work — the complete data pipeline from CEX order books and DEX pools through oracle networks to aggregators. ws. How cryptocurrency prices work — the complete data pipeline from CEX order books and DEX pools through oracle networks to aggregators.

When should I use Crypto Price Data Guide?

Crypto Price Data Guide fits situations like: explaining price sources; building market data features; comparing data providers.

How do I install Crypto Price Data Guide in Claude Code?

Run `npx skills add nirholas/three.ws --skill crypto-price-data-guide -a claude-code`. Or copy the skill folder (data/skills/analysis/crypto-price-data-guide in nirholas/three.ws) into .claude/skills/crypto-price-data-guide in your project. Claude Code loads it when a task matches its description.

How do I install Crypto Price Data Guide in Codex?

Run `npx skills add nirholas/three.ws --skill crypto-price-data-guide -a codex`. Or copy the skill folder (data/skills/analysis/crypto-price-data-guide in nirholas/three.ws) into .agents/skills/crypto-price-data-guide in your project. Codex loads it when a task matches its description.

Can I use Crypto Price Data Guide 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 nirholas/three.ws --skill crypto-price-data-guide -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/crypto-price-data-guide, .gemini/skills/crypto-price-data-guide, .github/skills/crypto-price-data-guide and .opencode/skills/crypto-price-data-guide in your project.

What does Crypto Price Data Guide need to run?

SKILL.md names no scripts, command-line tools or credentials: Crypto Price Data Guide is instructions for the agent only.

Does Crypto Price Data Guide access the network?

SKILL.md names 13 domains. In commands or code: api.binance.com, api.dexscreener.com, hermes.pyth.network, coins.llama.fi, api.coincap.io, api.coinpaprika.com and min-api.cryptocompare.com; the agent is likely to contact these when it follows the instructions. As links in the text: defillama.com, binance-docs.github.io, data.chain.link, docs.dexscreener.com, docs.coincap.io and pyth.network. This is read from the text; nothing was executed.

Is Crypto Price Data Guide safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Crypto Price Data Guide use?

Crypto Price Data Guide is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Crypto Price Data Guide use?

About 2.7k tokens (SKILL.md is roughly 11k 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 Crypto Price Data Guide?

Skills that share tags, products or a category with Crypto Price Data Guide: Aomi Transact (majiayu000/claude-skill-registry, 666 stars), Ethskills (austintgriffith/ethskills, 294 stars), Onchain (sundial-org/awesome-openclaw-skills, 663 stars) and Onchain Pay Open API (npc-live/clawfirm, 156 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Crypto Price Data Guide?

nirholas (a GitHub user) maintains it in nirholas/three.ws, which has 226 GitHub stars. The repository holds 165 skills in this directory. The repository was last updated on October 7, 2026.

Source: nirholas/three.ws on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.