{
  "openapi": "3.1.0",
  "info": {
    "title": "Web3Map selected read-only API",
    "version": "1.0.0",
    "description": "A limited discovery reference for existing read operations. Market endpoints require a valid Web3Map Bearer session and enforce account, venue, freshness and rate limits. This is not an anonymous market-data API or a credential issuance mechanism. Response objects may vary with access; inspect actual responses. No trading, payment, account mutation or operational routes are described."
  },
  "servers": [
    {
      "url": "https://api.web3map.ink"
    }
  ],
  "externalDocs": {
    "url": "https://web3map.ink/docs/api/"
  },
  "paths": {
    "/api/billing/public-plans": {
      "get": {
        "operationId": "getPublicPlans",
        "summary": "Current public subscription plans",
        "security": [],
        "responses": {
          "200": {
            "description": "Current authorized JSON response; not an execution guarantee.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "429": {
            "description": "Request limited. Respect Retry-After when present."
          },
          "503": {
            "description": "Data or policy unavailable. Do not treat as an empty successful result."
          }
        }
      }
    },
    "/api/graph": {
      "get": {
        "operationId": "getFreeGraph",
        "summary": "Account-authorized, field-redacted free graph overview",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Current authorized JSON response; not an execution guarantee.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "304": {
            "description": "Unchanged conditional response; no body."
          },
          "401": {
            "description": "Missing, invalid or expired session."
          },
          "403": {
            "description": "Account or access policy denies this request."
          },
          "429": {
            "description": "Request limited. Respect Retry-After when present."
          },
          "503": {
            "description": "Data or policy unavailable. Do not treat as an empty successful result."
          }
        }
      }
    },
    "/api/opportunities": {
      "get": {
        "operationId": "getFreeOpportunities",
        "summary": "Account-authorized free spot opportunity view",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Current authorized JSON response; not an execution guarantee.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "304": {
            "description": "Unchanged conditional response; no body."
          },
          "401": {
            "description": "Missing, invalid or expired session."
          },
          "403": {
            "description": "Account or access policy denies this request."
          },
          "429": {
            "description": "Request limited. Respect Retry-After when present."
          },
          "503": {
            "description": "Data or policy unavailable. Do not treat as an empty successful result."
          }
        }
      }
    },
    "/api/opportunities/perp": {
      "get": {
        "operationId": "getFreePerpOpportunities",
        "summary": "Account-authorized free perpetual opportunity view",
        "security": [
          {
            "bearerAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Current authorized JSON response; not an execution guarantee.",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "additionalProperties": true
                }
              }
            }
          },
          "304": {
            "description": "Unchanged conditional response; no body."
          },
          "401": {
            "description": "Missing, invalid or expired session."
          },
          "403": {
            "description": "Account or access policy denies this request."
          },
          "429": {
            "description": "Request limited. Respect Retry-After when present."
          },
          "503": {
            "description": "Data or policy unavailable. Do not treat as an empty successful result."
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "JWT"
      }
    }
  }
}
