api.boonprotocol.com

{
  "properties": {
    "contract": {
      "type": "string"
    },
    "globalStats": {
      "type": [
        "object",
        "null"
      ]
    },
    "interpretation": {
      "type": "object"
    },
    "navigation": {
      "type": "object"
    },
    "pagination": {
      "type": "object"
    },
    "query": {
      "type": "object"
    },
    "routes": {
      "items": {
        "properties": {
          "contexts": {
            "items": {
              "type": "object"
            },
            "type": "array"
          },
          "description": {
            "description": "Dated endpoint metadata with method, URL, observed price, request basics, and source attribution.",
            "type": [
              "object",
              "null"
            ]
          },
          "links": {
            "properties": {
              "api": {
                "description": "One-cent route-detail path.",
                "type": "string"
              },
              "recognitions": {
                "description": "One-cent routed-recognition-history path.",
                "type": "string"
              },
              "reviews": {
                "description": "One-cent full signed-review-history path.",
                "type": "string"
              },
              "web": {
                "description": "Human endpoint-detail page.",
                "format": "uri",
                "type": "string"
              }
            },
            "required": [
              "api",
              "recognitions",
              "reviews",
              "web"
            ],
            "type": "object"
          },
          "recognition": {
            "properties": {
              "boonBurned": {
                "description": "$BOON base units burned across routed recognitions.",
                "type": "string"
              },
              "distinctTipperWalletCount": {
                "minimum": 0,
                "type": "integer"
              },
              "endpointGratuityUsdc": {
                "description": "USDC base units recognized directly to the endpoint wallet.",
                "type": "string"
              },
              "firstRecognitionAt": {
                "description": "Unix timestamp in seconds.",
                "type": "string"
              },
              "latestBlockNumber": {
                "type": "string"
              },
              "latestRecognitionAt": {
                "description": "Unix timestamp in seconds.",
                "type": "string"
              },
              "latestTxHash": {
                "pattern": "^0x[0-9a-fA-F]{64}$",
                "type": "string"
              },
              "networkGratuityUsdc": {
                "description": "USDC base units recognized to the discovery network.",
                "type": "string"
              },
              "routedBoonCount": {
                "minimum": 0,
                "type": "integer"
              },
              "totalRecognitionUsdc": {
                "description": "Total USDC base units behind this endpoint's routed recognitions.",
                "type": "string"
              }
            },
            "required": [
              "routedBoonCount",
              "distinctTipperWalletCount",
              "endpointGratuityUsdc",
              "networkGratuityUsdc",
              "totalRecognitionUsdc",
              "boonBurned",
              "firstRecognitionAt",
              "latestRecognitionAt",
              "latestBlockNumber",
              "latestTxHash"
            ],
            "type": "object"
          },
          "reviewSummary": {
            "description": "Factual review activity. It is not a star score or objective quality rating.",
            "properties": {
              "boonBackedCount": {
                "description": "Reviews that cite routed USDC gratuity plus the fixed BOON burn. This is the ranking lane.",
                "minimum": 0,
                "type": "integer"
              },
              "count": {
                "minimum": 0,
                "type": "integer"
              },
              "distinctReviewerWalletCount": {
                "minimum": 0,
                "type": "integer"
              },
              "indexComplete": {
                "description": "False only when a bounded legacy V1 KV scan is incomplete. Indexed wallet review volume remains available.",
                "type": "boolean"
              },
              "latestReviewAt": {
                "description": "Unix timestamp in seconds, or null when no review exists.",
                "type": [
                  "integer",
                  "null"
                ]
              },
              "receiptVerifiedCount": {
                "description": "Payer-bound x402 receipt reviews. Visible as verified usage volume and excluded from ranking.",
                "minimum": 0,
                "type": "integer"
              },
              "selfReportedCount": {
                "description": "Five-cent wallet-signed opinions. Visible as participation volume, not proof of purchase, and excluded from ranking.",
                "minimum": 0,
                "type": "integer"
              }
            },
            "required": [
              "count",
              "boonBackedCount",
              "receiptVerifiedCount",
              "selfReportedCount",
              "distinctReviewerWalletCount",
              "latestReviewAt",
              "indexComplete"
            ],
            "type": "object"
          },
          "reviews": {
            "items": {
              "properties": {
                "createdAt": {
                  "type": "integer"
                },
                "evidenceKind": {
                  "enum": [
                    "boon_backed",
                    "receipt_verified",
                    "self_reported"
                  ],
                  "type": "string"
                },
                "publishedAt": {
                  "type": "integer"
                },
                "receipt": {
                  "type": [
                    "object",
                    "null"
                  ]
                },
                "recognition": {
                  "type": [
                    "object",
                    "null"
                  ]
                },
                "reviewText": {
                  "type": "string"
                },
                "reviewer": {
                  "type": "object"
                },
                "routeId": {
                  "description": "The routed x402 endpoint ID.",
                  "pattern": "^0x[0-9a-fA-F]{64}$",
                  "type": "string"
                },
                "verification": {
                  "type": "object"
                }
              },
              "required": [
                "routeId",
                "evidenceKind",
                "reviewText",
                "reviewer",
                "recognition",
                "receipt",
                "createdAt",
                "publishedAt",
                "verification"
              ],
              "type": "object"
            },
            "type": "array"
          },
          "routeId": {
            "description": "The routed x402 endpoint ID.",
            "pattern": "^0x[0-9a-fA-F]{64}$",
            "type": "string"
          }
        },
        "required": [
          "routeId",
          "description",
          "recognition",
          "reviewSummary",
          "links",
          "contexts",
          "reviews"
        ],
        "type": "object"
      },
      "type": "array"
    },
    "version": {
      "type": "string"
    }
  },
  "required": [
    "version",
    "contract",
    "query",
    "navigation",
    "routes",
    "globalStats",
    "pagination",
    "interpretation"
  ],
  "type": "object"
}