API Integration

Plugging into the Gloria Data Platform is simple. You can fetch both our pre-curated feeds and custom feeds (set up on request) via REST, WebSocket or x402 API.

News API

Overview

The News API provides access to processed and curated content from various feeds like general crypto, macro, AI agent, and much more. Unlike the WebSocket API which provides real-time updates, this REST endpoint allows you to retrieve historical data within a specific date range.

Endpoint

GET /news

Query Parameters

Parameter

Type

Description

token

string

Authorization token. You can generate/manage your authorization tokens here: https://www.itsgloria.ai/api-keys-new

feed_categories

string

Comma-separated list of feed categories to fetch (e.g. crypto,ai_agents). Must be in your allowed feed categories, specified during token creation.

from_date

string

Optional. Start date in ISO format (YYYY-MM-DD). Defaults to 2025-05-01.

to_date

string

Optional. End date in ISO format (YYYY-MM-DD). Defaults to today.

page

number

Optional. Page number for pagination. Defaults to 1.

limit

number

Optional. Number of items per page. Defaults to 20.

Authentication

All requests to the News API require authentication using an authorization token. You can provide it as a query parameter:

https://ai-hub.cryptobriefing.com/news?token={{token}}&feed_categories=crypto,rwa

You can generate/manage your authorization tokens here: https://www.itsgloria.ai/api-keys-new

If a token is not provided or is invalid, the request will fail with a 401 Unauthorized response.

Feed Permissions

Each authorization token is associated with permissions for specific feed categories.

If at least one feed category you are trying to fetch from is not in the list of allowed (specified during authorization token creation), the request will fail with a 403 Forbidden response.

Available Feeds

The following feeds are available for subscription:

ai_agents: News on on-chain AI agents, agent frameworks, incentive structures, and ecosystem launches.
crypto: Broad crypto market updates, token launches, infra changes, and major protocol activity.
aptos: Aptos core protocol news, tokenomics, validator changes, and ecosystem-level updates.
rwa: Tokenized real-world asset (RWA) developments, including funds, issuers, platforms, and regulation.
ondo: Product, token, and roadmap news for Ondo Finance and its associated RWAs.
macro: High-impact macroeconomic and geopolitical events with market relevance.
ai: General AI industry news including LLMs, infrastructure, model launches, and major partnerships.
bitcoin: Bitcoin network upgrades, ETF flows, miner trends, and institutional adoption.
ethereum: Ethereum protocol upgrades, scaling tech, validator news, and ecosystem-level changes.
hyperliquid: Updates on the Hyperliquid exchange, HYPE token, governance, and ecosystem projects.
machine_learning: ML-focused news across academia, industry, and open-source development.
ripple: XRP, XRPL, and Ripple Labs updates including legal, infra, and ecosystem news.
solana: Solana protocol news, validator updates, outages, and core network developments.
tech: High-signal tech news across software, semiconductors, regulation, and AI infra.
virtuals: Virtuals Protocol and agent commerce ecosystem, including GAME, agents, and tokenomics.

Response Format

The API returns an array of feed items in JSON format. Each item has the following structure:

[
    {
        "id": "dded21be-5747-43c0-8163-49dfefa662b7",
        "signal": "Uniswap holders vote on adopting DUNI to give DAO legal personality under Wyoming law",
        "sentiment": "bullish",
        "sentiment_value": "0.73",
        "timestamp": 1756817681.332846,
        "feed_categories": [
            "crypto",
            "macro"
        ],
        "short_context": "Uniswap holders are voting on a proposal to adopt DUNI, a Decentralized Unincorporated Nonprofit Association registered in Wyoming, as the new governance structure for the Uniswap DAO, which would give the organization legal standing, allow it to enter contracts, pay taxes, and limit participant liability. The proposal also includes allocating $16.5 million in UNI tokens to cover past tax and legal expenses related to this transition, with voting taking place from September 2 to September 8, 2025.",
        "long_context": "### Facts\n- Uniswap holders are currently voting on a proposal to adopt DUNI as the governance structure for the Uniswap DAO.\n- DUNI stands for a Decentralized Unincorporated Nonprofit Association (DUNA) registered in Wyoming.\n- The proposal aims to grant the DAO legal personality, enabling it to enter contracts, pay taxes, and handle legal matters while providing liability protection for participants.\n- The vote allocates $16.5 million in UNI tokens to cover past tax and legal costs associated with the transition.\n- Voting began on September 2, 2025, and is scheduled to end on September 8, 2025.\n- A temperature check vote showed strong support, with over 41 million votes in favor as of late August 2025.\n- If approved, Uniswap would become the largest DAO to adopt Wyoming's DUNA framework, which was enacted in 2024.\n\n### Why it matters\nThis move could help Uniswap's decentralized governance operate more smoothly in the real world by giving it a formal legal identity, which reduces risks for token holders and makes it easier to interact with traditional systems like banks or courts. It addresses ongoing challenges in the crypto space where DAOs often struggle with unclear legal status, potentially setting a model for other projects to follow and encouraging more institutional involvement.\n\n### Zooming out\nDAO Adoption Trends  \nOver 10,000 DAOs exist globally as of 2025, managing more than $20 billion in assets, with a growing number seeking legal wrappers to mitigate regulatory risks, according to posts found on X and industry reports.\n\nWyoming's Crypto Leadership  \nWyoming has passed over 30 blockchain-friendly laws since 2018, including recognizing DAOs as legal entities, making it a hub for crypto innovation and attracting entities like Uniswap amid broader U.S. regulatory uncertainty.\n\nHistorical Comparisons  \nSimilar to how Wyoming legalized DAOs in 2021, the 2024 DUNA law builds on that foundation; early adopters like American CryptoFed DAO have used it to gain legal standing, potentially paving the way for revenue-sharing features in protocols like Uniswap.",
        "author": "Blockworks_",
        "tweet_url": "https://x.com/Blockworks_/status/1962861518770299015"
    },
    {
        "id": "20cd8427-a6d9-4529-937c-20457ca37b9d",
        "signal": "Yunfeng Financial buys 10,000 ETH for $44M with backing from Alibaba founder Jack Ma",
        "sentiment": "neutral",
        "sentiment_value": "0.77",
        "timestamp": 1756817344.045423,
        "feed_categories": [
            "crypto",
            "tech"
        ],
        "short_context": "Yunfeng Financial, a Hong Kong-listed company closely associated with Alibaba founder Jack Ma, has announced the purchase of 10,000 ETH valued at $44 million. This marks a significant investment in Ethereum by a firm linked to one of China’s most prominent business figures.",
        "long_context": "### Facts\n- Yunfeng Financial, a Hong Kong-listed company, announced it has purchased 10,000 ETH.\n- The purchase totals $44 million.\n- Jack Ma, founder of Alibaba and China's most renowned entrepreneur, is a key associate of Yunfeng Financial.\n\n### Why it matters\nPurchases like this from established firms signal growing confidence in Ethereum as a digital asset, especially amid volatile markets where big players are buying during dips. With ties to a high-profile figure like Jack Ma, it highlights how influential Chinese business networks are quietly engaging with cryptocurrencies, even as China maintains strict regulations on trading. This could encourage more institutional involvement and help stabilize Ethereum's value over time.\n\n### Zooming out\nInstitutional Ethereum Adoption  \nRecent Ethereum ETF launches in the US have seen over $10 billion in assets and $1.1 billion in first-day trading volume, reflecting broader mainstream interest in ETH as an investment vehicle.\n\nWhale Activity Trends  \nPosts found on X indicate multiple large-scale ETH purchases by whales in recent weeks, including one for $48.45 million and another for $30.67 million, suggesting accumulation during market downturns.\n\nHistorical Chinese Crypto Ties  \nPosts found on X note past connections between Alibaba-linked entities and Ethereum backers like Wanxiang, dating to 2014, pointing to long-standing but understated involvement from Chinese firms in blockchain despite national bans on crypto trading.",
        "author": "WuBlockchain",
        "tweet_url": "https://x.com/WuBlockchain/status/1962859974251684178"
    },
    // More items...
]

Response Fields

Field

Type

Description

id

string

Unique identifier for the news item.

signal

string

The main content of the news item.

sentiment

string

High-level tone of the news: bullish, bearish, or neutral. Based on language and phrasing.

sentiment_value

string

Sentiment score value.

timestamp

number

Unix timestamp (in seconds) of when the item was pushed.

feed_categories

string[]

Feed categories the news item belongs to.

short_context

string

One-line summary of the broader context behind the news.

long_context

string

Expanded context including related news events, historical developments, and background information to help understand the significance of the news.

author

string

The primary source of the news item.

tweet_url

string

Direct link to the original tweet on X (Twitter).

Status Codes

Status Code

Description

200

Success

400

Bad Request (invalid parameters)

401

Unauthorized (missing or invalid authorization token)

403

Forbidden (authorization token does not have permission for the requested feed)

404

Not Found (no data found for the specified parameters)

Example Requests

cUrl

curl -X GET "https://ai-hub.cryptobriefing.com/news?token={{token}}&feed_categories=crypto,ai_agents&page=1&limit=40&from_date=2025-05-10&to_date=2025-05-15"

Javascript

const fetchNews = async () => {
  const response = await fetch(
    'https://ai-hub.cryptobriefing.com/news?token={{token}}&feed_categories=crypto,ai_agents&page=1&limit=40&from_date=2025-05-10&to_date=2025-05-15'
  );
  
  if (!response.ok) {
    throw new Error(`HTTP error! Status: ${response.status}`);
  }
  
  const data = await response.json();
  return data;
};

// Usage
(async () => {
  try {
    const newsItems = await fetchNews();
    console.log(`Received ${newsItems.length} news items`);
    newsItems.forEach(item => {
      console.log(`${new Date(item.timestamp * 1000).toLocaleString()}: ${item.signal}`);
    });
  } catch (error) {
    console.error('Error fetching news:', error);
  }
})();

News WebSocket API

Overview

The WebSocket API provides real-time data feeds from various cryptocurrency and AI-related feeds. It allows to subscribe to specific data feeds and receive instant updates as new content becomes available.

Connection

Endpoint

wss://{{domain}}/ws/feed

Authentication

All WebSocket connections require authentication using an authorization token. You can provide it as a query parameter:

wss://{{domain}}/ws/feed?token={{token}}

You can generate/manage your authorization tokens here: https://www.itsgloria.ai/api-keys-new

If an authorization token is not provided or is invalid, the connection will be closed immediately with a 401 Unauthorized response.

Message Format

All messages exchanged between the client and server are in JSON format. Each message has a type field that indicates the message type.

Message Types

subscribe: Subscribe to a specific feed
unsubscribe: Unsubscribe from a specific feed
data: Data message containing feed item information
error: Error message
ping: Ping message to keep connection alive
pong: Response to a ping message

Client to Server Messages

To receive updates from a specific feed, send a subscribe message:

{
    "type": "subscribe",
    "feed_category": "crypto"
}

The server will respond with a confirmation message:

{
    "type": "data",
    "action": "subscribed",
    "feed_category": "crypto"
}

Feed Permissions

Each authorization token is associated with permissions for specific feed categories.

If at least one feed category you are trying to subscribe to is not in the list of allowed (specified during authorization token creation), you will receive an error message.

Unsubscribe from a Feed

To stop receiving updates from a feed:

{
    "type": "unsubscribe",
    "feed_category": "crypto"
}

Server to Client Messages

Welcome Message

Upon successful connection, the server sends a welcome message:

{
    "type": "data",
    "message": "Connection established. Use subscribe/unsubscribe messages to manage feeds."
}

Data Message

When new content is available in a subscribed feed, the server sends a data message:

{
    "type": "data",
    "content": {
        "id": "49683a70-ce26-46ef-9db8-218b6f9b9748",
        "signal": "Blink Charging to accept crypto payments at EV chargers",
        "sentiment": "neutral",
        "sentiment_value": "0.87",
        "timestamp": "2025-09-04T14:46:40.119015+00:00",
        "feed_categories": [
            "crypto",
            "tech"
        ],
        "short_context": "Blink Charging has announced that it will begin accepting cryptocurrency payments at its electric vehicle charging stations. The rollout will start at select locations in the United States and could expand to other countries where Blink operates.",
        "long_context": "### Facts\n- Blink Charging, a provider of electric vehicle charging stations, has announced plans to accept cryptocurrency as a payment method at its EV chargers.\n- The initiative aims to integrate crypto payments directly into the charging process for users of Blink's network of Level 2 and DC fast chargers.\n- This feature will be compatible with major cryptocurrencies, though specific ones like Bitcoin or Ethereum were not detailed in the announcement.\n- Rollout is expected to begin in select locations in the United States, with potential expansion to global markets where Blink operates.\n- The company stated this move is part of broader efforts to enhance payment flexibility and attract tech-savvy EV drivers.\n\n### Why it matters\nIntegrating cryptocurrency payments into EV charging stations could make electric vehicle ownership more convenient for people who use digital currencies, potentially speeding up adoption in a market where payment options have traditionally been limited to credit cards or apps. This step aligns with growing consumer interest in seamless, modern transactions, and it positions Blink Charging as an innovator in the competitive EV infrastructure space, where companies are racing to meet rising demand from electric car owners.\n\n### Zooming out\nEV Market Growth: Global electric vehicle sales reached over 14 million units in 2023, up from 6.6 million in 2021, driven by incentives like the U.S. federal tax credit of up to $7,500 per vehicle under President Trump's administration.\nCryptocurrency Adoption in Payments: Around 420 million people worldwide own cryptocurrency as of 2024, with payment integrations in retail and services increasing by 30% year-over-year, reflecting a trend toward mainstream use beyond investment.\nSustainability Trends: EV charging networks like Blink's support environmental goals, with the U.S. aiming for 50% of new vehicle sales to be electric by 2030, tying into broader efforts to reduce carbon emissions through innovative tech integrations.",
        "author": "DeItaone",
        "tweet_url": "https://x.com/DeItaone/status/1963614452806238544"
    }
}

Error Message

If an error occurs, the server sends an error message:

{
    "type": "error",
    "error": "Permission denied",
    "details": "No permission for crypto feed"
}

Ping/Pong

The server sends ping messages every 30 seconds to keep the connection alive:

{
  "type": "ping",
  "timestamp": 1148216.120805222
}

Clients should respond with a pong message:

{
  "type": "pong",
  "timestamp": 1148216.120805222
}

Available Feeds

See Available Feeds.

Error Handling

The server may close the connection with the following status codes:

1000: Normal closure (server shutting down or inactive connection)
1008: Policy violation (missing or invalid authorization token)

Connection Lifecycle

Connect to the WebSocket endpoint with a valid authorization token
Receive the welcome message
Subscribe to desired feeds
Receive real-time updates
Respond to ping messages to keep the connection alive
Unsubscribe when no longer interested in a feed
The connection will be automatically closed after 5 minutes of inactivity

Client Example (JavaScript)

// Create WebSocket connection
const socket = new WebSocket('wss://ai-hub.cryptobriefing.com/ws/feed?token={{token}}');

// Connection opened
socket.addEventListener('open', (event) => {
  console.log('Connected to WebSocket server');
  
  // Subscribe to a feed
  socket.send(JSON.stringify({
    type: 'subscribe',
    feed_category: 'crypto'
  }));
});

// Listen for messages
socket.addEventListener('message', (event) => {
  const message = JSON.parse(event.data);
  
  switch(message.type) {
    case 'data':
      if (message.content) {
        // New news item received
        console.log(`WebSocketClient: New update for ${message.content.feed_category}:`, message.content.signal);
        this.emit('news', message.content);
      } else if (message.action === 'subscribed') {
        console.log(`WebSocketClient: Successfully subscribed to ${message.feed_category}`);
        this.emit('subscribed', message.feed_category);
      } else {
        console.log('WebSocketClient: Data message:', message);
      }
      break;
    case 'error':
      console.error('Error:', message.error, message.details);
      break;
    case 'ping':
      // Respond with pong to keep connection alive
      socket.send(JSON.stringify({
        type: 'pong',
        timestamp: message.timestamp
      }));
      break;
  }
});

// Handle connection close
socket.addEventListener('close', (event) => {
  console.log('Connection closed:', event.code, event.reason);
});

// Handle errors
socket.addEventListener('error', (event) => {
  console.error('WebSocket error:', event);
});

Recaps API

Overview

The Recaps API provides a condensed summary of the most important news published on Gloria in the last 12 hours, making it easy to track key developments at a glance.

Endpoint

GET /recaps

Query Parameters

Parameter

Type

Description

token

string

Authorization token. You can generate/manage your authorization tokens here: https://www.itsgloria.ai/api-keys-new.

feed_category

string

Feed category to get the recap for (e.g. crypto,ai_agents). Must be in your allowed feed categories, specified during token creation.

timeframe

string

Defines the news collection window. Available options: 12h .

Authentication

All requests to the Recaps API require authentication using an authorization token. You can provide it as a query parameter:

https://ai-hub.cryptobriefing.com/recaps?token={{token}}&feed_category=crypto&timeframe=12h

You can generate/manage your authorization tokens here: https://www.itsgloria.ai/api-keys-new

If a token is not provided or is invalid, the request will fail with a 401 Unauthorized response.

Feed Permissions

Each authorization token is associated with permissions for specific feed categories.

If the feed category you are trying to fetch recap for is not in the list of allowed (specified during authorization token creation), the request will fail with a 403 Forbidden response.

Response Format

The API returns a recap of news for the specified feed category in JSON format:

{
    "feed_category": "macro",
    "timeframe": "12h",
    "recap": "Bitcoin ETFs recorded $1.7 billion in net purchases this week, a pace that points to renewed institutional demand after a quieter start to the year. Market analysts view this surge as an indicator that risk appetite and bullish sentiment are returning, with ETF inflows often preceding wider price rallies.\n\nThe entry of large investors into Bitcoin ETFs is helping to stabilize the asset’s value, encouraging retail participation and giving credence to the view that Bitcoin is maturing as an investment product. Persistent inflows, especially during market recoveries, can set new price floors.\n\nPosts on social media platforms suggest that weekly inflows surpassing $1 billion have occurred multiple times in 2024 and 2025, with leading asset managers reportedly among the buyers. However, these claims remain partially unverified in the absence of official disclosures.\n\nBitcoin's current $1.2 trillion market capitalization underscores its dominant position, accounting for roughly half of the entire cryptocurrency sector. Its adoption by companies and reserve managers continues to grow amid concerns over inflation and changing global monetary policy.",
    "created_at": "2025-09-12T14:50:18.849965Z"
}

Response Fields

Field

Type

Description

feed_category

string

Indicates the category the recap was generated for (e.g. crypto, macro).

timeframe

string

The news collection window.

recap

string

Recap content.

created_at

string

Timestamp indicating when the recap was generated.

Example Requests

cUrl

curl -X GET "https://ai-hub.cryptobriefing.com/recaps?token={{token}}&feed_category=crypto&timeframe=12h"

Javascript

const fetchRecap = async (category) => {
  const token = "my_token";
  const response = await fetch(
    `https://ai-hub.cryptobriefing.com/recaps?token=${token}&feed_category=${category}&timeframe=12h`
  );
  
  if (!response.ok) {
    throw new Error(`HTTP error! Status: ${response.status}`);
  }
  
  const data = await response.json();
  return data;
};

// Usage
(async () => {
  try {
    const recap = await fetchRecap("crypto");
    console.log("Recap:", recap);
  } catch (error) {
    console.error('Error fetching recap:', error);
  }
})();

PreviousPlatform Architecture Nextx402 Integration

Last updated 15 days ago

News API

Overview

Endpoint

Query Parameters

Authentication

Feed Permissions

Available Feeds

Response Format

Response Fields

Status Codes

Example Requests

cUrl

Javascript

News WebSocket API

Overview

Connection

Endpoint

Authentication

Message Format

Message Types

Client to Server Messages

Subscribe to a Feed

Feed Permissions

Unsubscribe from a Feed

Server to Client Messages

Welcome Message

Data Message

Error Message

Ping/Pong

Available Feeds

Error Handling

Connection Lifecycle

Client Example (JavaScript)

Recaps API

Overview

Endpoint

Query Parameters

Authentication

Feed Permissions

Response Format

Response Fields

Example Requests

cUrl

Javascript