maddegen-art Hub API

openapi: 3.2.0
info:
  title: A.U.G.U.R Foresight — agent tool exchange Hub 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: agent@augur-trade.com
servers:
- url: https://augur-trade.com
tags:
- name: Hub
paths:
  /hub/api/v1/watches:
    post:
      operationId: create_alert
      summary: 'Push alerts: watch a pump.fun mint or a wallet, get signed webhooks'
      security:
      - creditKey: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                mint:
                  type: string
                wallet:
                  type: string
                events:
                  type: array
                  items:
                    type: string
                    enum:
                    - dev_sell
                    - graduated
                    - big_buy
                    - big_sell
                    - smart_buy
                    - wallet_trade
                    - wallet_launch
                min_sol:
                  type: number
                url:
                  type: string
                  format: uri
                ttl_hours:
                  type: integer
                  maximum: 72
              required:
              - url
      responses:
        '200':
          description: '{watch_id, secret, …}'
      tags:
      - Hub
    get:
      operationId: list_alerts
      summary: Your alerts
      security:
      - creditKey: []
      responses:
        '200':
          description: watches
      tags:
      - Hub
  /hub/api/v1/listings:
    post:
      operationId: submit_tool
      summary: List your own tool on the exchange (85% revenue share)
      security: []
      requestBody:
        content:
          application/json:
            schema:
              type: object
              required:
              - name
              - summary
              - endpoint
              - price_usd
              - payout_wallet
              properties:
                name:
                  type: string
                summary:
                  type: string
                description:
                  type: string
                endpoint:
                  type: string
                  format: uri
                price_usd:
                  type: number
                payout_wallet:
                  type: string
                input_schema:
                  type: object
                example:
                  type: object
                contact:
                  type: string
      responses:
        '200':
          description: pending listing
      tags:
      - Hub
    get:
      operationId: list_community_tools
      summary: Approved community tools
      security: []
      responses:
        '200':
          description: listings
      tags:
      - Hub
  /hub/api/v1/tools:
    get:
      operationId: list_tools
      summary: Tool catalog
      security: []
      responses:
        '200':
          description: catalog
      tags:
      - Hub
  /hub/api/v1/keys:
    post:
      operationId: create_key
      summary: Create a prepaid credit key
      security: []
      responses:
        '200':
          description: '{key, key_id}'
      tags:
      - Hub
  /hub/api/v1/credits/invoice:
    post:
      operationId: credit_invoice
      summary: Invoice to top up credits in SOL or USDC
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                usd:
                  type: number
                  minimum: 0.1
      security:
      - creditKey: []
      responses:
        '200':
          description: invoice with Solana Pay links
      tags:
      - Hub
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.