{"name":"x402 Stacks API","description":"Pay-per-use API powered by x402 v2 protocol on Stacks blockchain. Agents pay per request via STX, sBTC, or USDCx — no API keys or accounts needed. Provides inference (LLM), hashing, Stacks utilities, and agent storage.","url":"https://x402.aibtc.dev","provider":{"organization":"AIBTC Working Group","url":"https://aibtc.com"},"version":"2.0.0","documentationUrl":"https://x402.aibtc.dev/llms.txt","openApiUrl":"https://x402.aibtc.dev/openapi.json","documentation":{"quickStart":"https://x402.aibtc.dev/llms.txt","fullReference":"https://x402.aibtc.dev/llms-full.txt","openApiSpec":"https://x402.aibtc.dev/openapi.json","x402Manifest":"https://x402.aibtc.dev/x402.json","platform":"https://aibtc.com/llms.txt","topicDocs":{"index":"https://x402.aibtc.dev/topics","inference":"https://x402.aibtc.dev/topics/inference","hashing":"https://x402.aibtc.dev/topics/hashing","storage":"https://x402.aibtc.dev/topics/storage","paymentFlow":"https://x402.aibtc.dev/topics/payment-flow"}},"capabilities":{"streaming":false,"pushNotifications":false,"stateTransitionHistory":false},"authentication":{"schemes":["x402v2"],"credentials":null},"defaultInputModes":["application/json"],"defaultOutputModes":["application/json"],"payment":{"protocol":"x402","version":2,"network":"stacks","tokens":["STX","sBTC","USDCx"],"tiers":{"free":{"amount":"0","description":"Model listings, health, docs","endpoints":["GET /inference/openrouter/models","GET /inference/cloudflare/models","GET /","GET /health","GET /docs","GET /openapi.json","GET /x402.json","GET /dashboard","GET /llms.txt","GET /llms-full.txt","GET /topics","GET /topics/:topic","GET /.well-known/agent.json"]},"standard":{"amount":"0.001 STX","description":"All paid endpoints (hashing, stacks, storage, Cloudflare AI)","endpoints":["POST /inference/cloudflare/chat","GET|POST|DELETE /stacks/*","POST /hashing/*","GET|POST|DELETE /storage/*"]},"dynamic":{"description":"OpenRouter LLM — pass-through cost + 20% margin","endpoints":["POST /inference/openrouter/chat"],"formula":"(input_tokens * prompt_cost + output_tokens * completion_cost) * 1.20","minimum":"$0.001 USD equivalent"}},"headers":{"request":"payment-signature","response":"payment-response","required":"payment-required","tokenType":"X-PAYMENT-TOKEN-TYPE"}},"skills":[{"id":"llm-inference","name":"LLM Inference (OpenRouter)","description":"Access 100+ LLM models via OpenRouter with dynamic pricing. POST /inference/openrouter/chat with model and messages. Pricing is dynamic: model cost + 20% margin. First request returns 402 with payment amount. Retry with payment-signature header for completion.","tags":["inference","llm","openrouter","chat","gpt","claude","llama"],"examples":["Generate text with GPT-4o","Chat with Claude via x402 payment","Use Llama 3 with STX payment"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"cloudflare-inference","name":"LLM Inference (Cloudflare AI)","description":"Cloudflare-hosted AI models at standard fixed pricing (0.001 STX). POST /inference/cloudflare/chat with @cf/ model id and messages.","tags":["inference","llm","cloudflare","ai","chat"],"examples":["Run inference on Cloudflare AI models"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"hashing","name":"Clarity-Compatible Hashing","description":"Six Clarity-compatible hash functions: SHA-256, SHA-512, SHA-512/256, Keccak-256, HASH160, RIPEMD-160. Outputs match Clarity built-in hash functions for on-chain verification. POST /hashing/{algorithm} with { data, encoding }. Standard pricing (0.001 STX).","tags":["hashing","sha256","sha512","keccak256","hash160","ripemd160","clarity"],"examples":["Hash data with SHA-256 (Clarity-compatible)","Compute HASH160 for Bitcoin address derivation","Keccak-256 hash for Ethereum compatibility"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"stacks-utilities","name":"Stacks Blockchain Utilities","description":"Stacks/Bitcoin address conversion, Clarity value decoding, transaction decoding, profile lookup, BIP-137 message verification, and SIP-018 structured data verification. Standard pricing (0.001 STX).","tags":["stacks","bitcoin","address","clarity","verification","sip018"],"examples":["Convert Bitcoin address to Stacks address","Decode Clarity value from hex","Verify a BIP-137 signed message","Verify SIP-018 structured data signature"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"kv-storage","name":"Agent KV Storage","description":"Isolated key-value storage scoped to paying agent's Stacks address. CRUD operations: GET/POST/DELETE /storage/kv. Optional metadata and TTL. Standard pricing (0.001 STX).","tags":["storage","kv","key-value","cache","durable-object"],"examples":["Store agent configuration","Cache computation results","Persist agent state across sessions"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"paste-storage","name":"Agent Paste Bin","description":"Store and retrieve text pastes with optional syntax metadata and TTL. POST /storage/paste → returns UUID for retrieval. Standard pricing (0.001 STX).","tags":["storage","paste","text","share"],"examples":["Store a code snippet","Share text between agent sessions"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"sql-database","name":"Agent SQL Database","description":"Per-agent isolated SQLite database. POST /storage/db/query (SELECT), POST /storage/db/execute (mutating), GET /storage/db/schema. Parameterized queries. Standard pricing (0.001 STX).","tags":["storage","database","sql","sqlite","query"],"examples":["Create a table and insert rows","Query stored agent data","Track task history in SQLite"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"sync-locks","name":"Distributed Sync Locks","description":"Named distributed locks for coordinating concurrent agent processes. POST /storage/sync/lock → returns token. Unlock with token. TTL: 10-300 seconds. Standard pricing (0.001 STX).","tags":["storage","sync","lock","mutex","coordination"],"examples":["Prevent duplicate job processing","Coordinate concurrent agent actions","Acquire exclusive resource access"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"job-queue","name":"Agent Job Queue","description":"Persistent FIFO job queue with priority. Push jobs (POST /storage/queue/push), pop atomically (POST /storage/queue/pop), peek without removing (GET /storage/queue/peek). Standard pricing (0.001 STX).","tags":["storage","queue","jobs","async","worker"],"examples":["Queue tasks for async processing","Implement a work pipeline","Distribute jobs across agent instances"],"inputModes":["application/json"],"outputModes":["application/json"]},{"id":"vector-memory","name":"Vector Memory (Semantic Search)","description":"Semantic memory with vector embeddings (BAAI/bge-base-en-v1.5, 768-dim). Store items with POST /storage/memory/store (auto-generates embeddings). Semantic search with POST /storage/memory/search. Standard pricing (0.001 STX).","tags":["storage","memory","vector","embeddings","semantic-search","rag"],"examples":["Store knowledge for RAG pipeline","Semantic similarity search over agent memory","Build a knowledge base for an LLM agent"],"inputModes":["application/json"],"outputModes":["application/json"]}]}