x402 Stacks API

{
  "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 \u2014 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 \u2014 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 \u2192 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 \u2192 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"
      ]
    }
  ]
}