apiosk
by obcraft
Browser & AutomationBrief
**Pay-per-request API access for agents.
Description
What This Skill Does
Apiosk enables agents to call production APIs using USDC micropayments on Base blockchain instead of API keys or accounts. The x402 protocol handles payment automatically per request, deducting from a locally stored wallet. Nine built-in APIs cover weather, prices, news, geocoding, code execution, and file conversion.
Eliminates API key provisioning and monthly subscriptions by charging per request via on-chain micropayments, so agents can access multiple APIs without managing credentials.
When to Use It
- Fetching live weather data in agent code without an API key
- Tracking crypto and stock prices per request from automated scripts
- Looking up coordinates from addresses in location-aware agents
- Pulling topic-based news articles for a daily digest workflow
- Generating PDFs or screenshots in an automated processing pipeline
Example Workflow
User asks: Get the current weather in Amsterdam
- 1
Load wallet address from ~/.apiosk/wallet.json
- 2
Call callApiosk('weather', { city: 'Amsterdam' }) in agent code
- 3
Gateway responds with 402 Payment Required and wallet signs payment proof
- 4
Gateway verifies USDC payment on Base mainnet and forwards request to weather API
- 5
Return weather data including temperature, condition, and forecast
Weather report for Amsterdam with temperature and forecast; $0.001 USDC deducted from wallet
Requirements
- USDC on Base mainnet to fund the Apiosk wallet (minimum $1-10 recommended)
Installation
clawhub install obcraft/apioskRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.