# Engedi — AI Agent Data API

> The hidden oasis in the data desert.

Live data API for AI agents. 9 free endpoints + 42 paid endpoints (51 total).
Covers finance, travel, weather, location, news, commerce, knowledge, content, and agent utilities.

## Quick Start

1. Hit any free endpoint: GET /api/weather?location=London
2. No API key needed for free endpoints
3. Paid endpoints: include PAYMENT-SIGNATURE header with x402 payment proof

## Base URL

https://engedi.digi-life17.workers.dev

## Response Format

Every response includes success boolean and _meta object with source, confidence, last_updated, cached.
Every error includes success:false and error object with code, message, retryable.

## Anti-Copy Protection

Every response includes:
- X-Engedi-Watermark: unique per-request identifier
- X-Engedi-Fingerprint: client identity hash
- X-Engedi-License: Proprietary — see /terms

Unauthorized copying, redistribution, or training on this data is prohibited.

## Payment (x402)

Paid endpoints use x402 protocol. Send USDC on Base, Polygon, Arbitrum, Avalanche, Sei, or Solana.
Include payment proof in PAYMENT-SIGNATURE header.
Facilitators: PayAI + Primev

## Free Endpoints

GET /api/weather — Current weather (location required)
GET /api/news — Headlines from BBC, NYT, Arstechnica
GET /api/hacker-news — Hacker News top stories
GET /api/stocks — Real-time stock prices (symbol required)
GET /api/movies — Movie search with ratings (query required)
GET /api/translate/languages — List supported languages
GET /api/crypto — Crypto prices and market data (coin required)
GET /api/geoip — IP geolocation with ASN/ISP detection
GET /api/country-info — Country data: capital, population, languages

## Paid Endpoints ($0.001-$0.10)

Finance: exchange-rates $0.005, stock-news $0.01
Location: timezones $0.005, holidays $0.005, geocoding $0.005
Environment: weather-forecast $0.005, sunrise $0.005, earthquakes $0.01, air-quality $0.01
Content: url-metadata $0.01, screenshots $0.05, screenshot-live $0.002, news-search $0.01, reader $0.001
Knowledge: translate $0.005, wikipedia $0.005, urbandict $0.005, books $0.005, joke $0.001, catfact $0.001, fact-check $0.005
Travel: flights $0.10, hotels $0.10
Commerce: products $0.05
Work: jobs $0.05
Local: restaurants $0.05
Education: courses $0.05
Property: real-estate $0.10
Agent Utilities: domain-check $0.001, url-safety $0.001, change-detect $0.003, extract-data $0.003, detect-language $0.001, ai-detect $0.003, license-check $0.001

## Examples

GET https://engedi.digi-life17.workers.dev/api/weather?location=London
GET https://engedi.digi-life17.workers.dev/api/crypto?coin=bitcoin
GET https://engedi.digi-life17.workers.dev/api/domain-check?domain=example.com
GET https://engedi.digi-life17.workers.dev/api/ai-detect?text=Your+text+here
GET https://engedi.digi-life17.workers.dev/api/license-check?package=express&projectLicense=MIT

## Discovery

GET /api — Machine-readable endpoint catalog
GET /.well-known/mcp.json — MCP server manifest
GET /.well-known/openapi.json — OpenAPI 3.0 spec
GET /health — Health check with uptime

## Legal

This API is proprietary. See /terms for usage restrictions.
Scraping, redistributing, or training on this data is prohibited.