x402.professorsausages.com

{
  "properties": {
    "about": {
      "description": "What this response is and where its data comes from, in one sentence.",
      "type": "string"
    },
    "base": {
      "description": "Rebase currency (default EUR).",
      "type": "string"
    },
    "disclaimer": {
      "type": "string"
    },
    "found": {
      "description": "False when we answered definitively and the answer is that no such rate exists (see why). A definitive miss is a complete paid answer, never a 404.",
      "type": "boolean"
    },
    "freshness": {
      "description": "How fresh the data is, measured when you called. `age_seconds` is the number to act on; `max_age_seconds` is the refresh cadence (null = deterministic, cannot go stale).",
      "properties": {
        "age_seconds": {
          "minimum": 0,
          "type": "integer"
        },
        "as_of": {
          "description": "Newest datum this answer is based on (ISO 8601).",
          "type": "string"
        },
        "max_age_seconds": {
          "minimum": 0,
          "type": [
            "integer",
            "null"
          ]
        },
        "note": {
          "type": "string"
        },
        "tier": {
          "example": "nightly",
          "type": "string"
        }
      },
      "required": [
        "tier",
        "as_of",
        "age_seconds",
        "max_age_seconds"
      ],
      "type": "object"
    },
    "rateDate": {
      "description": "ECB fixing date (YYYY-MM-DD) backing this answer; null when no fixing was consulted.",
      "type": [
        "string",
        "null"
      ]
    },
    "rateType": {
      "description": "Daily reference rates — NOT live trading rates.",
      "enum": [
        "ecb-daily-reference"
      ],
      "type": "string"
    },
    "rates": {
      "description": "Currency code → rate (1 base = N quote), 6 decimals.",
      "type": "object"
    },
    "related": {
      "additionalProperties": {
        "type": "string"
      },
      "description": "Next steps as paths on this origin. Each is priced by its own 402 challenge; GET /.well-known/x402 prices the whole origin in one free call.",
      "type": "object"
    },
    "source": {
      "enum": [
        "European Central Bank"
      ],
      "type": "string"
    },
    "staleDays": {
      "description": "Weekdays since the fixing; 0 = current. Null on a miss.",
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "required": [
    "rateType",
    "found",
    "rateDate",
    "staleDays",
    "base",
    "rates",
    "source",
    "disclaimer"
  ],
  "type": "object"
}