maddegen-art Pump Cortex API

openapi: 3.2.0
info:
  title: A.U.G.U.R Foresight — agent tool exchange Pump Cortex API
  version: 3.0.0
  x-guidance: 'Call any tool with POST https://augur-trade.com/hub/api/v1/tools/{id} and a JSON body matching its schema. Paid tools answer HTTP 402 with x402 payment requirements (Solana: USDC TransferChecked or native SOL to the payTo address; the exchange is its own facilitator and pays the network fee). Sign the transfer, retry with X-PAYMENT (v1) or PAYMENT-SIGNATURE (v2) and you get the result plus a settlement receipt; you are only charged if the tool answered. Alternatives: a prepaid credit key (Authorization: Bearer hk_…) or X-PAYMENT-TX with a signature you already sent. Free tools need no payment; 10 free paid-tool calls/day with header X-Synapse-Free: 1. Everything is read-only; pump.fun data is our own recording of every bonding-curve trade since 2026-09-11, other data comes from the providers listed in llms.txt, cached and paced so callers never see their rate limits.'
  description: 'A tool exchange for AI agents, run by an AI (A.L.F). 79 read-only tools: crypto markets and DeFi on every chain (prices, TVL, yields, stablecoins, perps funding, order books, gas, EVM contracts and token security), Solana and pump.fun intelligence from our own live recording of every bonding-curve trade, launch bundle forensics on Solana and 18 EVM chains (who bundled it, insiders, airdrops, serial devs), Meteora DLMM liquidity, reading and inspecting the web (clean page text, PDFs, DNS, WHOIS, TLS, robots), research (Wikipedia, arXiv, packages and CVEs, GitHub, Hacker News, DOIs, books), the physical world (weather, geocoding, FX, holidays, time zones, countries, earthquakes, sun/moon) and exact local utilities (QR, hashing, JSON Schema, cron, diff, units, JWT). MCP + HTTP. Pay per call via x402 in USDC or SOL on Solana or USDC on Base, or with prepaid credits. 10 free paid-tool calls per day; free tools are only free.'
  contact:
    url: https://augur-trade.com/hub
    email: agent@augur-trade.com
servers:
- url: https://augur-trade.com
tags:
- name: Pump Cortex
paths:
  /hub/api/v1/tools/pump_pulse:
    post:
      operationId: pump_pulse
      summary: pump.fun market pulse
      description: 'Live pump.fun heartbeat: trades/min, launches, graduations, graduation rate, hottest tokens in the last 15 min. Computed from our own live recording of every pump.fun bonding-curve trade. Use it to decide whether the launch market is hot or dead before scanning individual tokens.'
      tags:
      - Pump Cortex
      x-price-usd: 0
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties: {}
              additionalProperties: false
            example: {}
      responses:
        '200':
          description: 'ok: {ok, tool, ms, billing, data}'
        '400':
          description: invalid arguments
  /hub/api/v1/tools/pump_history:
    post:
      operationId: pump_history
      summary: pump.fun history
      description: 'pump.fun over time: launches, graduations, graduation rate, trades, SOL volume and unique wallets per day or hour since 2026-09-11 — with a compare window. The same tape as pump_pulse, sliced into UTC days or hours so an agent can compare the market over time instead of reading one snapshot. Pass compare_from/compare_to to get a second window and the per-period change (e.g. this week vs last week). Closed periods are precomputed from our own live recording of every bonding-curve trade; the open period is marked partial. Also reports the share of trades made by pump.fun''s own mayhem agent, so it can be separated from real demand.'
      tags:
      - Pump Cortex
      x-price-usd: 0
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                granularity:
                  type: string
                  pattern: ^(day|hour)$
                  default: day
                  description: 'Bucket size: "day" or "hour". Default "day".'
                from:
                  type: string
                  pattern: ^\d{4}-\d{2}-\d{2}(T\d{2}(:\d{2}){0,2}Z?)?$
                  description: 'UTC start, e.g. 2026-09-18 or 2026-09-18T06 (default: 14 days / 48 hours back)'
                to:
                  type: string
                  pattern: ^\d{4}-\d{2}-\d{2}(T\d{2}(:\d{2}){0,2}Z?)?$
                  description: 'UTC end, inclusive (default: now)'
                compare_from:
                  type: string
                  pattern: ^\d{4}-\d{2}-\d{2}(T\d{2}(:\d{2}){0,2}Z?)?$
                  description: start of a second window to compare against
                compare_to:
                  type: string
                  pattern: ^\d{4}-\d{2}-\d{2}(T\d{2}(:\d{2}){0,2}Z?)?$
                  description: end of the comparison window, inclusive
              additionalProperties: false
            example:
              granularity: day
              from: '2026-09-19'
              to: '2026-09-25'
              compare_from: '2026-09-12'
              compare_to: '2026-09-18'
      responses:
        '200':
          description: 'ok: {ok, tool, ms, billing, data}'
        '400':
          description: invalid arguments
  /hub/api/v1/tools/pump_launches:
    post:
      operationId: pump_launches
      summary: Newest pump.fun launches
      description: The newest pump.fun tokens with dev buy, early buyers/volume, curve progress, market cap and creator launch count. Returns up to 50 of the most recent launches (seconds old) with the first-N-seconds flow already aggregated, so an agent can shortlist without replaying the chain.
      tags:
      - Pump Cortex
      x-price-usd: 0.002
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.002'
        protocols:
        - x402:
            networks:
            - solana
            - base
            assets:
            - USDC
            - SOL
            payTo:
              solana: RfmsJN8mYvE5Ggjc4yE8i3w5deZEUgRie6W6xehif6R
              base: '0x538d1D8257C6001d7e432c90C6abc658948d7441'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                limit:
                  type: integer
                  minimum: 1
                  maximum: 50
                  default: 20
                  description: How many of the newest launches to return. Range 1-50. Default 20.
                window_s:
                  type: integer
                  minimum: 30
                  maximum: 3600
                  default: 300
                  description: early-flow window after creation. Range 30-3600. Default 300.
              additionalProperties: false
            example:
              limit: 10
              window_s: 120
      responses:
        '200':
          description: 'ok: {ok, tool, ms, billing, data}'
        '400':
          description: invalid arguments
        '402':
          description: Payment Required (x402 v1 body + v2 PAYMENT-REQUIRED header; USDC or SOL on Solana)
  /hub/api/v1/tools/pump_token:
    post:
      operationId: pump_token
      summary: pump.fun token forensics
      description: '...'
      tags:
      - Pump Cortex
      x-price-usd: 0.03
      responses:
        '200':
          description: ok