chartsplat-x402-cli

Pay-per-chart CLI for Chart Splat. Pays ~$0.005 USDC per chart on Base mainnet via x402 — no API key, no signup, no subscription.

This is the wallet-based counterpart to chartsplat-cli (which authenticates with CHARTSPLAT_API_KEY). Use whichever fits your setup.

Installation

npm install -g chartsplat-x402-cli

Or use with npx (no installation required):

npx chartsplat-x402-cli bar --labels "Q1,Q2,Q3,Q4" --data "50,75,60,90" -o chart.png

Quick Start

Set your wallet private key (the wallet needs a small USDC balance on Base mainnet — ~$0.05 buys ten charts):

export X402_PRIVATE_KEY=0xYOUR_PRIVATE_KEY

Generate a chart:

chartsplat-x402 bar -l "Q1,Q2,Q3,Q4" -d "50,75,60,90" -t "Revenue" -o chart.png

Output:

✔ Chart saved to chart.png
  Settlement: https://basescan.org/tx/0x...
  Payer:      0x...

The buyer never sends an on-chain transaction directly. The Coinbase x402 facilitator settles the payment and pays the gas.

Commands

chartsplat-x402 line       -l "Mon,Tue,Wed" -d "5,9,3" -o line.png
chartsplat-x402 bar        -l "A,B,C"       -d "10,20,30" -o bar.png
chartsplat-x402 pie        -l "Red,Blue,Green" -d "30,50,20" -o pie.png
chartsplat-x402 doughnut   -l "Yes,No"      -d "60,40"   -o doughnut.png
chartsplat-x402 radar      -l "S,P,R,D,A"   -d "8,9,7,8,9" -o radar.png
chartsplat-x402 polararea  -l "N,E,S,W"     -d "4,3,5,2" -o polar.png
chartsplat-x402 candlestick --config ohlc.json -o candle.png
chartsplat-x402 ohlc        --config ohlc.json -o ohlc.png

chartsplat-x402 init       -o chart-config.json   # write a sample config
chartsplat-x402 info                              # show wallet & API info

Options (line / bar / pie / doughnut / radar / polararea)

| Flag | Description | |------|-------------| | -l, --labels <csv> | Comma-separated labels | | -d, --data <csv> | Comma-separated numeric values | | -t, --title <text> | Chart title | | --label <text> | Dataset label for legend | | -c, --color <hex> | Background color | | -w, --width <px> | Image width (default: 800) | | --height <px> | Image height (default: 600) | | -o, --output <file> | Output file path (default: chart.png) | | --config <file> | JSON config file (alternative to --labels/--data) | | --private-key <key> | Wallet private key (or set X402_PRIVATE_KEY) |

Environment

| Variable | Description | |----------|-------------| | X402_PRIVATE_KEY | Hex private key for the paying wallet (required) | | CHARTSPLAT_API_URL | Override API base URL (default: https://api.chartsplat.com) |

Networks

| Network | Chain ID | Token | Use | |---------|----------|-------|-----| | Base | eip155:8453 | USDC | Production | | Base Sepolia | eip155:84532 | USDC | Testing (set CHARTSPLAT_API_URL to a Sepolia server) |

Get test USDC for Base Sepolia at https://faucet.circle.com.

License

MIT