GIE API Documentation

Free endpoints return market intelligence directly. Paid endpoints require x402 payment — your agent pays /usr/bin/bash.10 USDC on Base mainnet automatically. No API keys, no accounts.

Quick Start

Free — curl example

# Get build signals for this week
curl https://tractor-polyphonic-theaters-dublin.trycloudflare.com/gie/build_signal

# Get mechanic biography with sparkline
curl https://tractor-polyphonic-theaters-dublin.trycloudflare.com/gie/mechanic/puzzle/biography

x402 Paid — Python example

import httpx
from x402_client import pay_and_fetch  # any x402-capable client

response = pay_and_fetch(
    "https://tractor-polyphonic-theaters-dublin.trycloudflare.com/gie/trends",
    wallet_private_key="0x...",
    chain_id=8453,  # Base mainnet
)
print(response.json())

Free Endpoints

GET/gie/build_signalFREE

Scored what-to-build verdict per mechanic with 7-day conviction tracking and triple-convergence detection. Returns BUILD NOW / BUILD SOON / WATCH / WAIT verdicts with signal drivers and streak counts.

GET/gie/momentum_shiftsFREE

Direction-of-change signals — ACCELERATING, COOLING, EMERGING per mechanic from 14-day verdict history. Catches roguelike before the charts confirm it.

GET/gie/mechanic/{mechanic}/biographyFREE

14-day posture trajectory, stability score, conviction streak, and sparkline SVG for any mechanic. Try: /gie/mechanic/puzzle/biography

GET/gie/mechanic/{mechanic}/biography/htmlFREE

Rich HTML biography page with sparkline chart, KPI cards, and trajectory table. Shareable link for any mechanic.

GET/gie/rising_starsFREE

Mobile rank velocity — top rising titles per category over 6 days. Includes iTunes ratings and price badges.

GET/gie/posture_gradesFREE

Engine track record — 59% overall posture accuracy, 96% CONVERGENT hit rate, 86% EARLY lead rate. Backtest data.

GET/steam/trendsFREE

Steam top-100 mechanic trends with mobile crossover detection.

Paid Endpoints — x402 /usr/bin/bash.10 USDC

GET/gie/trends/usr/bin/bash.10 x402

Full mobile mechanic trend signals: hot/rising/saturated lists, directional posture (CONVERGENT/PROVEN/EARLY), market weight scores. Updated daily from 86k+ title rank timeseries.

GET/gie/mechanic_heat/usr/bin/bash.10 x402

Ranked per-mechanic heat scores by composite market signal weight. Used internally by the build signal engine.

MCP Integration

# Server card (for Smithery / MCP registry)
curl https://tractor-polyphonic-theaters-dublin.trycloudflare.com/.well-known/mcp/server-card.json