# Scrapling x402 Data Store
> Pay-per-call crypto prices, DeFi yields and TVL, Polymarket odds, Base token scam checks, stock/ETF snapshots and clean web-page text for agents. Free endpoints; single lookups from $0.001; whole-market bundle $0.005; page-to-clean-text $0.003; full feeds $0.01-$4.99. Paid in USDC via x402 (Base, Polygon, Arbitrum, Solana). No account or API key required. No charge on failure: payment settles only after valid data.

Tasks this service answers: current BTC/ETH/any coin price and 24h change; best USDC yield on Base ranked by APY and risk; a DeFi protocol's TVL; Polymarket odds for an event; whether a Base token is a honeypot; the whole crypto market in one call (market-pulse bundle); which coins just moved more than X% (price-moves alerts); large whale orders and net whale flow on Hyperliquid (whale moves); go/caution/avoid verdict with facts for a token on 8 chains (token verdict); typical CPM/CPC/CTR for an ad platform and industry (ad cost benchmarks); any web page as clean text/Markdown ready for an LLM context window (boilerplate, nav and ads stripped), plus JSON-LD and tables.

Freshness: live feeds refresh about every 30 minutes; lookups answer from that cache, typically under 100 ms. Token-risk misses fall back to a live GoPlus check (about 1-3 s). Scrapes fetch the page live.

## FREE (no payment, 30 calls/min per IP)
- GET https://scraplingdata.xyz/v1/free/feeds : Free catalog of every live data feed (crypto, DeFi, Polymarket, stocks, token risk): row counts, last refresh time, full-feed price and matching paid lookup
- GET https://scraplingdata.xyz/v1/free/crypto/top10 : Free top 10 crypto prices: rank, USD price, market cap and 24h change for the 10 largest coins, snapshot refreshed about every 30 min
- GET https://scraplingdata.xyz/v1/free/defi/top-yields : Free top 5 DeFi yields across all chains ranked by risk-adjusted APY, with APY, TVL and risk level, refreshed about every 30 min
- GET https://scraplingdata.xyz/v1/datasets : catalog of every dataset with prices
- GET https://scraplingdata.xyz/v1/datasets/<dataset_id>/preview : up to 10 real rows of any dataset (ids from https://scraplingdata.xyz/v1/datasets)

## Task -> endpoint -> price (paid per call, x402 USDC)
| Task | Example request | Price |
| --- | --- | --- |
| Current BTC/ETH/any coin price, market cap, 24h change | GET https://scraplingdata.xyz/v1/lookup/coin/bitcoin | $0.001 |
| DeFi protocol TVL and 1d/7d trend (e.g. Aave) | GET https://scraplingdata.xyz/v1/lookup/protocol/aave | $0.001 |
| Best USDC yield on Base ranked by APY and risk | GET https://scraplingdata.xyz/v1/lookup/yields?chain=Base&token=USDC | $0.002 |
| One yield pool's APY, TVL and risk score | GET https://scraplingdata.xyz/v1/lookup/pool/aa70268e-4b52-42bf-a116-608b370f9501 | $0.001 |
| Polymarket odds for an event | GET https://scraplingdata.xyz/v1/lookup/polymarket?q=bitcoin | $0.005 |
| Is this Base token a scam / honeypot? (go/caution/avoid verdict) | GET https://scraplingdata.xyz/v1/lookup/token-risk/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 | $0.005 |
| Whole crypto market in one call: coins, volume, TVL, DEX volume, heatmap | GET https://scraplingdata.xyz/v1/bundle/market-pulse | $0.005 |
| Ad cost benchmarks: CPM/CPC/CTR by platform and industry, with sources | GET https://scraplingdata.xyz/v1/ads/cost-benchmarks?platform=meta&industry=real%20estate | $0.002 |
| Price move alerts: coins/DeFi TVL that moved more than X% in 1h/24h (poll it) | GET https://scraplingdata.xyz/v1/alerts/price-moves?threshold=5&window=24h | $0.002 |
| DeFi intel bundle: top TVL, TVL movers, chains, stablecoins, best risk-ranked yields | GET https://scraplingdata.xyz/v1/bundle/defi-intel | $0.003 |
| Whale moves: large Hyperliquid perp orders (>= $100k) with net whale buy/sell per coin (poll it) | GET https://scraplingdata.xyz/v1/whales/moves?min_usd=100000&window=1h | $0.005 |
| Whale flow for one coin plus mark price, funding, open interest | GET https://scraplingdata.xyz/v1/whales/token?chain=hyperliquid&coin=SOL | $0.005 |
| Should I trade this token? go/caution/avoid + liquidity, holders, taxes, contract flags (8 chains incl. Solana) | GET https://scraplingdata.xyz/v1/token/verdict?chain=base&address=0x4ed4e862860bed51a9570b96d89af5e1b0efefed | $0.005 |
| Whale exchange netflow: whale transfers into/out of exchanges (bearish/bullish) per token + Hyperliquid whale perp flow | GET https://scraplingdata.xyz/v1/signals/whale-netflow?chain=all&window=24h | $0.02 |
| Payment test: cheapest paid call to check your x402 setup | GET https://scraplingdata.xyz/v1/ping | $0.001 |
| Any web page as clean LLM-ready text (Markdown only) | GET https://scraplingdata.xyz/v1/scrape/text?url=... | $0.003 |
| Any web page as clean Markdown + JSON-LD + tables + links | GET https://scraplingdata.xyz/v1/scrape?url=... | $0.001-$0.025 ($0.005 typical) |
| Up to 100 pages in one call | POST https://scraplingdata.xyz/v1/batch-scrape | per page |
| Whole feed (500 coins, 1000 pools, 400 markets...) | GET https://scraplingdata.xyz/v1/datasets/{id}/buy | $0.01-$4.99 |

Lookup misses (unknown coin, no matching market) return 404 and are not charged. Upstream failures return 5xx and are not charged.

## Full live feeds (auto-refreshed ~every 30 min)
- `live_risk_ranked_yields`: DeFi Yields Ranked by Risk-Adjusted APY (Top 500) (500 rows, $0.49) -> GET https://scraplingdata.xyz/v1/datasets/live_risk_ranked_yields/buy
- `live_new_pools_base_solana`: New Token Pool Launches on Base & Solana (Last 3 Hours) with Risk Flags (200 rows, $0.49) -> GET https://scraplingdata.xyz/v1/datasets/live_new_pools_base_solana/buy
- `live_us_stocks_etfs`: Live US Stocks & ETFs Snapshot: Price, 1d/5d Change, 52w Range (93 rows, $0.05) -> GET https://scraplingdata.xyz/v1/datasets/live_us_stocks_etfs/buy
- `live_polymarket_odds`: Live Polymarket Prediction Market Odds + 1h/24h/7d Odds Change (Top 400 by Volume) (200 rows, $0.49) -> GET https://scraplingdata.xyz/v1/datasets/live_polymarket_odds/buy
- `live_dex_volumes`: Live DEX Trading Volume Rankings (24h/7d/30d) (400 rows, $0.49) -> GET https://scraplingdata.xyz/v1/datasets/live_dex_volumes/buy
- `live_stablecoin_supply`: Live Stablecoin Supply & Peg Tracker (300 rows, $0.49) -> GET https://scraplingdata.xyz/v1/datasets/live_stablecoin_supply/buy
- `live_defi_yield_pools`: Live Top 1000 DeFi Yield Pools: APY, TVL, Risk (1000 rows, $0.49) -> GET https://scraplingdata.xyz/v1/datasets/live_defi_yield_pools/buy
- `live_chain_tvl`: Live Blockchain TVL Rankings (All Chains) (295 rows, $0.49) -> GET https://scraplingdata.xyz/v1/datasets/live_chain_tvl/buy
- `live_defi_protocols_tvl`: Live Top 500 DeFi Protocols by TVL with 1d/7d Change (500 rows, $0.49) -> GET https://scraplingdata.xyz/v1/datasets/live_defi_protocols_tvl/buy
- `live_crypto_top500_markets`: Live Top 500 Crypto Markets: Price, Market Cap, Volume, 1h/24h/7d Change (500 rows, $0.49) -> GET https://scraplingdata.xyz/v1/datasets/live_crypto_top500_markets/buy
- `live_base_new_token_risk`: Base New Token Security Scan: Honeypot, Tax & Owner Risk Score (28 rows, $0.05) -> GET https://scraplingdata.xyz/v1/datasets/live_base_new_token_risk/buy

## How to pay (x402 v2)
1. Call any paid endpoint without payment -> HTTP 402 with a PAYMENT-REQUIRED header (base64 JSON).
2. Pick one `accepts` entry: scheme `exact`, USDC on Base (eip155:8453, preferred), Polygon (eip155:137) or Arbitrum (eip155:42161), or SPL USDC on Solana mainnet (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp, payTo 4ZUtqtQSrL522bcXTag1eR59cwfQhQGW16nYuzyYgRWX, facilitator pays fees). No gas needed.
3. Retry with the signed payload in the PAYMENT-SIGNATURE header. Settled via Coinbase CDP facilitator.
- payTo: `0x72C80C01fD89Bac74f47cf604b61ACd119c9BCdb`
- Alternative: prepaid key `Authorization: Bearer sk_scrapling_...`.

## MCP server
- Remote MCP (Streamable HTTP): https://scraplingdata.xyz/mcp
- Official MCP Registry name: `io.github.bnth09productions-maker/scrapling-x402-store`
- Free tools: list_datasets, preview_dataset, free_feeds, free_crypto_top10, free_defi_top_yields
- Paid tools: ping, whale_netflow, whale_moves, whale_token, token_verdict, market_pulse, defi_intel, price_moves, ad_cost_benchmarks, lookup_coin, lookup_protocol, lookup_yields, lookup_pool, lookup_polymarket, lookup_token_risk, scrape_text, scrape_url, get_dataset, buy_dataset (pay via params._meta['x402/payment'] or api_key)

## Discovery
- OpenAPI: https://scraplingdata.xyz/openapi.json
- x402 manifest: https://scraplingdata.xyz/.well-known/x402
- MCP server card: https://scraplingdata.xyz/mcp/server-card
- Logo: https://scraplingdata.xyz/logo.png