Ecosystem Intelligence
v2 guarantees
- Every response includes
apiVersion: 2 - Endpoints are chain-aware via optional
?chain=... - Error shape is stable enough for unattended clients
Base URL
- Local:
http://localhost:3000 - Production:
https://<your-api-host>
All endpoints below live under the /v2 prefix on that host.
Chain parameter
Optional query chain. Invalid values fall back to arbitrum.
| Value | Scope |
|---|---|
arbitrum | Default if omitted |
ethereum | Ethereum ecosystem |
base | Base ecosystem |
avalanche | Avalanche ecosystem |
Skill: fetch_ecosystem_signals
Low-cost polling and alerting. Latest signal snapshot (or empty state).
GET /v2/signals/latest?chain=arbitrum
Status: 200 + signal object, 200 + signal: null, or 500.
Full schema and JSON examples are in skills.md.
Skill: fetch_ecosystem_stories
Narrative context without calling chat.
GET /v2/stories?chain=arbitrum
GET /v2/stories?chain=arbitrum&limit=10
limit optional, integer 1..50, default 10. Paid tier allows up to 100.
Autonomous client (recommended)
- Poll signals every
5–15min; stories every10–30min - Dedupe signals with
(chain, signal_date, updated_at); stories with(chain, headline, created_at) - Retry only
5xxand network timeouts; backoff2s→16s; never retry400unchanged
Authentication
- Free v2 GET endpoints: no Firebase auth or API keys (enforce rate limits at your gateway)
- Paid v2: x402 USDC payments instead of an API key
Paid endpoints (x402)
Production access: pay per request in USDC on Base mainnet (eip155:8453) via the Coinbase CDP x402 facilitator — no account registration.
Install the wallet skill (once):
npx skills add coinbase/agentic-wallet-skills
Flow: agent sends GET → 402 Payment Required (PAYMENT-REQUIRED header) → retry with PAYMENT-SIGNATURE → 200.
| Endpoint | Price | Notes |
|---|---|---|
GET /v2/paid/signals/latest |
$0.001 USDC | Same shape as free signals |
GET /v2/paid/stories |
$0.002 USDC | limit up to 100 |
GET /v2/paid/digest/todayGET /v2/paid/digest/week |
$0.003 USDC | Daily / weekly digest narrative |
Examples:
GET /v2/paid/digest/today?chain=arbitrum
GET /v2/paid/digest/week?chain=base
Discovery (agentic.market)
Auto-indexed on agentic.market after the first paid call settles.
GET https://api.agentic.market/v1/services/search?q=ecosystem
Source of truth
- Contract & examples: repo root
skills.md - Free routes:
src/routes/v2/agentRoutes.ts - Paid routes:
src/routes/v2/paidRoutes.ts - x402 config:
src/services/v2/x402Config.ts