{
  "openapi": "3.1.0",
  "info": {
    "title": "SanHao Global Experts",
    "version": "1.0.0",
    "description": "897 business skills for brand strategy, restaurant operations, marketing, video scripting and crisis PR. Paid per call via x402 — 0.01 USDC per call, settled on-chain on Base. No API keys required.",
    "contact": {
      "name": "SanHao Global Experts",
      "email": "454157727@qq.com"
    },
    "x-payment": {
      "x402Version": 2,
      "accepts": [
        {
          "scheme": "exact",
          "network": "eip155:8453",
          "amount": "10000",
          "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
          "payTo": "0x93215E03d66B49bA03c015B4f7c103dD102E39A7",
          "maxTimeoutSeconds": 120,
          "extra": {
            "name": "USDC",
            "version": "2"
          }
        }
      ]
    },
    "x-fiat-settlement": {
      "provider": "LianLian Global Acquiring",
      "accountType": "Hong Kong USD virtual account",
      "currency": "USD",
      "bankName": "OCBC Bank (HK) Limited",
      "bankLocation": "Hong Kong, China",
      "bankAddress": "161 Queen's Road Central, Central",
      "swiftBic": "WIHBHKHHXXX",
      "bankCode": "035",
      "branchCode": "888",
      "accountNumber": "888000205074961",
      "accountHolder": "SanHao Global Experts (Wu Peng)",
      "note": "Settlement account bound to LianLian Global Acquiring. Bank-transfer purchases require a proforma invoice first; unsolicited wires are not accepted.",
      "invoiceContact": "454157727@qq.com"
    }
  },
  "servers": [
    {
      "url": "https://sanhaoyoung821208-d5dv139af0958c.service.tcloudbase.com",
      "description": "SanHao Global Experts A2A / MCP gateway"
    }
  ],
  "paths": {
    "/a2a": {
      "get": {
        "summary": "x402 payment challenge — service discovery (GET returns HTTP 402)",
        "description": "Unpaid GET on this route returns HTTP 402 with the x402 challenge (scheme, network, asset, amount, payTo). Use POST for actual work. Send X-Expert-Tier: free on POST for the zero-cost methodology brief.",
        "x-payment": {
          "x402Version": 2,
          "accepts": [
            {
              "scheme": "exact",
              "network": "eip155:8453",
              "amount": "10000",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "payTo": "0x93215E03d66B49bA03c015B4f7c103dD102E39A7",
              "maxTimeoutSeconds": 120,
              "extra": {
                "name": "USDC",
                "version": "2"
              }
            }
          ]
        },
        "x-payment-info": {
          "x402Version": 2,
          "accepts": [
            {
              "scheme": "exact",
              "network": "eip155:8453",
              "amount": "10000",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "payTo": "0x93215E03d66B49bA03c015B4f7c103dD102E39A7",
              "maxTimeoutSeconds": 120,
              "extra": {
                "name": "USDC",
                "version": "2"
              }
            }
          ]
        },
        "parameters": [
          {
            "name": "query",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Optional natural-language task description used to scope the analysis."
          }
        ],
        "responses": {
          "200": {
            "description": "Service description (free)",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "description": "Payment required — x402 challenge",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      },
      "post": {
        "summary": "A2A v1.0 message/send — run a paid skill analysis",
        "description": "Send an A2A message. Unpaid requests receive HTTP 402 with an x402 challenge; pay 0.01 USDC on Base and retry with the PAYMENT-SIGNATURE header to receive the finished deliverable. Send X-Expert-Tier: free for the zero-cost methodology brief.",
        "x-payment": {
          "x402Version": 2,
          "accepts": [
            {
              "scheme": "exact",
              "network": "eip155:8453",
              "amount": "10000",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "payTo": "0x93215E03d66B49bA03c015B4f7c103dD102E39A7",
              "maxTimeoutSeconds": 120,
              "extra": {
                "name": "USDC",
                "version": "2"
              }
            }
          ]
        },
        "x-payment-info": {
          "x402Version": 2,
          "accepts": [
            {
              "scheme": "exact",
              "network": "eip155:8453",
              "amount": "10000",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "payTo": "0x93215E03d66B49bA03c015B4f7c103dD102E39A7",
              "maxTimeoutSeconds": 120,
              "extra": {
                "name": "USDC",
                "version": "2"
              }
            }
          ]
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "jsonrpc": {
                    "type": "string"
                  },
                  "id": {
                    "type": "string"
                  },
                  "method": {
                    "type": "string",
                    "enum": [
                      "message/send",
                      "message/stream"
                    ]
                  },
                  "params": {
                    "type": "object"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Task result (analysis artifact)",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "description": "Payment required — x402 challenge",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/a2a/mcp": {
      "get": {
        "summary": "x402 payment challenge — MCP endpoint discovery (GET returns HTTP 402)",
        "description": "Unpaid GET on this MCP route returns HTTP 402 with the x402 challenge. Use POST for JSON-RPC (initialize / tools/list / tools/call). tools/list is free; tools/call on the paid tier returns the deliverable.",
        "x-payment": {
          "x402Version": 2,
          "accepts": [
            {
              "scheme": "exact",
              "network": "eip155:8453",
              "amount": "10000",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "payTo": "0x93215E03d66B49bA03c015B4f7c103dD102E39A7",
              "maxTimeoutSeconds": 120,
              "extra": {
                "name": "USDC",
                "version": "2"
              }
            }
          ]
        },
        "x-payment-info": {
          "x402Version": 2,
          "accepts": [
            {
              "scheme": "exact",
              "network": "eip155:8453",
              "amount": "10000",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "payTo": "0x93215E03d66B49bA03c015B4f7c103dD102E39A7",
              "maxTimeoutSeconds": 120,
              "extra": {
                "name": "USDC",
                "version": "2"
              }
            }
          ]
        },
        "parameters": [
          {
            "name": "tool",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Optional tool slug to describe (one of 897)."
          }
        ],
        "responses": {
          "200": {
            "description": "Endpoint description (free)",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "description": "Payment required — x402 challenge",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      },
      "post": {
        "summary": "MCP tools/call — 897 paid tools over Streamable HTTP",
        "description": "MCP JSON-RPC endpoint. tools/list returns all 897 tools (12 flagship experts + 885 long-tail playbooks). tools/call on a paid tier returns the finished deliverable; free tier returns the brief only.",
        "x-payment": {
          "x402Version": 2,
          "accepts": [
            {
              "scheme": "exact",
              "network": "eip155:8453",
              "amount": "10000",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "payTo": "0x93215E03d66B49bA03c015B4f7c103dD102E39A7",
              "maxTimeoutSeconds": 120,
              "extra": {
                "name": "USDC",
                "version": "2"
              }
            }
          ]
        },
        "x-payment-info": {
          "x402Version": 2,
          "accepts": [
            {
              "scheme": "exact",
              "network": "eip155:8453",
              "amount": "10000",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "payTo": "0x93215E03d66B49bA03c015B4f7c103dD102E39A7",
              "maxTimeoutSeconds": 120,
              "extra": {
                "name": "USDC",
                "version": "2"
              }
            }
          ]
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "jsonrpc": {
                    "type": "string"
                  },
                  "id": {
                    "type": "string"
                  },
                  "method": {
                    "type": "string",
                    "enum": [
                      "tools/list",
                      "tools/call"
                    ]
                  },
                  "params": {
                    "type": "object"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "MCP result",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "description": "Payment required — x402 challenge",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/a2a/deep": {
      "get": {
        "summary": "x402 payment challenge — deep-dive report (GET returns HTTP 402)",
        "description": "Premium tier for human buyers: a full consulting-grade deep-dive report (1200+ words, prioritised action plan, 30/60/90-day roadmap). Unpaid GET returns HTTP 402 with the x402 challenge. Use POST to place the order. Standard tier (0.01 USDC) stays available on /a2a for agents.",
        "x-payment": {
          "x402Version": 2,
          "accepts": [
            {
              "scheme": "exact",
              "network": "eip155:8453",
              "amount": "290000",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "payTo": "0x93215E03d66B49bA03c015B4f7c103dD102E39A7",
              "maxTimeoutSeconds": 120,
              "extra": {
                "name": "USDC",
                "version": "2"
              }
            }
          ]
        },
        "x-payment-info": {
          "x402Version": 2,
          "accepts": [
            {
              "scheme": "exact",
              "network": "eip155:8453",
              "amount": "290000",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "payTo": "0x93215E03d66B49bA03c015B4f7c103dD102E39A7",
              "maxTimeoutSeconds": 120,
              "extra": {
                "name": "USDC",
                "version": "2"
              }
            }
          ]
        },
        "parameters": [
          {
            "name": "topic",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Brief description of the decision or problem to analyse."
          }
        ],
        "responses": {
          "200": {
            "description": "Endpoint description (free)",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "description": "Payment required — x402 challenge (2.9 USDC)",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      },
      "post": {
        "summary": "Deep-dive report — 2.9 USDC consulting-grade deliverable",
        "description": "Order a full deep-dive report on your topic. Pay 2.9 USDC on Base and retry with the PAYMENT-SIGNATURE header to receive the finished report (1200+ words: diagnosis, frameworks, prioritised action plan with owners and timelines, worked numbers, risks, 30/60/90-day roadmap). The same brief is free on /a2a with X-Expert-Tier: free.",
        "x-payment": {
          "x402Version": 2,
          "accepts": [
            {
              "scheme": "exact",
              "network": "eip155:8453",
              "amount": "290000",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "payTo": "0x93215E03d66B49bA03c015B4f7c103dD102E39A7",
              "maxTimeoutSeconds": 120,
              "extra": {
                "name": "USDC",
                "version": "2"
              }
            }
          ]
        },
        "x-payment-info": {
          "x402Version": 2,
          "accepts": [
            {
              "scheme": "exact",
              "network": "eip155:8453",
              "amount": "290000",
              "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
              "payTo": "0x93215E03d66B49bA03c015B4f7c103dD102E39A7",
              "maxTimeoutSeconds": 120,
              "extra": {
                "name": "USDC",
                "version": "2"
              }
            }
          ]
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "jsonrpc": {
                    "type": "string"
                  },
                  "id": {
                    "type": "string"
                  },
                  "method": {
                    "type": "string",
                    "enum": [
                      "message/send",
                      "message/stream"
                    ]
                  },
                  "params": {
                    "type": "object"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Task result (deep-dive report)",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          },
          "402": {
            "description": "Payment required — x402 challenge (2.9 USDC)",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/a2a/experts/{slug}": {
      "get": {
        "summary": "Free methodology brief for any skill (no charge, no model execution)",
        "parameters": [
          {
            "name": "slug",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Skill slug"
          }
        ],
        "responses": {
          "200": {
            "description": "Free brief + pricing info",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    },
    "/a2a/skills": {
      "get": {
        "summary": "Free catalog of all 885 long-tail skills",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Skill catalog",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                }
              }
            }
          }
        }
      }
    }
  },
  "x-tags": [
    "marketing",
    "brand-strategy",
    "restaurant",
    "business",
    "a2a",
    "mcp",
    "x402",
    "paid"
  ]
}