{
  "openapi": "3.1.0",
  "info": {
    "title": "AmanChain x402 Agent API",
    "version": "2.20.0",
    "description": "Quantum-resistant (ML-DSA-87 + Ed25519) proof-of-work blockchain with an AI agent marketplace:\n45 node-operated paid services, callable by any AI agent over plain HTTP.\n\nNo account, no API key — payment IS authentication (x402: HTTP 402 → pay → replay with proof).\nNative rail settles in AMAN inside AmanChain PoW consensus (receipts mined into blocks); USDC rail settles on Base through the Coinbase facilitator.\nLive AMAN price: $0.62207056 (on-chain AMM).\n\nHuman-readable catalog: https://preview-chat-c6089071-758a-449d-b4a7-6fa19ebc955c.space-z.ai/agents · LLM index: https://preview-chat-c6089071-758a-449d-b4a7-6fa19ebc955c.space-z.ai/llms.txt · MCP: POST https://preview-chat-c6089071-758a-449d-b4a7-6fa19ebc955c.space-z.ai/api/mcp?net=mainnet",
    "x-aman-chain-id": 1,
    "x-aman-network": "amanchain-mainnet"
  },
  "servers": [
    {
      "url": "https://preview-chat-c6089071-758a-449d-b4a7-6fa19ebc955c.space-z.ai"
    }
  ],
  "tags": [
    {
      "name": "x402",
      "description": "Payment protocol endpoints"
    },
    {
      "name": "chain",
      "description": "Chain data & transactions"
    },
    {
      "name": "audit",
      "description": "audit services"
    },
    {
      "name": "compute",
      "description": "compute services"
    },
    {
      "name": "pricing",
      "description": "pricing services"
    },
    {
      "name": "market-data",
      "description": "market-data services"
    },
    {
      "name": "portfolio",
      "description": "portfolio services"
    },
    {
      "name": "utility",
      "description": "utility services"
    },
    {
      "name": "oracle",
      "description": "oracle services"
    },
    {
      "name": "compliance",
      "description": "compliance services"
    },
    {
      "name": "analytics",
      "description": "analytics services"
    },
    {
      "name": "trading",
      "description": "trading services"
    },
    {
      "name": "reports",
      "description": "reports services"
    },
    {
      "name": "staking-calculator",
      "description": "staking-calculator services"
    },
    {
      "name": "whale-watch",
      "description": "whale-watch services"
    },
    {
      "name": "explorer",
      "description": "explorer services"
    },
    {
      "name": "bridge",
      "description": "bridge services"
    },
    {
      "name": "search",
      "description": "search services"
    }
  ],
  "components": {
    "responses": {
      "PaymentRequired": {
        "description": "x402 quote — pay one of the accepts[] options, then replay with proof",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "x402": {
                  "type": "boolean",
                  "const": true
                },
                "error": {
                  "type": "string",
                  "example": "Payment Required"
                },
                "accepts": {
                  "type": "array",
                  "description": "Payment options. scheme=aman-x402 → native AMAN rail; scheme=exact + network=base → USDC rail (EIP-3009).",
                  "items": {
                    "type": "object"
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "paths": {
    "/api/x402": {
      "post": {
        "operationId": "x402_quote_or_settle",
        "summary": "Get a price quote (402) or settle+execute for any service",
        "description": "POST with {\"serviceId\":\"<id>\"} returns HTTP 402 with an accepts[] price quote.\nPOST with {\"serviceId\":\"<id>\",\"payment\":{\"txId\":\"<txid>\"}} verifies the real on-chain AMAN payment, executes the service and returns the result + receipt.\nServices are also directly addressable at /api/x402/{serviceId} (the canonical URLs listed in the public x402 Bazaar).",
        "tags": [
          "x402"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "serviceId"
                ],
                "properties": {
                  "serviceId": {
                    "type": "string",
                    "example": "aman-crypto-price"
                  },
                  "request": {
                    "type": "string",
                    "description": "Service input (see each service endpoint for its expected format)"
                  },
                  "payment": {
                    "type": "object",
                    "description": "Present only when settling after paying. Absent = quote-only (402).",
                    "properties": {
                      "txId": {
                        "type": "string",
                        "description": "AmanChain transaction id of the agent_invoke payment"
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + on-chain receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "paid": {
                      "type": "boolean"
                    },
                    "result": {},
                    "receipt": {
                      "type": "object",
                      "properties": {
                        "serviceId": {
                          "type": "string"
                        },
                        "caller": {
                          "type": "string"
                        },
                        "amount": {
                          "type": "number"
                        },
                        "txId": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/v1/tx": {
      "post": {
        "operationId": "broadcast_transaction",
        "summary": "Broadcast a signed AmanChain transaction (e.g. the agent_invoke payment)",
        "tags": [
          "chain"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "description": "Signed AmanChain transaction envelope (agent_invoke for x402 AMAN payments)"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Accepted into mempool — wait ~3s for the block, then settle via /api/x402"
          }
        }
      }
    },
    "/api/x402/aman-token-audit": {
      "post": {
        "operationId": "aman_token_audit",
        "summary": "Token Risk Audit",
        "description": "Full on-chain audit of a token: collateral backing %, frozen/hidden flags, holder count, pool depth, deterministic risk flags.\n\n**Request format:** token symbol, e.g. \"USDT\" (required)\n**Price:** 0.25 AMAN (≈$0.155518) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "audit"
        ],
        "x-price-aman": 0.25,
        "x-price-usd": 0.155518,
        "x-service-id": "aman-token-audit",
        "x-proven-calls": 7,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "token symbol, e.g. \"USDT\""
                  }
                },
                "example": {
                  "request": "token symbol, \"USDT\""
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-image-gen": {
      "post": {
        "operationId": "aman_image_gen",
        "summary": "AI Image Generation",
        "description": "Generate a 1024x1024 PNG image from any text prompt, returned as base64 — illustrations on demand for agent workflows.\n\n**Request format:** image description prompt (required)\n**Price:** 0.05 AMAN (≈$0.031104) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "compute"
        ],
        "x-price-aman": 0.05,
        "x-price-usd": 0.031104,
        "x-service-id": "aman-image-gen",
        "x-proven-calls": 22,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "image description prompt"
                  }
                },
                "example": {
                  "request": "image description prompt"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-price-feed": {
      "post": {
        "operationId": "aman_price_feed",
        "summary": "AMAN Price Feed",
        "description": "Returns the live AMAN price from the deepest real AMM pool, with 24h change, TVL and volume.\n\n**Request format:** optional context (optional — may be empty)\n**Price:** 0.05 AMAN (≈$0.031104) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "pricing"
        ],
        "x-price-aman": 0.05,
        "x-price-usd": 0.031104,
        "x-service-id": "aman-price-feed",
        "x-proven-calls": 21,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "optional context"
                  }
                },
                "example": {
                  "request": ""
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-market-summary": {
      "post": {
        "operationId": "aman_market_summary",
        "summary": "Market Summary",
        "description": "Live market snapshot: AMAN price, TVL, 24h volume, top pools with reserves and the latest executed swaps.\n\n**Request format:** optional context (optional — may be empty)\n**Price:** 0.15 AMAN (≈$0.093311) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "market-data"
        ],
        "x-price-aman": 0.15,
        "x-price-usd": 0.093311,
        "x-service-id": "aman-market-summary",
        "x-proven-calls": 5,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "optional context"
                  }
                },
                "example": {
                  "request": ""
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-wallet-portfolio": {
      "post": {
        "operationId": "aman_wallet_portfolio",
        "summary": "Wallet Portfolio",
        "description": "Complete portfolio for any address: balance, stake, LP positions, token holdings and USD valuation at live pool prices.\n\n**Request format:** AmanChain address (required)\n**Price:** 0.1 AMAN (≈$0.062207) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "portfolio"
        ],
        "x-price-aman": 0.1,
        "x-price-usd": 0.062207,
        "x-service-id": "aman-wallet-portfolio",
        "x-proven-calls": 1,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "AmanChain address"
                  }
                },
                "example": {
                  "request": "AmanChain address"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-address-validator": {
      "post": {
        "operationId": "aman_address_validator",
        "summary": "Address Validator",
        "description": "Validate any address across AmanChain + all bridge networks (Solana, EVM, BTC, LTC).\n\n**Request format:** optional context (required)\n**Price:** 0.02 AMAN (≈$0.012441) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "utility"
        ],
        "x-price-aman": 0.02,
        "x-price-usd": 0.012441,
        "x-service-id": "aman-address-validator",
        "x-proven-calls": 1,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "optional context"
                  }
                },
                "example": {
                  "request": ""
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-crypto-prices": {
      "post": {
        "operationId": "aman_crypto_prices",
        "summary": "Live Crypto Prices",
        "description": "Live external BTC/ETH/SOL/BNB/LTC prices (multi-source feed) plus the on-chain AMAN price and global market cap.\n\n**Request format:** optional context (optional — may be empty)\n**Price:** 0.1 AMAN (≈$0.062207) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "pricing"
        ],
        "x-price-aman": 0.1,
        "x-price-usd": 0.062207,
        "x-service-id": "aman-crypto-prices",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "optional context"
                  }
                },
                "example": {
                  "request": ""
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-network-stats": {
      "post": {
        "operationId": "aman_network_stats",
        "summary": "Network Statistics",
        "description": "Height, hashrate, supply minted/burned, staking ratio, transaction totals and mempool — all from consensus.\n\n**Request format:** optional context (optional — may be empty)\n**Price:** 0.05 AMAN (≈$0.031104) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "oracle"
        ],
        "x-price-aman": 0.05,
        "x-price-usd": 0.031104,
        "x-service-id": "aman-network-stats",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "optional context"
                  }
                },
                "example": {
                  "request": ""
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-gas-tracker": {
      "post": {
        "operationId": "aman_gas_tracker",
        "summary": "Fee & Gas Tracker",
        "description": "Mempool pressure, average fees over the last 20 blocks, burn rate and congestion level.\n\n**Request format:** optional context (optional — may be empty)\n**Price:** 0.05 AMAN (≈$0.031104) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "oracle"
        ],
        "x-price-aman": 0.05,
        "x-price-usd": 0.031104,
        "x-service-id": "aman-gas-tracker",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "optional context"
                  }
                },
                "example": {
                  "request": ""
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-stable-health": {
      "post": {
        "operationId": "aman_stable_health",
        "summary": "Stablecoin Health",
        "description": "Collateral backing %, redeemable supply and health flag for every on-chain stablecoin.\n\n**Request format:** optional context (optional — may be empty)\n**Price:** 0.15 AMAN (≈$0.093311) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "audit"
        ],
        "x-price-aman": 0.15,
        "x-price-usd": 0.093311,
        "x-service-id": "aman-stable-health",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "optional context"
                  }
                },
                "example": {
                  "request": ""
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-supply-audit": {
      "post": {
        "operationId": "aman_supply_audit",
        "summary": "Token Supply Audit",
        "description": "Minted, burned, max-supply headroom, holder count and issuer balance for any token (or all).\n\n**Request format:** token symbol or pool (optional — may be empty)\n**Price:** 0.1 AMAN (≈$0.062207) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "audit"
        ],
        "x-price-aman": 0.1,
        "x-price-usd": 0.062207,
        "x-service-id": "aman-supply-audit",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "token symbol or pool"
                  }
                },
                "example": {
                  "request": "token symbol or pool"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-token-launch-check": {
      "post": {
        "operationId": "aman_token_launch_check",
        "summary": "Token Launch Check",
        "description": "Pre-flight validation of a new token against the real consensus rules — before paying the deployment fee.\n\n**Request format:** SYMBOL|Name|decimals|maxSupply (required)\n**Price:** 0.1 AMAN (≈$0.062207) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "compliance"
        ],
        "x-price-aman": 0.1,
        "x-price-usd": 0.062207,
        "x-service-id": "aman-token-launch-check",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "SYMBOL|Name|decimals|maxSupply"
                  }
                },
                "example": {
                  "request": "SYMBOL|Name|decimals|maxSupply"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-pool-analytics": {
      "post": {
        "operationId": "aman_pool_analytics",
        "summary": "Pool Analytics",
        "description": "Reserves, TVL, volume, LP APR estimate and a five-size price-impact table for any pool.\n\n**Request format:** token symbol or pool (optional — may be empty)\n**Price:** 0.15 AMAN (≈$0.093311) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "analytics"
        ],
        "x-price-aman": 0.15,
        "x-price-usd": 0.093311,
        "x-service-id": "aman-pool-analytics",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "token symbol or pool"
                  }
                },
                "example": {
                  "request": "token symbol or pool"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-swap-quote": {
      "post": {
        "operationId": "aman_swap_quote",
        "summary": "Swap Quote",
        "description": "Exact AMM quote for any pair, e.g. \"100 AMAN->USDT\" — outcome, price impact and fees before you sign.\n\n**Request format:** \"100 AMAN->USDT\" (amount pair) (required)\n**Price:** 0.05 AMAN (≈$0.031104) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "trading"
        ],
        "x-price-aman": 0.05,
        "x-price-usd": 0.031104,
        "x-service-id": "aman-swap-quote",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "\"100 AMAN->USDT\" (amount pair)"
                  }
                },
                "example": {
                  "request": "\"100 AMAN->USDT\" (amount pair)"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-price-history": {
      "post": {
        "operationId": "aman_price_history",
        "summary": "Price History OHLC",
        "description": "Hourly OHLC candles built from executed swap prices over the real trading history.\n\n**Request format:** optional context (optional — may be empty)\n**Price:** 0.15 AMAN (≈$0.093311) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "market-data"
        ],
        "x-price-aman": 0.15,
        "x-price-usd": 0.093311,
        "x-service-id": "aman-price-history",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "optional context"
                  }
                },
                "example": {
                  "request": ""
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-arb-scan": {
      "post": {
        "operationId": "aman_arb_scan",
        "summary": "Arbitrage Spread Scan",
        "description": "Cross-pool implied AMAN prices with the widest spot spread — honest about slippage caveats.\n\n**Request format:** optional context (optional — may be empty)\n**Price:** 0.2 AMAN (≈$0.124414) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "trading"
        ],
        "x-price-aman": 0.2,
        "x-price-usd": 0.124414,
        "x-service-id": "aman-arb-scan",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "optional context"
                  }
                },
                "example": {
                  "request": ""
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-market-report": {
      "post": {
        "operationId": "aman_market_report",
        "summary": "Full Market Report",
        "description": "Composite markdown report: price, TVL, volume, pools, stablecoin health and external majors.\n\n**Request format:** optional context (optional — may be empty)\n**Price:** 0.5 AMAN (≈$0.311035) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "reports"
        ],
        "x-price-aman": 0.5,
        "x-price-usd": 0.311035,
        "x-service-id": "aman-market-report",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "optional context"
                  }
                },
                "example": {
                  "request": ""
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-holder-stats": {
      "post": {
        "operationId": "aman_holder_stats",
        "summary": "Holder Distribution",
        "description": "Holder count, top-10 concentration, HHI index and the largest wallets for any token.\n\n**Request format:** token symbol or pool (optional — may be empty)\n**Price:** 0.2 AMAN (≈$0.124414) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "analytics"
        ],
        "x-price-aman": 0.2,
        "x-price-usd": 0.124414,
        "x-service-id": "aman-holder-stats",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "token symbol or pool"
                  }
                },
                "example": {
                  "request": "token symbol or pool"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-staking-rewards": {
      "post": {
        "operationId": "aman_staking_rewards",
        "summary": "Staking Rewards Calculator",
        "description": "Projected daily/monthly/yearly rewards across the real consensus APR tiers for any amount.\n\n**Request format:** amount, e.g. \"1000\" (required)\n**Price:** 0.1 AMAN (≈$0.062207) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "staking-calculator"
        ],
        "x-price-aman": 0.1,
        "x-price-usd": 0.062207,
        "x-service-id": "aman-staking-rewards",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "amount, e.g. \"1000\""
                  }
                },
                "example": {
                  "request": "amount, \"1000\""
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-whale-watch": {
      "post": {
        "operationId": "aman_whale_watch",
        "summary": "Whale Watch",
        "description": "Large-transfer scanner over real blocks — pass a threshold, e.g. \"5000\".\n\n**Request format:** threshold in AMAN, e.g. \"5000\" (optional — may be empty)\n**Price:** 0.2 AMAN (≈$0.124414) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "whale-watch"
        ],
        "x-price-aman": 0.2,
        "x-price-usd": 0.124414,
        "x-service-id": "aman-whale-watch",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "threshold in AMAN, e.g. \"5000\""
                  }
                },
                "example": {
                  "request": "threshold in AMAN, \"5000\""
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-tx-lookup": {
      "post": {
        "operationId": "aman_tx_lookup",
        "summary": "Transaction Lookup",
        "description": "Find and decode any transaction by id — status, payload, quantum-shield signature check.\n\n**Request format:** transaction id (required)\n**Price:** 0.05 AMAN (≈$0.031104) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "explorer"
        ],
        "x-price-aman": 0.05,
        "x-price-usd": 0.031104,
        "x-service-id": "aman-tx-lookup",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "transaction id"
                  }
                },
                "example": {
                  "request": "transaction id"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-block-inspect": {
      "post": {
        "operationId": "aman_block_inspect",
        "summary": "Block Inspector",
        "description": "Full inspection of any block by height or hash — PoW facts, fees burned and tx mix.\n\n**Request format:** block height or hash (required)\n**Price:** 0.05 AMAN (≈$0.031104) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "explorer"
        ],
        "x-price-aman": 0.05,
        "x-price-usd": 0.031104,
        "x-service-id": "aman-block-inspect",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "block height or hash"
                  }
                },
                "example": {
                  "request": "block height or hash"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-explorer-summary": {
      "post": {
        "operationId": "aman_explorer_summary",
        "summary": "Explorer Summary",
        "description": "Recent blocks, transaction-type distribution, mempool size and supply effects at a glance.\n\n**Request format:** optional context (optional — may be empty)\n**Price:** 0.05 AMAN (≈$0.031104) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "explorer"
        ],
        "x-price-aman": 0.05,
        "x-price-usd": 0.031104,
        "x-service-id": "aman-explorer-summary",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "optional context"
                  }
                },
                "example": {
                  "request": ""
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-bridge-status": {
      "post": {
        "operationId": "aman_bridge_status",
        "summary": "Bridge Status",
        "description": "The 10 bridge networks with vault addresses, custody floats, fee and record counts.\n\n**Request format:** optional context (optional — may be empty)\n**Price:** 0.1 AMAN (≈$0.062207) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "bridge"
        ],
        "x-price-aman": 0.1,
        "x-price-usd": 0.062207,
        "x-service-id": "aman-bridge-status",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "optional context"
                  }
                },
                "example": {
                  "request": ""
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-agent-roster": {
      "post": {
        "operationId": "aman_agent_roster",
        "summary": "Agent Roster",
        "description": "All registered agents with capabilities, proven call counts and volume.\n\n**Request format:** optional context (optional — may be empty)\n**Price:** 0.05 AMAN (≈$0.031104) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "search"
        ],
        "x-price-aman": 0.05,
        "x-price-usd": 0.031104,
        "x-service-id": "aman-agent-roster",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "optional context"
                  }
                },
                "example": {
                  "request": ""
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-service-search": {
      "post": {
        "operationId": "aman_service_search",
        "summary": "Service Search",
        "description": "Keyword search over the live service registry — prices in AMAN and USD, ready to invoke via x402.\n\n**Request format:** keyword or capability (required)\n**Price:** 0.02 AMAN (≈$0.012441) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "search"
        ],
        "x-price-aman": 0.02,
        "x-price-usd": 0.012441,
        "x-service-id": "aman-service-search",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "keyword or capability"
                  }
                },
                "example": {
                  "request": "keyword or capability"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-web-fetch": {
      "post": {
        "operationId": "aman_web_fetch",
        "summary": "Fetch Web Page as Text",
        "description": "Fetch any public URL and return clean readable text with the HTML stripped — status, content-type and byte size included. The classic agent need: read a web page over HTTP.\n\n**Request format:** public URL, e.g. \"https://example.com\" (required)\n**Price:** 0.01 AMAN (≈$0.006221) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "compute"
        ],
        "x-price-aman": 0.01,
        "x-price-usd": 0.006221,
        "x-service-id": "aman-web-fetch",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "public URL, e.g. \"https://example.com\""
                  }
                },
                "example": {
                  "request": "public URL, \"https://example.com\""
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-url-meta": {
      "post": {
        "operationId": "aman_url_meta",
        "summary": "URL Metadata Extract",
        "description": "Extract a URL title, meta description, Open Graph image, canonical link and site name — link previews and scraping groundwork.\n\n**Request format:** public URL (required)\n**Price:** 0.008 AMAN (≈$0.004977) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "compute"
        ],
        "x-price-aman": 0.008,
        "x-price-usd": 0.004977,
        "x-service-id": "aman-url-meta",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "public URL"
                  }
                },
                "example": {
                  "request": "public URL"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-web-search": {
      "post": {
        "operationId": "aman_web_search",
        "summary": "Live Web Search",
        "description": "Search the live web for any query: top results with title, URL, snippet, host and date. Real search-engine results for research agents.\n\n**Request format:** search query, e.g. \"x402 payments\" (required)\n**Price:** 0.015 AMAN (≈$0.009331) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "search"
        ],
        "x-price-aman": 0.015,
        "x-price-usd": 0.009331,
        "x-service-id": "aman-web-search",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "search query, e.g. \"x402 payments\""
                  }
                },
                "example": {
                  "request": "search query, \"x402 payments\""
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-rss-read": {
      "post": {
        "operationId": "aman_rss_read",
        "summary": "RSS / Atom Feed Reader",
        "description": "Parse any RSS or Atom feed into clean items: title, link, date and summary. News and monitoring pipelines for agents.\n\n**Request format:** RSS/Atom feed URL (required)\n**Price:** 0.005 AMAN (≈$0.00311) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "compute"
        ],
        "x-price-aman": 0.005,
        "x-price-usd": 0.00311,
        "x-service-id": "aman-rss-read",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "RSS/Atom feed URL"
                  }
                },
                "example": {
                  "request": "RSS/Atom feed URL"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-domain-info": {
      "post": {
        "operationId": "aman_domain_info",
        "summary": "Domain RDAP Lookup",
        "description": "Registry lookup for any domain via RDAP: registrar, registration and expiry dates, nameservers and lifecycle status.\n\n**Request format:** domain name, e.g. \"example.com\" (required)\n**Price:** 0.005 AMAN (≈$0.00311) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "reports"
        ],
        "x-price-aman": 0.005,
        "x-price-usd": 0.00311,
        "x-service-id": "aman-domain-info",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "domain name, e.g. \"example.com\""
                  }
                },
                "example": {
                  "request": "domain name, \"example.com\""
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-geo-ip": {
      "post": {
        "operationId": "aman_geo_ip",
        "summary": "IP Geolocation",
        "description": "Geolocate any IP address: country, city, latitude/longitude, ASN, ISP organization and timezone.\n\n**Request format:** IP address, e.g. \"8.8.8.8\" (required)\n**Price:** 0.003 AMAN (≈$0.001866) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "compute"
        ],
        "x-price-aman": 0.003,
        "x-price-usd": 0.001866,
        "x-service-id": "aman-geo-ip",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "IP address, e.g. \"8.8.8.8\""
                  }
                },
                "example": {
                  "request": "IP address, \"8.8.8.8\""
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-weather": {
      "post": {
        "operationId": "aman_weather",
        "summary": "Weather Now + Forecast",
        "description": "Current weather plus a 3-day forecast for any city or lat,lon: temperature, humidity, wind and conditions (Open-Meteo live data).\n\n**Request format:** city or \"lat,lon\", e.g. \"Riyadh\" (required)\n**Price:** 0.003 AMAN (≈$0.001866) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "reports"
        ],
        "x-price-aman": 0.003,
        "x-price-usd": 0.001866,
        "x-service-id": "aman-weather",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "city or \"lat,lon\", e.g. \"Riyadh\""
                  }
                },
                "example": {
                  "request": "city or \"lat,lon\", \"Riyadh\""
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-world-clock": {
      "post": {
        "operationId": "aman_world_clock",
        "summary": "World Clock / Timezone",
        "description": "Exact current time for any IANA timezone with UTC offset, plus date and ISO timestamp — scheduling agents depend on it.\n\n**Request format:** IANA timezone, e.g. \"Asia/Riyadh\" (required)\n**Price:** 0.002 AMAN (≈$0.001244) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "utility"
        ],
        "x-price-aman": 0.002,
        "x-price-usd": 0.001244,
        "x-service-id": "aman-world-clock",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "IANA timezone, e.g. \"Asia/Riyadh\""
                  }
                },
                "example": {
                  "request": "IANA timezone, \"Asia/Riyadh\""
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-fx-rates": {
      "post": {
        "operationId": "aman_fx_rates",
        "summary": "Fiat Exchange Rates",
        "description": "Live fiat FX rates: convert any amount between 30+ currencies (ECB reference data) or list rates for a base currency.\n\n**Request format:** \"100 USD to EUR\" or a base currency like \"USD\" (required)\n**Price:** 0.002 AMAN (≈$0.001244) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "market-data"
        ],
        "x-price-aman": 0.002,
        "x-price-usd": 0.001244,
        "x-service-id": "aman-fx-rates",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "\"100 USD to EUR\" or a base currency like \"USD\""
                  }
                },
                "example": {
                  "request": "\"100 USD to EUR\" or a base currency like \"USD\""
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-email-validate": {
      "post": {
        "operationId": "aman_email_validate",
        "summary": "Email Validation + MX",
        "description": "Validate an email address: syntax, real DNS MX records for the domain, and disposable-provider detection.\n\n**Request format:** email address (required)\n**Price:** 0.002 AMAN (≈$0.001244) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "utility"
        ],
        "x-price-aman": 0.002,
        "x-price-usd": 0.001244,
        "x-service-id": "aman-email-validate",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "email address"
                  }
                },
                "example": {
                  "request": "email address"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-llm-chat": {
      "post": {
        "operationId": "aman_llm_chat",
        "summary": "AI Text Generation",
        "description": "General-purpose LLM completion for any prompt: drafting, answering, reasoning, code help — the most-requested agent capability anywhere.\n\n**Request format:** any prompt text (required)\n**Price:** 0.02 AMAN (≈$0.012441) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "compute"
        ],
        "x-price-aman": 0.02,
        "x-price-usd": 0.012441,
        "x-service-id": "aman-llm-chat",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "any prompt text"
                  }
                },
                "example": {
                  "request": "any prompt text"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-translate": {
      "post": {
        "operationId": "aman_translate",
        "summary": "Translate Text",
        "description": "Translate text into 20+ languages with natural quality. Request format: \"ar|Hello world\" (target language, then the text).\n\n**Request format:** \"ar|Hello world\" (targetLang|text) (required)\n**Price:** 0.015 AMAN (≈$0.009331) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "compute"
        ],
        "x-price-aman": 0.015,
        "x-price-usd": 0.009331,
        "x-service-id": "aman-translate",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "\"ar|Hello world\" (targetLang|text)"
                  }
                },
                "example": {
                  "request": "\"ar|Hello world\" (targetLang|text)"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-summarize": {
      "post": {
        "operationId": "aman_summarize",
        "summary": "Summarize Text or URL",
        "description": "Summarize any raw text or fetch a URL and return a TL;DR plus 3-5 key points — research and briefing workflows.\n\n**Request format:** text (80+ chars) or a URL (required)\n**Price:** 0.01 AMAN (≈$0.006221) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "compute"
        ],
        "x-price-aman": 0.01,
        "x-price-usd": 0.006221,
        "x-service-id": "aman-summarize",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "text (80+ chars) or a URL"
                  }
                },
                "example": {
                  "request": "text (80+ chars) or a URL"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-sentiment": {
      "post": {
        "operationId": "aman_sentiment",
        "summary": "Sentiment Analysis",
        "description": "Sentiment, polarity score, confidence and emotion labels for any text — social listening and review mining.\n\n**Request format:** text to analyze (required)\n**Price:** 0.005 AMAN (≈$0.00311) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "analytics"
        ],
        "x-price-aman": 0.005,
        "x-price-usd": 0.00311,
        "x-service-id": "aman-sentiment",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "text to analyze"
                  }
                },
                "example": {
                  "request": "text to analyze"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-keywords": {
      "post": {
        "operationId": "aman_keywords",
        "summary": "Keyword & Entity Extraction",
        "description": "Extract keywords, named entities and topics from any text — SEO tags, indexing and content analysis.\n\n**Request format:** text to analyze (required)\n**Price:** 0.005 AMAN (≈$0.00311) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "analytics"
        ],
        "x-price-aman": 0.005,
        "x-price-usd": 0.00311,
        "x-service-id": "aman-keywords",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "text to analyze"
                  }
                },
                "example": {
                  "request": "text to analyze"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-crypto-price": {
      "post": {
        "operationId": "aman_crypto_price",
        "summary": "Crypto Token Price",
        "description": "Live USD price with 24h change for any major crypto asset (BTC, ETH, SOL, BNB, LTC, AMAN) — extended reach via CoinGecko search.\n\n**Request format:** symbol, e.g. \"BTC\" (required)\n**Price:** 0.002 AMAN (≈$0.001244) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "pricing"
        ],
        "x-price-aman": 0.002,
        "x-price-usd": 0.001244,
        "x-service-id": "aman-crypto-price",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "symbol, e.g. \"BTC\""
                  }
                },
                "example": {
                  "request": "symbol, \"BTC\""
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-gas-price": {
      "post": {
        "operationId": "aman_gas_price",
        "summary": "EVM Gas Price",
        "description": "Live gas price on Base and Ethereum mainnet in gwei with a standard-transfer USD estimate — fee timing for agents.\n\n**Request format:** optional: \"base\" or \"ethereum\" (optional — may be empty)\n**Price:** 0.002 AMAN (≈$0.001244) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "pricing"
        ],
        "x-price-aman": 0.002,
        "x-price-usd": 0.001244,
        "x-service-id": "aman-gas-price",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "optional: \"base\" or \"ethereum\""
                  }
                },
                "example": {
                  "request": "optional: \"base\" or \"ethereum\""
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-evm-balance": {
      "post": {
        "operationId": "aman_evm_balance",
        "summary": "EVM Wallet Balance",
        "description": "Native ETH balance plus USDC balance of any EVM address on Base mainnet, read live from public RPC.\n\n**Request format:** EVM address 0x… (Base mainnet) (required)\n**Price:** 0.002 AMAN (≈$0.001244) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "portfolio"
        ],
        "x-price-aman": 0.002,
        "x-price-usd": 0.001244,
        "x-service-id": "aman-evm-balance",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "EVM address 0x… (Base mainnet)"
                  }
                },
                "example": {
                  "request": "EVM address 0x… (Base mainnet)"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    },
    "/api/x402/aman-ens-resolve": {
      "post": {
        "operationId": "aman_ens_resolve",
        "summary": "ENS Resolve",
        "description": "Resolve any ENS name to its Ethereum address (and reverse-resolve an address to its ENS name) with avatar when available.\n\n**Request format:** ENS name \"name.eth\" or 0x address (required)\n**Price:** 0.005 AMAN (≈$0.00311) — paid per call via x402.\n\n**Flow:** POST here with a JSON body → HTTP 402 + accepts[] quote. Two rails:\n1. Native AMAN: sign an agent_invoke for the exact price, broadcast via /api/v1/tx, then re-POST with {\"payment\":{\"txId\":\"<txid>\"}}.\n2. USDC on Base: pay the exact maxAmountRequired to the quoted payTo via EIP-3009 (gasless, Coinbase facilitator) using the X-PAYMENT header.\nExecution failure after payment triggers an automatic on-chain refund.",
        "tags": [
          "explorer"
        ],
        "x-price-aman": 0.005,
        "x-price-usd": 0.00311,
        "x-service-id": "aman-ens-resolve",
        "x-proven-calls": 0,
        "x-settlement": [
          "amanchain-mainnet (AMAN, on-chain consensus)",
          "base (USDC, EIP-3009 via Coinbase x402 facilitator)"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "request": {
                    "type": "string",
                    "description": "ENS name \"name.eth\" or 0x address"
                  }
                },
                "example": {
                  "request": "ENS name \"name.eth\" or 0x address"
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Paid result + receipt",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "$ref": "#/components/responses/PaymentRequired"
          }
        }
      }
    }
  }
}