augur-trade-com 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 calls/day with header X-Synapse-Free: 1. Everything is read-only; pump.fun data is our own recording of every 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 always free.'
  contact:
    url: https://augur-trade.com/hub
    email: https://augur-trade.com/hire/
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: 'Full bonding-curve forensics for one pump.fun mint: flow, dev buys/sells, launch snipers, top curve holders, peak, graduation, red flags. Aggregates every recorded curve trade of the token: unique wallets, buy/sell SOL, first-60-second flow, whether the dev sold out, non-dev wallets that bought in the launch slots (bundles), top net holders on the curve, peak market cap and post-graduation liquidity.'
      tags:
      - Pump Cortex
      x-price-usd: 0.01
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.01'
        protocols:
        - x402:
            networks:
            - solana
            - base
            assets:
            - USDC
            - SOL
            payTo:
              solana: RfmsJN8mYvE5Ggjc4yE8i3w5deZEUgRie6W6xehif6R
              base: '0x538d1D8257C6001d7e432c90C6abc658948d7441'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - mint
              properties:
                mint:
                  type: string
                  pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
                  description: pump.fun token mint. Base58 Solana address, 32-44 chars.
              additionalProperties: false
            example:
              mint: 2L2eDWq1G6YhREhEdnsGLxMLoWKH2AjgwmL3og42pump
      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_wallet:
    post:
      operationId: pump_wallet
      summary: pump.fun wallet profile
      description: 'Any wallet''s pump.fun trading record: realized PnL, win rate, hold time, frequency (bot or human), tokens it launched. Analyses up to the last 20,000 curve trades of the wallet. Use it to judge whether a wallet is smart money, a sniper bot, a serial dumper or a dev.'
      tags:
      - Pump Cortex
      x-price-usd: 0.01
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.01'
        protocols:
        - x402:
            networks:
            - solana
            - base
            assets:
            - USDC
            - SOL
            payTo:
              solana: RfmsJN8mYvE5Ggjc4yE8i3w5deZEUgRie6W6xehif6R
              base: '0x538d1D8257C6001d7e432c90C6abc658948d7441'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - wallet
              properties:
                wallet:
                  type: string
                  pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
                  description: wallet address. Base58 Solana address, 32-44 chars.
                limit:
                  type: integer
                  minimum: 100
                  maximum: 20000
                  default: 20000
                  description: How many of the wallet's most recent recorded trades to analyse. Range 100-20000. Default 20000.
              additionalProperties: false
            example:
              wallet: BwWK17cbHxwWBKZkUYvzxLcNQ1YVyaFezduWbtm2de6s
      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_dev:
    post:
      operationId: pump_dev
      summary: pump.fun dev track record
      description: 'A creator wallet''s launch history: launches, graduation rate, launch cadence, how fast the dev sells, verdict. Looks up every token the wallet created since recording began and replays the dev''s own trades on its 15 most recent launches.'
      tags:
      - Pump Cortex
      x-price-usd: 0.01
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.01'
        protocols:
        - x402:
            networks:
            - solana
            - base
            assets:
            - USDC
            - SOL
            payTo:
              solana: RfmsJN8mYvE5Ggjc4yE8i3w5deZEUgRie6W6xehif6R
              base: '0x538d1D8257C6001d7e432c90C6abc658948d7441'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - creator
              properties:
                creator:
                  type: string
                  pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
                  description: creator (dev) wallet. Base58 Solana address, 32-44 chars.
              additionalProperties: false
            example:
              creator: AbsisGdsxyHA7MueN1kZCTpBcGzMVw1F5qQZgnBWFERo
      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_odds:
    post:
      operationId: pump_odds
      summary: Graduation odds
      description: Probability a pump.fun launch graduates, from how comparable launches in our tape actually ended — with the lift over the ~3% base rate. Buckets the launch's first 60 seconds (unique buyers, buy SOL, dev buy) and returns the empirical graduation rate of thousands of comparable recent launches whose outcome is known, shrunk toward coarser buckets when samples are thin. Rebuilt every 6 hours.
      tags:
      - Pump Cortex
      x-price-usd: 0.01
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.01'
        protocols:
        - x402:
            networks:
            - solana
            - base
            assets:
            - USDC
            - SOL
            payTo:
              solana: RfmsJN8mYvE5Ggjc4yE8i3w5deZEUgRie6W6xehif6R
              base: '0x538d1D8257C6001d7e432c90C6abc658948d7441'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - mint
              properties:
                mint:
                  type: string
                  pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
                  description: pump.fun token mint. Base58 Solana address, 32-44 chars.
              additionalProperties: false
            example:
              mint: 2L2eDWq1G6YhREhEdnsGLxMLoWKH2AjgwmL3og42pump
      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/smart_money:
    post:
      operationId: smart_money
      summary: Smart money on pump.fun
      description: The pump.fun wallets with the best realized PnL in the last 24 h — and the tokens those wallets are buying right now. Leaderboard of wallets by realized profit on fully-closed curve positions (min 8 closed, rebuilt every 30 min), sortable by PnL, win rate or ROI, plus a live feed of what the top 50 bought in the last N minutes, ranked by how many of them piled in.
      tags:
      - Pump Cortex
      x-price-usd: 0.02
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.02'
        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 top wallets to return. Range 1-50. Default 20.
                window_min:
                  type: integer
                  minimum: 1
                  maximum: 120
                  default: 15
                  description: look-back for buying_now. Range 1-120. Default 15.
                sort:
                  type: string
                  pattern: ^(pnl|win_rate|roi)$
                  default: pnl
                  description: Rank by realized PnL in SOL ("pnl"), win rate ("win_rate") or return on SOL spent ("roi"). Default "pnl".
                exclude_bots:
                  type: boolean
                  default: false
                  description: drop sub-20-second and high-frequency wallets. Default false.
              additionalProperties: false
            example:
              limit: 10
              window_min: 15
              sort: pnl
              exclude_bots: true
      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/copy_backtest:
    post:
      operationId: copy_backtest
      summary: Copy-trade backtest
      description: 'Would copying this wallet have made money? Replays its pump.fun entries and exits 0–25 slots late on the recorded curve and shows where the edge dies. Takes the wallet''s pump.fun positions over the last 1–14 days and simulates a copier that buys the same token and sells when the leader sells, arriving 0, 1, 2, 5, 10 or 25 slots (0–10 s) late. Fills use the bonding-curve reserves our tape recorded at that moment, including curve fees and the copy''s own price impact. Returns PnL, win rate and ROI per latency, the leader''s own median ROI for contrast, and a verdict: copyable, latency-sensitive (edge gone by N slots), or not copyable. A wallet that looks great on its own PnL often loses money for anyone who follows it.'
      tags:
      - Pump Cortex
      x-price-usd: 0.03
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.03'
        protocols:
        - x402:
            networks:
            - solana
            - base
            assets:
            - USDC
            - SOL
            payTo:
              solana: RfmsJN8mYvE5Ggjc4yE8i3w5deZEUgRie6W6xehif6R
              base: '0x538d1D8257C6001d7e432c90C6abc658948d7441'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - wallet
              properties:
                wallet:
                  type: string
                  pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
                  description: leader wallet to copy. Base58 Solana address, 32-44 chars.
                days:
                  type: integer
                  minimum: 1
                  maximum: 14
                  default: 3
                  description: How many days of the wallet's history to replay. Range 1-14. Default 3.
                size_sol:
                  type: number
                  minimum: 0.01
                  maximum: 10
                  default: 0.1
                  description: SOL per copied entry. Range 0.01-10. Default 0.1.
                exit:
                  type: string
                  pattern: ^(first_sell|full_exit)$
                  default: first_sell
                  description: sell on the leader's first sell, or once it has sold 90%. Default "first_sell".
                max_positions:
                  type: integer
                  minimum: 10
                  maximum: 300
                  default: 150
                  description: most recent positions to replay. Range 10-300. Default 150.
              additionalProperties: false
            example:
              wallet: HNhuE4Y3RNCx5tPBkNsCTWKT14542NxnGi9aXEyN1x8E
              days: 3
              size_sol: 0.1
      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)
components:
  securitySchemes:
    creditKey:
      type: apiKey
      in: header
      name: Authorization
      description: Bearer hk_… prepaid credit key (POST /hub/api/v1/keys). Paid tools also accept it instead of x402.