x402.atomicstream.net

{
  "input": {
    "discoverable": true,
    "method": "GET",
    "type": "http"
  },
  "output": {
    "description": "WS402 connection schema",
    "example": {
      "paymentDetails": {
        "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "maxAmountRequired": "150000",
        "maxTimeoutSeconds": 60,
        "network": "solana",
        "payTo": "2chGLRxzvoTgQXhqyoqpwn5yVChRx8qQMXPLDud7D2e4",
        "scheme": "exact"
      },
      "pricing": {
        "currency": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "estimatedDuration": 300,
        "pricePerSecond": 500
      },
      "protocol": "ws402",
      "stream": {
        "description": "Rolling 60-second top tokens by USD volume (updates every 5s).",
        "id": "trending-leaderboard",
        "title": "Trending Tokens Leaderboard"
      },
      "version": "1",
      "websocketEndpoint": "wss://x402.atomicstream.net/v1/stream/trending-leaderboard?t=<token>"
    },
    "properties": {
      "paymentDetails": {
        "description": "Payment requirements for a single slice",
        "properties": {
          "asset": {
            "description": "Token mint/address used for payment",
            "type": "string"
          },
          "maxAmountRequired": {
            "description": "Maximum amount required for a single slice in base units",
            "type": "string"
          },
          "maxTimeoutSeconds": {
            "description": "Maximum time allowed to complete payment in seconds",
            "type": "number"
          },
          "network": {
            "description": "Payment network identifier",
            "type": "string"
          },
          "payTo": {
            "description": "Recipient address for the payment",
            "type": "string"
          },
          "scheme": {
            "const": "exact",
            "description": "Payment scheme",
            "type": "string"
          }
        },
        "required": [
          "scheme",
          "network",
          "asset",
          "payTo",
          "maxAmountRequired",
          "maxTimeoutSeconds"
        ],
        "type": "object"
      },
      "pricing": {
        "description": "Pricing details for a single paid slice",
        "properties": {
          "currency": {
            "description": "Asset identifier used for pricing (token mint/address)",
            "type": "string"
          },
          "estimatedDuration": {
            "description": "Slice duration in seconds used for pricing",
            "type": "number"
          },
          "pricePerSecond": {
            "description": "Cost per second in the payment asset base units",
            "type": "number"
          }
        },
        "required": [
          "pricePerSecond",
          "currency",
          "estimatedDuration"
        ],
        "type": "object"
      },
      "protocol": {
        "const": "ws402",
        "description": "Indicates this is a WS402 resource",
        "type": "string"
      },
      "stream": {
        "description": "Stream metadata",
        "properties": {
          "description": {
            "description": "Human-readable stream description",
            "type": "string"
          },
          "id": {
            "const": "trending-leaderboard",
            "description": "Stable stream identifier",
            "type": "string"
          },
          "title": {
            "description": "Human-readable stream title",
            "type": "string"
          }
        },
        "required": [
          "id",
          "title",
          "description"
        ],
        "type": "object"
      },
      "version": {
        "const": "1",
        "description": "WS402 schema version",
        "type": "string"
      },
      "websocketEndpoint": {
        "description": "WebSocket endpoint to connect after payment",
        "format": "uri",
        "type": "string"
      }
    },
    "required": [
      "protocol",
      "version",
      "websocketEndpoint",
      "pricing",
      "paymentDetails",
      "stream"
    ],
    "type": "object"
  }
}