Index onlineMerchant portal
Api Endpoint

gdelt-tone

Native multilingual tone/sentiment for a topic from the GDELT Project: a tone histogram (emotional bins with example articles), a coverage-weighted average tone and label, the modal bin, and an optional tone trend over time. GDELT's own cross-language tone (a differentiator over English-only lexicon scoring).

Open interactive test console

Offering

Provider
payai.agentstools.dev
Method
GET
Offering type
Api Endpoint
Transport type
http
Category
Social Intelligence
Delivery
Not provided
Pricing model
Not provided
x402 version
2

Endpoint context

URL
https://payai.agentstools.dev/gdelt/tone
MIME type
application/json
First seen
2026-10-16T02:01:31.612Z
Last seen
Tags
sentiment, tone, News, geopolitics, gdelt, multilingual, mood, Intelligence, osint, Research, global

Website

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1
0.006 USDC
Atomic price: 6000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2
0.006 USDC
Atomic price: 6000 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact
Raw x402 terms
[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "6000",
    "payTo": "0xF22e558a00D91Ee12A1F50C52186FecB8dDFf493"
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "6000",
    "payTo": "AytHnvc6bZx1ALTy7b5Px7hcavoSYszG9aeKvDcZ8R1u"
  }
]

Observed health

Status
Healthy
Latest latency
399 ms
Average latency
721 ms
HTTP status
402
Last checked
Reachability
100% over 9 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET",
        "HEAD",
        "DELETE"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "query": {
          "type": "string",
          "description": "Free-text topic (multi-word phrases are auto-quoted). Optional if a theme/country is given."
        },
        "theme": {
          "type": "string",
          "enum": [
            "protests",
            "terrorism",
            "conflict",
            "war",
            "inflation",
            "sanctions",
            "trade",
            "elections",
            "corruption",
            "cyber",
            "immigration",
            "refugees",
            "climate",
            "disaster",
            "epidemic",
            "energy",
            "economy",
            "diplomacy",
            "coup",
            "unrest"
          ],
          "description": "Curated GDELT GKG theme filter (friendly name mapped to a GKG code)."
        },
        "country": {
          "type": "string",
          "description": "Source-country filter by friendly name (United States, Russia, China, ...); mapped to the GDELT FIPS 10-4 code server-side."
        },
        "lang": {
          "type": "string",
          "description": "Source-language filter by name (english, russian, arabic, ...)."
        },
        "timespan": {
          "type": "string",
          "description": "Lookback window: 15min, 24h, 3d, 1w, 1m (default 24h)."
        },
        "trend": {
          "type": "boolean",
          "description": "Also include a tone trend over the window (1 extra call)."
        }
      },
      "required": []
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "object",
      "required": [
        "type",
        "method"
      ],
      "properties": {
        "type": {
          "type": "string",
          "const": "http"
        },
        "method": {
          "enum": [
            "GET",
            "HEAD",
            "DELETE"
          ],
          "type": "string"
        },
        "queryParams": {
          "type": "object",
          "required": [],
          "properties": {
            "lang": {
              "type": "string",
              "description": "Source-language filter by name (english, russian, arabic, ...)."
            },
            "query": {
              "type": "string",
              "description": "Free-text topic (multi-word phrases are auto-quoted). Optional if a theme/country is given."
            },
            "theme": {
              "enum": [
                "protests",
                "terrorism",
                "conflict",
                "war",
                "inflation",
                "sanctions",
                "trade",
                "elections",
                "corruption",
                "cyber",
                "immigration",
                "refugees",
                "climate",
                "disaster",
                "epidemic",
                "energy",
                "economy",
                "diplomacy",
                "coup",
                "unrest"
              ],
              "type": "string",
              "description": "Curated GDELT GKG theme filter (friendly name mapped to a GKG code)."
            },
            "trend": {
              "type": "boolean",
              "description": "Also include a tone trend over the window (1 extra call)."
            },
            "country": {
              "type": "string",
              "description": "Source-country filter by friendly name (United States, Russia, China, ...); mapped to the GDELT FIPS 10-4 code server-side."
            },
            "timespan": {
              "type": "string",
              "description": "Lookback window: 15min, 24h, 3d, 1w, 1m (default 24h)."
            }
          }
        }
      },
      "additionalProperties": false
    },
    "output": {
      "type": "object",
      "required": [
        "type"
      ],
      "properties": {
        "type": {
          "type": "string"
        },
        "example": {
          "type": "object"
        }
      }
    }
  }
}