{
  "openapi": "3.1.0",
  "info": {
    "title": "hood.fun Agent API",
    "version": "0.1.0",
    "description": "Risk-first Robinhood Chain token intelligence API for AI agents."
  },
  "servers": [
    {
      "url": "https://hood-fun.pages.dev"
    }
  ],
  "paths": {
    "/api/agent.json": {
      "get": {
        "summary": "Shortest agent entrypoint and decision tree",
        "responses": {
          "200": {
            "description": "Agent entrypoint"
          }
        }
      }
    },
    "/api/agent_manifest.json": {
      "get": {
        "summary": "Agent policy and answer shape",
        "responses": {
          "200": {
            "description": "Agent manifest"
          }
        }
      }
    },
    "/api/trustlist.json": {
      "get": {
        "summary": "Score-filtered token trustlist",
        "responses": {
          "200": {
            "description": "Trustlist"
          }
        }
      }
    },
    "/api/tokens.json": {
      "get": {
        "summary": "Full token feed",
        "responses": {
          "200": {
            "description": "Token list"
          }
        }
      }
    },
    "/api/token_index.json": {
      "get": {
        "summary": "Index of per-token risk pages",
        "responses": {
          "200": {
            "description": "Token risk index"
          }
        }
      }
    },
    "/api/creator_index.json": {
      "get": {
        "summary": "Index of creator/deployer reputation pages",
        "responses": {
          "200": {
            "description": "Creator reputation index"
          }
        }
      }
    },
    "/api/creators.json": {
      "get": {
        "summary": "Creator/deployer reputation summary",
        "responses": {
          "200": {
            "description": "Creator reputation summary"
          }
        }
      }
    },
    "/api/creator/4663/{address}.json": {
      "get": {
        "summary": "Creator/deployer reputation page",
        "parameters": [
          {
            "name": "address",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[a-fA-F0-9]{40}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Creator launch history and agent recommendation"
          }
        }
      }
    },
    "/api/token/4663/{address}.json": {
      "get": {
        "summary": "Explainable token risk page",
        "parameters": [
          {
            "name": "address",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "pattern": "^0x[a-fA-F0-9]{40}$"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Token risk evidence and routing recommendation"
          }
        }
      }
    },
    "/api/risk_schema.json": {
      "get": {
        "summary": "Field meanings and limitations",
        "responses": {
          "200": {
            "description": "Risk schema"
          }
        }
      }
    },
    "/api/market_intel.json": {
      "get": {
        "summary": "Venue map and positioning",
        "responses": {
          "200": {
            "description": "Market intel"
          }
        }
      }
    },
    "/api/freshness.json": {
      "get": {
        "summary": "Live venue freshness check",
        "responses": {
          "200": {
            "description": "Upstream venue reachability and observed counts"
          }
        }
      }
    },
    "/api/snapshot.json": {
      "get": {
        "summary": "SHA-256 integrity snapshot for core static APIs",
        "responses": {
          "200": {
            "description": "Integrity manifest"
          }
        }
      }
    }
  },
  "x-agent-safety": {
    "default": "watch-only",
    "forbiddenClaims": [
      "safe",
      "guaranteed",
      "profit",
      "risk-free"
    ],
    "requiresExplicitUserConfirmationFor": [
      "opening external venue",
      "wallet connection",
      "transaction signing"
    ]
  }
}