🚀 Quick Start for Agents

1. Search: GET /api/v1/agent/search/?q=weather&limit=10
2. Get tool spec: GET /api/v1/agent/tool/{slug}/spec/
3. Dynamic tool: GET /api/v1/agent/dynamic-tool/?q=get%20xrp%20price
4. Register for key: POST /api/v1/agent/register/
5. Pay with XRP → use X-API-Key header

Core Agent Endpoints (All return rich JSON + x402)

Base: https://api.inventingenius.com

# Search catalog (returns 402 if no key)
GET /api/v1/agent/search/?q=finance&limit=20&category=crypto

# Tool specs for Hermes / LangChain / OpenAI
GET /api/v1/agent/tools/search/?q=price
GET /api/v1/agent/tool/accuweather/spec/
GET /api/v1/agent/dynamic-tool/?q=fetch%20solana%20price%20and%20convert

# Discovery
GET /api/v1/agent/categories/
GET /api/v1/agent/random/
GET /api/v1/agent/feed.json/

# Payments & Registration (x402 v2.0)
POST /api/v1/agent/register/         # One-step: email + tier → wallet + tag
POST /api/v1/webhook/create/         # Create XRP invoice
POST /api/v1/webhook/verify/         # Verify tx_hash → key

# Proxy (recommended)
POST /api/v1/agent/proxy/{slug}/call/
        

x402 Payment & ASTEROID Tier (Accurate)

ASTEROID tier: 300 calls/day. No key needed for limited access.

# Example 402 response
{
  "error": "API key required",
  "protocol": "x402",
  "xrp_payment": {
    "wallet_address": "r4UHdyL4hp5UTiYMJYLq6M7N3gBswPro2G",
    "per_call": {"xrp": 0.5, "fiat": 0.25},
    "subscription_tiers": {
      "free": {"xrp": 0, "fiat": 0, "calls_per_day": 300},
      "basic": {"xrp": 10, "fiat": 9.99, "calls_per_day": 100},
      "pro": {"xrp": 30, "fiat": 29.99, "calls_per_day": 1000},
      "enterprise": {"xrp": 100, "fiat": 99.99, "calls_per_day": -1}
    }
  }
}
        

OpenAPI & Hermes Ready

GET /openapi.json — Full OpenAPI 3.0 for auto-SDK generation.

GET /llms.txt — This document optimized for LLMs/agents.

📦 Agent Bootstrap Skill — Handle 402s Autonomously

Download the official SKILL.md and your agent can handle x402 payments end-to-end: generate wallets, register, fund via XRPL, submit presigned payments through the t54.ai facilitator, and retry requests — all with minimal human help.

# Download the bootstrap skill
curl -s -o ~/skills/inventingenius-x402-xrpl/SKILL.md https://api.inventingenius.com/api/v1/agent/skill/bootstrap/

# Install for Hermes
hermes skills reload

# Or for Claude Desktop / Cursor — just copy the file into your skills directory

Includes: Wallet creation · Registration · Balance checking · Payment via t54.ai facilitator · Auto-retry · Testnet-first safety · Human-in-the-loop funding prompts