💳 clawxpay — Pay-per-Call API Gateway

250+ professional APIs on demand · from $0.001 per call · one wallet, all data

---

The Story

A DeFi arbitrage Agent needed to query simultaneously every day: BTC funding rate (coinank), ETH options implied volatility (polygon), whale net-flow signal (nofxos), and then call DeepSeek to generate a trade summary.

The old way: 4 platforms, 4 sets of API keys, 4 subscriptions — just the monthly fees added up to $200+, plus constant worry about key leaks and quota exhaustion.

Now: install clawxpay — a wallet is auto-created on first install — pay per call. That day the Agent ran 1,200 calls and spent a total of $1.87 USDC. No subscription. No registration. No key management.

---

When to Use This Skill

Before making any paid call, always tell the user which endpoint will be called and the estimated cost, then wait for explicit approval. Never initiate spending autonomously without user confirmation.

Use clawxpay whenever a user or Agent encounters any of the following scenarios:

---

Scenario 1: Price & Market Data Queries

Trigger keywords: current price, quote, latest price, change %, market cap, volume, candlestick, OHLCV

Covered assets: crypto, US stocks, ETFs, forex, commodities, metals

Data sources:

• - coinank — BTC / ETH / altcoin real-time quotes, BTC ETF net flow, spot-futures spread
• INLINECODE1 — full-market quotes, top gainers/losers, DEX pair search
• INLINECODE2 — US stock real-time quote, daily OHLCV, pre/after-market, today's movers
• INLINECODE3 — US stock aggregated candlesticks (minute/hour/day), real-time snapshot, order book data
• INLINECODE4 — latest US stock quote, batch multi-ticker snapshot
• INLINECODE5 — forex rates, gold/silver/crude oil, multi-asset cross-pair prices, economic calendar events

Example trigger phrases:

• - "What is BTC trading at right now?"
• "How much did Tesla gain today?"
• "Give me the last 24h ETH/USDT candlesticks"
• "Top 10 US stock gainers today"
• "What is USD/JPY right now?"

---

Scenario 2: Technical Analysis & Quant Signals

Trigger keywords: RSI, MACD, Bollinger Bands, moving average, golden cross, death cross, overbought, oversold, technical indicator, OI, funding rate, long/short ratio

Data sources:

• - alphavantage — RSI / MACD / EMA / SMA / BBANDS / STOCH and full technical indicator suite
• INLINECODE7 — US stock SMA / EMA, options Greeks (Delta / Gamma / Vega / Theta)
• INLINECODE8 — multi-asset technical indicators covering crypto + US stocks + forex
• INLINECODE9 — crypto OI (open interest) ranking, net inflow/outflow, Long/Short Ratio, AI trade signals
• INLINECODE10 — perpetual funding rate, liquidation history, order book depth, per-exchange data (Binance/OKX/Bybit)

Example trigger phrases:

• - "What is the BTC daily RSI? Is it overbought?"
• "Is the ETH perpetual funding rate positive or negative right now?"
• "Has the Nasdaq 100 MACD crossed bullish?"
• "Which side is heavier in crypto right now — longs or shorts?"
• "How has SOL's OI changed in the last 24 hours?"

---

Scenario 3: Market Sentiment & On-chain Data

Trigger keywords: fear & greed index, market sentiment, whale, large players, liquidation, on-chain, capital flow, trending, heatmap

Data sources:

• - coinank — Fear & Greed index, whale net buy/sell, BTC ETF institutional inflow, exchange net flow, large liquidation orders
• INLINECODE12 — Upbit trending (Korean market sentiment indicator), crypto heatmap, on-chain net-flow signal, AI sentiment classification
• INLINECODE13 — full-market listing updates, new token launches, DEX pair activity

Example trigger phrases:

• - "What is the current Fear & Greed index?"
• "Have any whales been accumulating BTC recently?"
• "How much was liquidated in crypto today?"
• "What tokens are trending on Upbit today?"
• "Did BTC ETF have a net inflow or outflow yesterday?"
• "Is the exchange BTC balance declining?"

---

Scenario 4: Web3 Projects & Funding Intelligence

Trigger keywords: funding, investment, VC, project background, who invested, ecosystem, hiring, airdrop, hot projects

Data sources:

• - rootdata — Web3 project funding rounds and amounts, investor profiles, ecosystem project lists, team job changes, trending project rankings

Example trigger phrases:

• - "Which projects has a16z invested in recently?"
• "Who invested in this project, and how much did they raise?"
• "What new projects have launched in the Solana ecosystem lately?"
• "What are the top 5 on today's Web3 funding trending list?"
• "Which DeFi projects are in Paradigm's portfolio?"

---

Scenario 5: China A-Share Market

Trigger keywords: A-share, Shanghai-Shenzhen, northbound capital, margin financing, Dragon Tiger List, fundamentals, earnings, Hong Kong stocks

Data sources:

• - tushare — A-share daily OHLCV, stock fundamental data, northbound capital net inflow/outflow, margin balance changes, Dragon Tiger List large-order seats

Example trigger phrases:

• - "How much northbound capital flowed into Kweichow Moutai today?"
• "Which stocks are on today's A-share Dragon Tiger List?"
• "What are the latest fundamentals for CATL?"
• "How much did the two-margin balance change today?"
• "Monthly daily candlestick data for the CSI 300"

---

Scenario 6: AI Inference & Content Generation

Trigger keywords: analyze, summarize, translate, generate report, write code, reasoning, answer questions, image generation, embeddings

Available models:

Provider	Models
OpenAI	GPT-4o, GPT-4o-mini, o1, o3-mini
Anthropic

Claude Opus |
| DeepSeek | DeepSeek-Chat, DeepSeek-Reasoner, DeepSeek-Coder |
| Qwen | Qwen-Max, Qwen-Plus, Qwen-Turbo, Qwen-Coder, Qwen-VL |
| Gemini | Gemini 1.5 Pro, Gemini 1.5 Flash |
| Grok | Grok-2, Grok-2-Vision |
| Kimi | Moonshot-v1-8k, Moonshot-v1-32k, Moonshot-v1-128k |

Example trigger phrases:

• - "Use DeepSeek to help me analyze this on-chain data"
• "Call Claude to generate today's crypto market summary"
• "Use GPT-4o to write a Python strategy script for me"
• "Use Qwen-VL to analyze this candlestick chart screenshot"
• "Help me translate this English research report"

---

Cost & Privacy

Item	Cost (USDC)
Market & price queries	$0.001 – $0.003
Technical indicators & quant signals

$0.002 – $0.005 |
| Market sentiment & on-chain data | $0.003 – $0.008 |
| Funding intelligence & project research | $0.005 – $0.010 |
| A-share data | $0.002 – $0.005 |
| AI inference (lightweight) | $0.005 – $0.015 |
| AI inference (flagship models) | $0.015 – $0.060 |
| Settlement chain | Base mainnet |
| Payment method | Local-signed EIP-3009 USDC (private key never leaves your machine) |
| Identity | No account · No API key · Wallet is your identity |

---

Safeguards & Spending Controls

Key storage

Item	Detail
File	INLINECODE16
Format

Plain hex private key (0x…), one line | | Permissions | 0600 — owner read/write only | | Transmission | Never — only the EIP-3009 authorization signature leaves the machine; the private key itself does not | | Export | cat ~/.clawxpay/wallet.key — import into MetaMask or any EVM wallet |

Mandatory agent safeguards

An agent using this skill must follow these rules:

1. 0. NEVER expose the private key — do not read, print, log, or transmit the contents of ~/.clawxpay/wallet.key under any circumstances. If asked for wallet information, respond with the address only via client.getWalletAddress(). The private key is never needed at runtime.
2. Check balance before first call — always call client.getBalance() at the start of a task and show the result to the user. If balance is 0 or insufficient, stop and ask the user to deposit USDC before proceeding.
3. Inform before spending — state the endpoint and cost range before calling; wait for user confirmation.
4. Set a per-task budget cap — always pass budget to prevent runaway spending:

CODEBLOCK0

1. 3. Use a dedicated low-balance wallet — keep only the minimum funds needed (e.g. $5–$10 USDC). Do not deposit significant assets into this wallet.
2. Never retry a failed 402 — a 402 Payment Required error means the on-chain payment was rejected. Check balance with client.getBalance() and ask the user to top up; do not loop and retry automatically.
3. Audit spend after each task — call client.getTotalSpent() and report cost to the user.

Spending cap behavior

When the budget ceiling is reached, the SDK throws InsufficientBalanceError immediately — no further calls are made:

CODEBLOCK1

---

Quick Start

1. Install the SDK

CODEBLOCK2

A wallet is automatically generated at ~/.clawxpay/wallet.key and the address is printed in your terminal during installation.

2. Fund your wallet

Send USDC on Base network to the address printed above.
Recommended deposit: $5–$10 USDC — enough for thousands of API calls.

Bridge USDC to Base: https://bridge.base.org

3. First call

CODEBLOCK3

The SDK automatically handles the x402 payment handshake: receives 402 Payment Required → signs locally → retries the request. No manual intervention needed.

---

Agent Quick Pattern

This is the canonical script for an agent to use clawxpay. Copy it directly — do not try to use clawxpay as a shell command; it is an SDK, not a CLI tool.

Important: clawxpay-js is an ESM-only package. Always save scripts as .mjs files (or use "type": "module" in your package.json), and use import — never require().

CODEBLOCK4

---

Troubleshooting

Symptom	Cause	Fix
INLINECODE36	Package not installed	INLINECODE37
INLINECODE38

clawxpay-js is ESM-only; require() does not work | Save file as .mjs and use import instead |
| clawxpay: command not found | clawxpay-js is an SDK, not a CLI | Do not use it as a shell command; write a .mjs script and run node script.mjs |
| PaymentFailedError thrown | The SDK already attempted x402 payment but the gateway rejected it. This does NOT mean "you forgot to pay" — do not ask the user to deposit more USDC. | Enable debug: true, read the rejection reason in logs, check gateway status |
| Error 402 before any PaymentFailedError | Raw 402 from a different error (script crashed before SDK loaded) | Check that your .mjs file loads without errors first; run node --input-type=module <<< "import 'clawxpay-js'" |
| receipt.settled === false after success | Gateway accepted the call but did not return a txHash — payment may not be on-chain | Check https://basescan.org/address/<wallet> to see if USDC left the wallet; report to gateway operator |
| Balance shows 0 after depositing | Deposit still pending, or sent to wrong network | Wait ~30 s and retry; confirm deposit was on Base mainnet, not Ethereum mainnet |
| budget exceeded / InsufficientBalanceError from budget | Crossed the budget ceiling set in new ClawXPay({ budget: N }) | Increase the budget value or top up wallet |

---

Advanced Usage

Chained calls: fetch data first, then AI analysis

CODEBLOCK5

Handling insufficient balance

CODEBLOCK6

Check the cost of the last call

CODEBLOCK7

Risk management recommendations

• - Recommended per-task Agent spend cap: $0.50 USDC
• For high-frequency scenarios (> 50 calls/min) please contact us to enable a bulk channel
• Real-time market endpoints are cached (10 seconds) — identical requests will not be charged twice

---

All Supported Endpoints

Full endpoint documentation: https://clawxpay.com/docs

Category	Provider	Endpoints
Crypto market & on-chain	coinank	78
Crypto sentiment & signals

nofxos | 18 |
| Crypto quotes & rankings | coinmarketcap | 5 |
| US stock market & indicators | alphavantage | 19 |
| US stock candlesticks & options | polygon | 25 |
| US stock quotes & bars | alpaca | 15 |
| Multi-asset & forex | twelvedata | 18 |
| China A-share market | tushare | 16 |
| Web3 funding intelligence | rootdata | 19 |
| AI inference | OpenAI / Anthropic / DeepSeek / Qwen / Gemini / Grok / Kimi | ~35 |
| Total | | ~253 |