claw402

Typed Python SDK for claw402.ai — pay-per-call data APIs via x402 micropayments.

200+ endpoints covering crypto market data, US stocks, China A-shares, forex, global time-series, and AI (OpenAI/Anthropic). No API key, no signup, no subscription — just a Base wallet with USDC.

Install

pip install git+https://github.com/NoFxAiOS/claw402-python.git

Quick Start

from claw402 import Claw402

client = Claw402(private_key="0xYourPrivateKey")

# Crypto: Fund flow — $0.001/call
flow = client.coinank.fund.realtime(product_type="SWAP")
print(flow)

# US Stocks: Latest quote — $0.001/call
quote = client.alpaca.quotes.latest(symbols="AAPL,TSLA")
print(quote)

# US Stocks: Market snapshot — $0.002/call
snap = client.polygon.snapshot.all(tickers="AAPL")
print(snap)

# China A-shares — $0.001/call
stocks = client.tushare.cn.stock_basic(list_status="L")
print(stocks)

# Forex time-series — $0.001/call
ts = client.twelvedata.get_time_series(symbol="EUR/USD", interval="1h")
print(ts)

# AI: OpenAI chat — $0.01/call
resp = client.openai.openai.chat({"messages": [{"role": "user", "content": "Hello"}]})
print(resp)

# AI: Anthropic Claude — $0.015/call
resp = client.anthropic.anthropic.messages({"messages": [{"role": "user", "content": "Hello"}]})
print(resp)

Features

Typed methods — every endpoint has a dedicated Python method with keyword arguments
Automatic x402 payment — signs EIP-3009 USDC transfers locally, never sends your key
9 provider groups — crypto, US stocks, China stocks, forex, global data, and AI
Context manager — with Claw402(...) as client: for automatic cleanup
Zero config — just a private key, no API keys or registration
Base mainnet — pays USDC per call on Coinbase L2

API Overview

Crypto Market Data

Coinank

Resource	Methods	Description
`coinank.fund`	`realtime`, `history`	Real-time & historical fund flow
`coinank.oi`	`all`, `agg_chart`, `symbol_chart`, `kline`, ...	Open interest data
`coinank.liquidation`	`orders`, `intervals`, `agg_history`, `liq_map`, `heat_map`, ...	Liquidation tracking
`coinank.funding_rate`	`current`, `accumulated`, `hist`, `weighted`, `heatmap`, ...	Funding rate analytics
`coinank.longshort`	`realtime`, `buy_sell`, `person`, `position`, ...	Long/short ratios
`coinank.hyper`	`top_position`, `top_action`	HyperLiquid whale tracking
`coinank.etf`	`us_btc`, `us_eth`, `us_btc_inflow`, `us_eth_inflow`, `hk_inflow`	ETF flow data
`coinank.indicator`	`fear_greed`, `altcoin_season`, `btc_multiplier`, `ahr999`, ...	Market cycle indicators
`coinank.market_order`	`cvd`, `agg_cvd`, `buy_sell_value`, ...	Taker flow / CVD
`coinank.kline`	`lists`	OHLCV candlestick data
`coinank.price`	`last`	Real-time price
`coinank.rank`	`screener`, `oi`, `volume`, `price`, `liquidation`, ...	Rankings & screeners
`coinank.news`	`list`, `detail`	Crypto news & alerts

Nofxos (AI Signals)

Resource	Methods	Description
`nofxos.ai500`	`list`, `stats`	AI500 high-potential coin signals
`nofxos.ai300`	`list`, `stats`	AI300 quant model rankings
`nofxos.netflow`	`top_ranking`, `low_ranking`	Net capital flow rankings
`nofxos.oi`	`top_ranking`, `low_ranking`	OI change rankings
`nofxos.funding_rate`	`top`, `low`	Extreme funding rate coins
`nofxos.price`	`ranking`	Price change rankings
`nofxos.upbit`	`hot`, `netflow_top_ranking`, `netflow_low_ranking`	Korean market data

US Stock & Options Market

Alpaca

Resource	Methods	Description
`alpaca.quotes`	`latest`, `history`	Real-time & historical quotes — $0.001–0.002/call
`alpaca.bars`	`latest`	Latest OHLCV bar — $0.001/call
`alpaca.trades`	`latest`, `history`	Real-time & historical trades — $0.001–0.002/call
`alpaca.options`	`bars`, `quotes_latest`, `snapshots`	Options chain data — $0.003/call
`alpaca`	`get_bars`, `snapshots`, `snapshot`, `movers`, `most_actives`, `news`, `corporate_actions`	Direct market endpoints — $0.001–0.002/call

# Latest quotes for multiple symbols
q = client.alpaca.quotes.latest(symbols="AAPL,MSFT,TSLA")

# Historical bars
bars = client.alpaca.get_bars(symbols="AAPL", timeframe="1Day", start="2024-01-01")

# Top market movers
movers = client.alpaca.movers(top=10, market_type="stocks")

# Options snapshots
opts = client.alpaca.options.snapshots(symbols="AAPL240119C00150000")

Polygon

Resource	Methods	Description
`polygon.aggs`	`aggs`, `grouped_daily`, `daily_open_close`, `previous_close`	Aggregates / OHLCV bars — $0.001/call
`polygon.snapshots`	`all_tickers`, `single_ticker`, `gainers_losers`, `universal_snapshot`, `options_chain`	Full market snapshots — $0.002/call
`polygon.trades`	`trades`, `last_trade`, `quotes`, `last_quote`	Trade & quote tick data — $0.002/call
`polygon`	`ticker_details`, `market_status`, `ticker_types`, `exchanges`, `conditions`, `sma`, `ema`, `rsi`, `macd`	Reference & technical indicators — $0.001–0.003/call

# OHLCV bars
bars = client.polygon.aggs.aggs(
    stocksTicker="AAPL", multiplier=1, timespan="day",
    from_="2024-01-01", to="2024-12-31"
)

# RSI indicator
rsi = client.polygon.rsi(stocksTicker="AAPL", timespan="day", window=14)

# Options chain
chain = client.polygon.snapshots.options_chain(underlyingAsset="AAPL")

Alpha Vantage

Resource	Methods	Description
`alphavantage.us`	`quote`, `search`, `daily`, `daily_adjusted`, `intraday`, `weekly`, `monthly`, `overview`, `earnings`, `income`, `balance_sheet`, `cash_flow`, `movers`, `news`, `rsi`, `macd`, `bbands`, `sma`, `ema`	Comprehensive financial data — $0.001–0.003/call

# Real-time quote
quote = client.alphavantage.us.quote(symbol="AAPL")

# Daily OHLCV
daily = client.alphavantage.us.daily(symbol="AAPL", outputsize="compact")

# Top movers (no params)
movers = client.alphavantage.us.movers()

# News sentiment
news = client.alphavantage.us.news(tickers="AAPL")

China A-Shares

Tushare

Resource	Methods	Description
`tushare.cn`	`stock_basic`, `daily`, `weekly`, `monthly`, `daily_basic`, `trade_cal`, `income`, `balance_sheet`, `cash_flow`, `dividend`, `northbound`, `moneyflow`, `margin`, `margin_detail`, `top_list`, `top_inst`	China A-share market data — $0.001–0.003/call

# Stock list
stocks = client.tushare.cn.stock_basic(list_status="L")

# Daily OHLCV
daily = client.tushare.cn.daily(ts_code="000001.SZ", start_date="20240101", end_date="20240131")

# Money flow
flow = client.tushare.cn.moneyflow(ts_code="000001.SZ", start_date="20240101")

# Northbound capital
north = client.tushare.cn.northbound(trade_date="20240101")

Global Time-Series & Forex

Twelve Data

Resource	Methods	Description
`twelvedata.time_series`	`complex` (POST)	Complex multi-symbol/indicator query — $0.005/call
`twelvedata.indicator`	`sma`, `ema`, `rsi`, `macd`, `bbands`, `atr`	Technical indicators — $0.002/call
`twelvedata.metals`	`price`, `time_series`	Precious metals prices — $0.001/call
`twelvedata.indices`	`list_`, `quote`	Global index data — $0.001/call
`twelvedata`	`get_time_series`, `price`, `quote`, `eod`, `exchange_rate`, `forex_pairs`, `economic_calendar`	Direct endpoints — $0.001/call

# Time series (use get_time_series, NOT time_series — time_series is the sub-resource)
ts = client.twelvedata.get_time_series(symbol="EUR/USD", interval="1h", outputsize=3)

# Technical indicators
rsi = client.twelvedata.indicator.rsi(symbol="AAPL", interval="1day", time_period=14, outputsize=3)

# Real-time price
price = client.twelvedata.price(symbol="BTC/USD")

# Metals
gold = client.twelvedata.metals.price(symbol="XAU/USD")

AI Providers

OpenAI

Resource	Methods	Description
`openai.openai`	`chat`, `chat_mini`, `embeddings`, `embeddings_large`, `images`, `models`	OpenAI API — $0.001–0.05/call

# Chat (GPT-4o)
resp = client.openai.openai.chat({
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Analyze AAPL stock trend"}]
})

# Embeddings
emb = client.openai.openai.embeddings({
    "input": "crypto market sentiment",
    "model": "text-embedding-3-small"
})

Anthropic

Resource	Methods	Description
`anthropic.anthropic`	`messages`, `messages_extended`, `count_tokens`	Anthropic Claude API — $0.01–0.015/call

# Claude messages
resp = client.anthropic.anthropic.messages({
    "model": "claude-opus-4-6",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Summarize this earnings report: ..."}]
})

Configuration

# Custom base URL
client = Claw402(
    private_key="0x...",
    base_url="https://custom.gateway",
)

How Payment Works

SDK sends a GET/POST request to the endpoint
Server responds with 402 Payment Required + payment details in header
SDK signs an EIP-3009 TransferWithAuthorization for USDC on Base
SDK retries the request with the PAYMENT-SIGNATURE header
Server verifies payment on-chain and returns the data

Your private key never leaves your machine — it only signs the payment locally.

Requirements

Python 3.9+
A wallet with USDC on Base mainnet
Get USDC on Base: bridge.base.org

License

MIT

Name		Name	Last commit message	Last commit date
Latest commit History 4 Commits
.github		.github
claw402		claw402
docs		docs
examples		examples
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
pyproject.toml		pyproject.toml

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Repository files navigation

claw402

Install

Quick Start

Features

API Overview

Crypto Market Data

Coinank

Nofxos (AI Signals)

US Stock & Options Market

Alpaca

Polygon

Alpha Vantage

China A-Shares

Tushare

Global Time-Series & Forex

Twelve Data

AI Providers

OpenAI

Anthropic

Configuration

How Payment Works

Requirements

License

About

Uh oh!

Releases

Sponsor this project

Uh oh!

Packages

Uh oh!

Uh oh!

Contributors 1

Languages

Uh oh!

Folders and files

Latest commit

History

Repository files navigation

claw402

Install

Quick Start

Features

API Overview

Crypto Market Data

Coinank

Nofxos (AI Signals)

US Stock & Options Market

Alpaca

Polygon

Alpha Vantage

China A-Shares

Tushare

Global Time-Series & Forex

Twelve Data

AI Providers

OpenAI

Anthropic

Configuration

How Payment Works

Requirements

License

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases

Sponsor this project

Uh oh!

Packages 0

Uh oh!

Uh oh!

Contributors 1

Languages

Packages