API Integration

The Gloria Data Platform provides three ways to access curated crypto news and market intelligence:

REST API — Query historical and recent news, recaps, narratives, and articles
WebSocket API — Stream real-time news as it's published
x402 API — Pay-per-request access via micropayments (no account needed) — see x402 Integration

Base URL: https://ai-hub.cryptobriefing.com

Authentication

API Token (Recommended)

Generate tokens at itsgloria.ai/api-keys-new. Each token is scoped to specific feed categories selected during creation.

Pass your token in one of two ways:

# Query parameter
curl "https://ai-hub.cryptobriefing.com/news?token=YOUR_TOKEN&feed_categories=crypto"

# Authorization header
curl -H "Authorization: Bearer YOUR_TOKEN" "https://ai-hub.cryptobriefing.com/news?feed_categories=crypto"

Wallet Authentication

For programmatic access, authenticate with an Ethereum wallet using SIWE (Sign-In with Ethereum):

Get nonce: GET /auth/nonce → returns {"nonce": "..."}
Sign & verify: POST /auth/verify with {"message": "<SIWE message>", "signature": "<hex>"} → returns {"access_token": "...", "is_admin": false}
Use the returned JWT as your token.

Public Token

For anonymous read-only access: GET /auth/public-token → returns {"access_token": "..."}.

Feed Permissions

Each token is associated with permissions for specific feed categories. If you request a feed category not in your allowed list, the request will fail with a 403 Forbidden response.

News API

GET /news

Retrieve news items with filtering and pagination.

Query Parameters

Parameter	Type	Description
`token`	`string`	Authorization token (alternative to `Authorization` header).
`feed_categories`	`string`	Comma-separated category codes (e.g. `crypto,ai_agents`). Use `token_listings` for exchange listings only. If omitted, returns all sources.
`from_date`	`string`	Optional. Start date in `YYYY-MM-DD` format.
`to_date`	`string`	Optional. End date in `YYYY-MM-DD` format.
`keyword`	`string`	Optional. Text search filter.
`page`	`number`	Optional. Page number for pagination. Defaults to `1`.
`limit`	`number`	Optional. Number of items per page. Defaults to `20`.

Response Format

The API returns an array of feed items in JSON format:

[
    {
        "id": "3eb6c79c-6295-48e5-95ab-710b7ed66812",
        "signal": "BlackRock plans to launch Bitcoin ETF in Australia",
        "sentiment": "bullish",
        "sentiment_value": 0.95,
        "timestamp": 1762247231.193328,
        "feed_categories": [
            "crypto",
            "bitcoin",
            "macro"
        ],
        "short_context": "BlackRock has launched a spot Bitcoin ETF in Australia, giving local investors regulated access to cryptocurrency through a product listed on the country's main stock exchange.",
        "long_context": "Entities mentioned or implied in the tweet\n- BlackRock\n- BTC (Bitcoin)\n- ETF (Exchange-Traded Fund)\n- Australia\n\nExternal facts or contextual insights\nAdoption\n- BlackRock's Bitcoin ETF launch provides local Australian investors with regulated access to cryptocurrency.\n\nMarket Context\n- The move marks a historic step for Australia's financial markets, aligning with global trends in cryptocurrency legitimacy and liquidity.",
        "sources": [
            "https://x.com/LLuciano_BTC/status/1859147055840538632",
            "https://x.com/DeItaone/status/1784729756543402332",
            "https://x.com/EricBalchunas/status/1523659326396985344"
        ],
        "author": "solidintel_x",
        "tokens": [
            "$BTC"
        ],
        "tweet_url": "https://x.com/solidintel_x/status/1985634552664985964",
        "narrative_id": "32a92ee7-0dc1-47b6-a095-d27e830bdd5d"
    }
]

Response Fields

Field	Type	Description
`id`	`string`	Unique identifier for the news item.
`signal`	`string`	Processed headline of the news item.
`sentiment`	`string`	Tone of the news: `bullish`, `bearish`, or `neutral`.
`sentiment_value`	`number`	Sentiment confidence score (0.0 to 1.0).
`timestamp`	`number`	Unix timestamp (seconds) of when the item was processed.
`feed_categories`	`string[]`	Feed categories the news item belongs to.
`short_context`	`string`	One-line summary of the broader context.
`long_context`	`string`	Expanded context including related events, background, and significance.
`sources`	`string[]`	Source URLs and citations used for context enrichment.
`author`	`string`	The primary source (X/Twitter handle).
`tokens`	`string[]`	Mentioned token symbols (e.g. `$BTC`, `$ETH`).
`tweet_url`	`string`	Direct link to the original post on X.
`narrative_id`	`string \| null`	ID of the narrative (story arc) this item belongs to, if any.

Status Codes

Status Code	Description
`200`	Success
`400`	Bad Request (invalid parameters)
`401`	Unauthorized (missing or invalid token)
`403`	Forbidden (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=YOUR_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?feed_categories=crypto,ai_agents&page=1&limit=40',
    { headers: { 'Authorization': 'Bearer YOUR_TOKEN' } }
  );

  if (!response.ok) throw new Error(`HTTP error! Status: ${response.status}`);
  return response.json();
};

const newsItems = await fetchNews();
console.log(`Received ${newsItems.length} news items`);
newsItems.forEach(item => {
  console.log(`${new Date(item.timestamp * 1000).toLocaleString()}: ${item.signal}`);
});

GET /news/{id}

Retrieve a single news item by its unique ID.

curl "https://ai-hub.cryptobriefing.com/news/3eb6c79c-6295-48e5-95ab-710b7ed66812?token=YOUR_TOKEN"

Returns a single object with the same fields as the /news response.

GET /news-ticker-summary

Generate an AI-powered 24-hour summary for a specific token or project.

Query Parameters

Parameter	Type	Description
`token`	`string`	Authorization token.
`ticker`	`string`	Required. Token symbol or name (e.g. `SOL`, `LayerZero`, `ZRO`).

Example

curl "https://ai-hub.cryptobriefing.com/news-ticker-summary?token=YOUR_TOKEN&ticker=SOL"

Response

{
    "summary": "Solana saw increased network activity over the past 24 hours, with total value locked rising 3.2% to $8.1B. The Solana Foundation announced a new grant program targeting DePIN projects, while validator count reached an all-time high of 2,100 active nodes..."
}

Recaps API

GET /recaps

Retrieve an AI-generated summary of the most significant news from a given time window.

Query Parameters

Parameter	Type	Description
`token`	`string`	Authorization token.
`feed_category`	`string`	Category code to get the recap for (e.g. `crypto`, `macro`).
`timeframe`	`string`	News collection window. Available options: `12h`, `24h`. High-frequency categories (crypto, macro) use `12h`; others use `24h`. See table below.

Recap Timeframes by Category

Timeframe	Categories
`12h`	`ai`, `ai_agents`, `crypto`, `defi`, `machine_learning`, `macro`, `tech`, `virtuals`
`24h`	`base`, `bitcoin`, `dats`, `ethereum`, `hyperliquid`, `on_chain_whale`, `perps`, `ripple`, `rwa`, `solana`

Response Format

{
    "feed_category": "crypto",
    "timeframe": "12h",
    "recap": "Bitcoin ETFs recorded $1.7 billion in net purchases this week, a pace that points to renewed institutional demand...",
    "created_at": "2026-02-16T14:50:18.849965Z"
}

Response Fields

Field	Type	Description
`feed_category`	`string`	The category the recap was generated for.
`timeframe`	`string`	The news collection window.
`recap`	`string`	The recap content.
`created_at`	`string`	ISO 8601 timestamp of when the recap was generated.

Example Requests

cURL

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

JavaScript

const fetchRecap = async (category, timeframe = '12h') => {
  const response = await fetch(
    `https://ai-hub.cryptobriefing.com/recaps?feed_category=${category}&timeframe=${timeframe}`,
    { headers: { 'Authorization': 'Bearer YOUR_TOKEN' } }
  );

  if (!response.ok) throw new Error(`HTTP error! Status: ${response.status}`);
  return response.json();
};

const recap = await fetchRecap('crypto', '12h');
console.log(recap.recap);

Narratives API

Narratives group related news items into story arcs — for example, all coverage of a single developing story across multiple sources and timeframes.

GET /narratives

Retrieve all active narratives.

curl -H "Authorization: Bearer YOUR_TOKEN" "https://ai-hub.cryptobriefing.com/narratives"

Response Format

[
    {
        "narrative_id": "32a92ee7-0dc1-47b6-a095-d27e830bdd5d",
        "updated_at": "2026-02-16T14:30:00Z",
        "tag": "BlackRock Expands Bitcoin ETF to Australia",
        "summary": "BlackRock continues its global expansion of Bitcoin ETF offerings, with the latest launch targeting Australian investors...",
        "content": [
            {
                "id": "3eb6c79c-6295-48e5-95ab-710b7ed66812",
                "signal": "BlackRock plans to launch Bitcoin ETF in Australia",
                "sentiment": "bullish",
                "...": "same fields as /news response"
            }
        ]
    }
]

Response Fields

Field	Type	Description
`narrative_id`	`string`	Unique identifier for the narrative.
`updated_at`	`string`	ISO 8601 timestamp of the last update.
`tag`	`string`	Short descriptive headline for the narrative.
`summary`	`string`	Prose summary of the narrative arc.
`content`	`array`	Array of news items in this narrative (same schema as `/news` response).

GET /narratives/{id}

Retrieve a single narrative by ID.

curl -H "Authorization: Bearer YOUR_TOKEN" "https://ai-hub.cryptobriefing.com/narratives/32a92ee7-0dc1-47b6-a095-d27e830bdd5d"

Articles API

GET /articles

Retrieve AI-generated long-form articles with optional filtering.

Query Parameters

Parameter	Type	Description
`token`	`string`	Authorization token.
`limit`	`number`	Optional. Results per page (1–100). Defaults to `20`.
`page`	`number`	Optional. Page number. Defaults to `1`.
`category`	`string`	Optional. Filter by category.
`search`	`string`	Optional. Search in headline and content.
`type`	`string`	Optional. Filter by article type.

curl -H "Authorization: Bearer YOUR_TOKEN" "https://ai-hub.cryptobriefing.com/articles?limit=5"

Response Format

[
    {
        "id": "article-uuid",
        "data": { ... },
        "created_at": "2026-02-16T10:00:00Z"
    }
]

GET /articles/{article_id}

Retrieve a single article by ID.

Feed Categories

GET /available-feed-categories

List all available feed categories. No authentication required.

curl "https://ai-hub.cryptobriefing.com/available-feed-categories"

Response

[
    { "code": "ai", "name": "AI", "recap_timeframe": "12h" },
    { "code": "ai_agents", "name": "AI Agents", "recap_timeframe": "12h" },
    { "code": "base", "name": "Base", "recap_timeframe": "24h" },
    { "code": "bitcoin", "name": "Bitcoin", "recap_timeframe": "24h" },
    { "code": "crypto", "name": "Crypto", "recap_timeframe": "12h" },
    { "code": "dats", "name": "DATs", "recap_timeframe": "24h" },
    { "code": "defi", "name": "DeFi", "recap_timeframe": "12h" },
    { "code": "ethereum", "name": "Ethereum", "recap_timeframe": "24h" },
    { "code": "hyperliquid", "name": "Hyperliquid", "recap_timeframe": "24h" },
    { "code": "machine_learning", "name": "Machine Learning", "recap_timeframe": "12h" },
    { "code": "macro", "name": "Macro", "recap_timeframe": "12h" },
    { "code": "on_chain_whale", "name": "On-Chain Whale Wallet Movements", "recap_timeframe": "24h" },
    { "code": "perps", "name": "Perp DEXs", "recap_timeframe": "24h" },
    { "code": "ripple", "name": "Ripple", "recap_timeframe": "24h" },
    { "code": "rwa", "name": "RWA", "recap_timeframe": "24h" },
    { "code": "solana", "name": "Solana", "recap_timeframe": "24h" },
    { "code": "tech", "name": "Tech", "recap_timeframe": "12h" },
    { "code": "token_listings", "name": "Token Listings", "recap_timeframe": null },
    { "code": "virtuals", "name": "Virtuals", "recap_timeframe": "12h" }
]

For detailed category descriptions, see Categories.

News WebSocket API

Overview

The WebSocket API provides real-time news updates. Subscribe to specific feed categories and receive items as they are published.

Connection

wss://ai-hub.cryptobriefing.com/ws/feed?token=YOUR_TOKEN

Client to Server Messages

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

The server responds with a confirmation:

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

Unsubscribe from a Feed

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

Server to Client Messages

Welcome Message

Upon successful connection:

{
    "type": "connected",
    "message": "Connection established."
}

Data Message

When new content is available in a subscribed feed:

{
    "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": 1762247231.0,
        "feed_categories": ["crypto", "tech"],
        "short_context": "Blink Charging has announced that it will begin accepting cryptocurrency payments at its electric vehicle charging stations.",
        "long_context": "...",
        "sources": ["https://x.com/DeItaone/status/1963614452806238544"],
        "author": "DeItaone",
        "tokens": [],
        "tweet_url": "https://x.com/DeItaone/status/1963614452806238544",
        "narrative_id": null
    }
}

The content object has the same schema as items returned by the /news endpoint.

Error Message

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

Ping/Pong

The server sends ping messages every 30 seconds. Respond with pong to keep the connection alive:

// Server sends:
{ "type": "ping", "timestamp": 1148216.120805222 }

// Client responds:
{ "type": "pong", "timestamp": 1148216.120805222 }

Message Types

Type	Direction	Description
`connected`	Server → Client	Connection established
`subscribe`	Client → Server	Subscribe to a feed category
`subscribed`	Server → Client	Subscription confirmed
`unsubscribe`	Client → Server	Unsubscribe from a feed category
`unsubscribed`	Server → Client	Unsubscription confirmed
`data`	Server → Client	News item (same schema as REST API)
`error`	Server → Client	Error message
`ping`	Server → Client	Keep-alive ping (every 30s)
`pong`	Client → Server	Keep-alive response

Connection Lifecycle

Connect with a valid 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
Connection auto-closes after 5 minutes of inactivity

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 token)

Client Example (JavaScript)

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

socket.addEventListener('open', () => {
  console.log('Connected');

  // Subscribe to feeds
  socket.send(JSON.stringify({ type: 'subscribe', feed_category: 'crypto' }));
  socket.send(JSON.stringify({ type: 'subscribe', feed_category: 'ai_agents' }));
});

socket.addEventListener('message', (event) => {
  const message = JSON.parse(event.data);

  switch (message.type) {
    case 'data':
      console.log('New item:', message.content.signal);
      break;
    case 'subscribed':
      console.log(`Subscribed to ${message.feed_category}`);
      break;
    case 'error':
      console.error('Error:', message.error);
      break;
    case 'ping':
      socket.send(JSON.stringify({ type: 'pong', timestamp: message.timestamp }));
      break;
  }
});

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

Status Codes

Code	Description
`200`	Success
`400`	Bad Request (invalid parameters)
`401`	Unauthorized (missing or invalid token)
`402`	Payment Required (x402 only)
`403`	Forbidden (token lacks permission for requested feed)
`404`	Not Found (no data for specified parameters)
`500`	Internal Server Error

Authentication​

API Token (Recommended)​

Wallet Authentication​

Public Token​

Feed Permissions​

News API​

GET /news​

Query Parameters​

Response Format​

Response Fields​

Status Codes​

Example Requests​

GET /news/{id}​

GET /news-ticker-summary​

Query Parameters​

Example​

Response​

Recaps API​

GET /recaps​

Query Parameters​

Recap Timeframes by Category​

Response Format​

Response Fields​

Example Requests​

Narratives API​

GET /narratives​

Response Format​

Response Fields​

GET /narratives/{id}​

Articles API​

GET /articles​

Query Parameters​

Response Format​

GET /articles/{article_id}​

Feed Categories​

GET /available-feed-categories​

Response​

News WebSocket API​

Overview​

Connection​

Client to Server Messages​

Subscribe to a Feed​

Unsubscribe from a Feed​

Server to Client Messages​

Welcome Message​

Data Message​

Error Message​

Ping/Pong​

Message Types​

Connection Lifecycle​

Error Handling​

Client Example (JavaScript)​

Status Codes​

Authentication

API Token (Recommended)

Wallet Authentication

Public Token

Feed Permissions

News API

GET /news

Query Parameters

Response Format

Response Fields

Status Codes

Example Requests

GET /news/{id}

GET /news-ticker-summary

Query Parameters

Example

Response

Recaps API

GET /recaps

Query Parameters

Recap Timeframes by Category

Response Format

Response Fields

Example Requests

Narratives API

GET /narratives

Response Format

Response Fields

GET /narratives/{id}

Articles API

GET /articles

Query Parameters

Response Format

GET /articles/{article_id}

Feed Categories

GET /available-feed-categories

Response

News WebSocket API

Overview

Connection

Client to Server Messages

Subscribe to a Feed

Unsubscribe from a Feed

Server to Client Messages

Welcome Message

Data Message

Error Message

Ping/Pong

Message Types

Connection Lifecycle

Error Handling

Client Example (JavaScript)

Status Codes