x402 Integration

Gloria X402 API is a micropayment-enabled news API that leverages the X402 protocol to provide access to news feeds.

Endpoint

GET /news

Query Parameters

Parameter	Type	Description
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.

Available Feeds

See Available Feeds section in REST API.

Response Format

See Response Format section in REST API.

Status Codes

Status Code	Description
200	Success
400	Bad Request (invalid parameters)
402	Payment required
404	Not Found (no data found for the specified parameters)

Payment Integration

X402 Protocol

The API uses the X402 protocol for micropayments. Each request to the /news endpoint requires a payment to proceed. It currently costs $0.01 USDC per request.

Payment Flow

1. Client makes request to /news endpoint

2. Server responds with payment challenge (402 Payment Required)

3. Client processes payment using X402 protocol

4. Client retries request with payment proof

5. Server validates payment and serves content

Currently, only payments in USDC on Base network are supported. More coming soon.

Client Implementation

You can find more information on how to implement the client on x402.gitbook.io.

Example Implementation

import { withPaymentInterceptor } from "x402-axios";
import axios from "axios";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount("0x...");

const api = withPaymentInterceptor(
    axios.create({
        baseURL: "https://api.itsgloria.ai",
    }),
    account,
);

const response = await api.get("/news");