# getnews.tech / news.nexaeos.io - Real-Time Global News Engine

> Clean, aggregated global news headline API running on air-gapped high-availability Nexaeos infrastructure. Optimized for terminal users, LLMs, and autonomous research agents.

## Machine Access & Formats
- Terminal / Plaintext: Default for curl requests (`User-Agent: curl/*`).
- Markdown for LLMs: Supply `Accept: text/markdown` with requests to receive token-dense, clean Markdown formatted for context window ingestion.
- Structured JSON: Supply `Accept: application/json` to receive structured article arrays with sources, timestamps, and shortened URLs.

## x402 Micropayment Policy for Autonomous Agents
- Rate Limiting / Fair Use: Automated crawlers, AI scraping bots, and commercial agents access this API via the x402 Payment Required protocol.
- Cost: 0.01 USDC per request on the Base network (Chain ID: 8453).
- Asset: USDC (`0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913`).
- Payment Recipient: `0xf678BCCeb109BC31eBe2cBb0b176d7b40e1f7054`.
- Payment Header: Send the 64-character transaction hash or signed voucher via `X-Payment: <txHash>` or `Payment-Response: <txHash>` or cookie `x402_receipt=<txHash>`.
- Machine Descriptor: `/.well-known/x402.json`
- OpenAPI Specification: `/.well-known/openapi.yaml`

## Core Query Endpoints
- `/`: Top global general headlines.
- `/technology`: Technology and engineering news.
- `/business`: Markets, finance, and commerce news.
- `/science`: Scientific discoveries and space exploration.
- `/health`: Medicine, healthcare, and biotech news.
- `/<query>`: Free-text search (e.g. `/space+exploration,n=20`).
- `/:help`: Terminal parameter documentation and valid country codes.