129 lines (102 loc) · 4.31 KB

Technical Validation Report

Generated: 2026-02-20 Source: Agent Zero API testing + codebase analysis

API Health — api.pump.studio

Endpoints Tested

Endpoint	Status	Response
`GET /health`	200 OK	Health check passing
`GET /api/v1/overview`	200 OK	Returns platform overview data
`GET /api/v1/datapoint?mint=<address>`	200 OK	Returns 71-field token snapshot
`GET /api/v1/graduating?limit=1`	200 OK	Returns tokens approaching graduation
`GET /status`	200 OK	System status
`GET /api/v1/live`	Unstable	Returns empty/malformed data — needs investigation
`GET /api/v1/market`	NDJSON	Returns newline-delimited JSON (not standard JSON)

Critical Finding: /api/v1/live

Endpoint exists but returns inconsistent data
May need WebSocket connection instead of HTTP GET
Action Required: Investigate and fix before demo streams

Critical Finding: /api/v1/market

Returns NDJSON format (newline-delimited JSON)
Standard JSON.parse() will fail on this
Need streaming/line-by-line parser
Action Required: Document this format in API docs or switch to standard JSON

Product Infrastructure

Frontend — pump.studio

Framework: Next.js (inferred from deployment patterns)
Auth: Privy SDK integration
Real-time: Convex reactive subscriptions
Streaming: Livekit integration for live streams
Status: Landing page live at join.pump.studio

Backend — api.pump.studio

20+ REST endpoints confirmed live
71-field DataPoint model per token snapshot
Convex backend with reactive subscriptions
Helius RPC for Solana data

MCP Server

12 tools for Claude Code and Cursor integration
First MCP Server in the pump.fun ecosystem
Tools include: token lookup, price check, holder analysis, creator fee tracking, etc.
Status: Built, needs public documentation for hackathon visibility

Agent Infrastructure

Skill API — Agents register, authenticate, submit analysis
XP Leaderboard — Reputation system for agent-submitted analysis
Verified on-chain analysis — Agents prove their analysis against actual chain data
Status: Core loop functional

Codebase Architecture

agent-zero (this repo)

War room operations, X monitoring, intel synthesis
TypeScript, tsx runner, GitHub Actions CI/CD
X API integration tracking 17 accounts

agent-dex (companion repo)

Full social DEX for AI agents
Express.js + SQLite + Next.js frontend
Token trading, portfolio management, social features
Agent-to-agent interaction layer

pumpstudio-agent (companion repo)

Deterministic token analyzer MVP
Fetches DataPoint snapshots from api.pump.studio
Computes scores and risk assessments
Submits analysis to XP leaderboard

X API Integration (twitterapi.io)

Validated Schema

Base URL: https://api.twitterapi.io
Auth: X-API-Key header
Rate limit: 200 QPS
Pricing: ~$0.15/1000 tweets
Response format: JSON with data.tweets nested array (not top-level)
Pagination: cursor-based, pass cursor="" for first page

Endpoints Confirmed Working

Endpoint	Purpose
`/twitter/user/last_tweets`	Get user's recent tweets
`/twitter/tweet/advanced_search`	Search with query syntax
`/twitter/user/info`	User profile data
`/twitter/user/mentions`	Get mentions of a user

Known Issues (Fixed)

Response wraps tweets in data.tweets, not top-level tweets
Status field is string "success", not numeric
Message field is message or msg (API uses both)
Empty cursor "" required for first page request

Infrastructure Monitoring

GitHub Actions Workflows

X Monitor — Every 30 minutes
- Fetches tweets from 17 accounts across 3 priority tiers
- Classifies signals into 5 categories
- Triggers Grok analysis on critical alerts
- Caches state between runs
Daily War Room Report — 6 AM UTC daily
- Runs intel synthesizer
- Generates AI strategic brief via Grok
- Checks api.pump.studio health
- Auto-commits reports

Secrets Required

Secret	Purpose	Status
`X_API_KEY`	twitterapi.io auth	Configured
`OPENROUTER_API_KEY`	Grok via OpenRouter	Pending