Trending topics for a location (worldwide by default; filter with country or woeid)

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "payTo": "0x13E060ADcc6F4b731Da8382B333027B8B2bfF707",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "10000",
    "maxTimeoutSeconds": 300
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "payTo": "CHHWRYyo8exGvcLGn3AxzHEZseLZDTnq3FaYkzZVQDQr",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "10000",
    "maxTimeoutSeconds": 300
  }
]

{
  "bazaar": {
    "info": {
      "input": {
        "method": "GET",
        "queryParams": {},
        "type": "http"
      },
      "output": {
        "example": {
          "code": 0,
          "data": {
            "as_of": "2026-07-25T04:51:10Z",
            "location": "United States",
            "status": "success",
            "trends": [
              {
                "is_hashtag": true,
                "name": "#TypeScript",
                "promoted": false,
                "query": "#TypeScript",
                "rank": 1,
                "search_url": "https://x.com/search?q=%23TypeScript&src=trend_click",
                "tweet_volume": 18452
              },
              {
                "is_hashtag": false,
                "name": "Cloudflare",
                "promoted": false,
                "query": "Cloudflare",
                "rank": 2,
                "search_url": "https://x.com/search?q=Cloudflare&src=trend_click",
                "tweet_volume": null
              }
            ],
            "trends_count": 2,
            "woeid": 23424977
          }
        },
        "type": "json"
      }
    },
    "schema": {
      "$schema": "https://json-schema.org/draft/2020-12/schema",
      "properties": {
        "input": {
          "additionalProperties": false,
          "properties": {
            "method": {
              "enum": [
                "GET"
              ],
              "type": "string"
            },
            "queryParams": {
              "properties": {
                "count": {
                  "description": "Cap the number of trends returned (up to 50).",
                  "maximum": 50,
                  "minimum": 1,
                  "type": "integer"
                },
                "country": {
                  "description": "Location name (country/city) or ISO code, e.g. US, india, tokyo.",
                  "type": "string"
                },
                "woeid": {
                  "description": "Numeric Yahoo WOEID, e.g. 1 for worldwide, 23424977 for the USA. Overrides country when both are given.",
                  "type": "string"
                }
              },
              "type": "object"
            },
            "type": {
              "const": "http",
              "type": "string"
            }
          },
          "required": [
            "type",
            "method"
          ],
          "type": "object"
        },
        "output": {
          "properties": {
            "example": {
              "type": "object"
            },
            "type": {
              "type": "string"
            }
          },
          "required": [
            "type"
          ],
          "type": "object"
        }
      },
      "required": [
        "input"
      ],
      "type": "object"
    }
  }
}

curl "https://readx.sh/api/trends"
# -> 402 Payment Required, accepts[] lists how to pay
# retry with a PAYMENT-SIGNATURE (or PAYMENT header) once paid

const res = await fetch("https://readx.sh/api/trends");
if (res.status === 402) {
  const { accepts } = await res.json();
  // pay one of accepts[] via an x402 client, then retry with the payment header
}

import httpx
res = httpx.get("https://readx.sh/api/trends")
if res.status_code == 402:
    accepts = res.json()["accepts"]
    # pay one of accepts[] via an x402 client, then retry with the payment header