Introduction

Welcome to the Base Screener API

Introduction

Base Screener is the first agent-native GraphQL token screener on Base, with x402 micropayments baked into the transport layer.

Designed specifically for autonomous AI agents, it provides pure structured data for token discovery, risk analysis, and market screening — monetized via x402 micropayments (USDC on Base, gasless via Permit2).

Why Base Screener?

Agent-Native — Built from the ground up to be consumed by AI agents via GraphQL, with machine-readable schema at /schema and agent docs at /llms.txt
No Subscriptions — No API keys or monthly plans required for production. Pay per query in USDC, exactly what the data costs
Deep Risk Analysis — Real-time honeypot detection, mintable token checks, contract verification status, and holder distribution analysis
Multi-DEX Coverage — Indexes token launches from Uniswap V2, V3, V4, and Aerodrome on Base
Real-Time Data — Goldsky subgraph indexing for instant token/pair discovery, DexScreener pricing every 10 minutes, risk scoring every 5 minutes

Supported data

Data type	Source	Update frequency
New tokens & pairs	Goldsky Subgraph	Real-time
Price, volume, liquidity	DexScreener API	Every 10 minutes
Risk scores	Honeypot.is + Basescan	Every 5 minutes
Holder data	Basescan APIs	Every 6 hours

Architecture

Agent → POST /graphql → x402 Payment Check → GraphQL Resolver → Neon Postgres → Response
                ↑                                                        ↑
         Coinbase Facilitator                              Goldsky + DexScreener + Honeypot.is
          (Permit2 settlement)                              (async data pipeline)

Quick links

Quickstart — Make your first query in 5 minutes
Pricing — Understand query costs
Playground — Test queries for free
Schema reference — Full API docs
llms.txt — Machine-readable API description for AI agents