augur-trade-com Market Stem API

openapi: 3.2.0
info:
  title: A.U.G.U.R Foresight — agent tool exchange Market Stem 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: Market Stem
paths:
  /hub/api/v1/tools/price:
    post:
      operationId: price
      summary: Token prices
      description: 'USD price, 24h change and liquidity for up to 100 Solana mints; flags illiquid (dead) tokens. Jupiter price data with a liquidity floor: anything under $1,000 of liquidity is flagged dead, because round-trip quotes on dead curves look fine and are not.'
      tags:
      - Market Stem
      x-price-usd: 0
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - mints
              properties:
                mints:
                  type: array
                  items:
                    type: string
                    pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
                    description: mint
                  minItems: 1
                  maxItems: 100
                  description: Solana token mint addresses (base58) to price. 1-100 items.
              additionalProperties: false
            example:
              mints:
              - So11111111111111111111111111111111111111112
              - JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN
      responses:
        '200':
          description: 'ok: {ok, tool, ms, billing, data}'
        '400':
          description: invalid arguments
  /hub/api/v1/tools/wallet_holdings:
    post:
      operationId: wallet_holdings
      summary: Wallet holdings
      description: Everything a Solana wallet holds — SOL, SPL and Token-2022 tokens — valued in USD and sorted by value. Reads token accounts from both token programs and prices them in one pass. Empty accounts are counted as reclaimable rent.
      tags:
      - Market Stem
      x-price-usd: 0.003
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.003'
        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.
              additionalProperties: false
            example:
              wallet: 86xCnPeV69n6t3DnyGvkKobf9FdN2H9oiVDdaMpo2MMY
      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/tx_explain:
    post:
      operationId: tx_explain
      summary: Explain a transaction
      description: 'Turns any Solana transaction signature into plain facts: status, fee, programs by name, SOL and token balance changes per owner, a one-line summary. Works for swaps, pump.fun trades, LP moves, transfers and failures (includes the error log lines).'
      tags:
      - Market Stem
      x-price-usd: 0.003
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.003'
        protocols:
        - x402:
            networks:
            - solana
            - base
            assets:
            - USDC
            - SOL
            payTo:
              solana: RfmsJN8mYvE5Ggjc4yE8i3w5deZEUgRie6W6xehif6R
              base: '0x538d1D8257C6001d7e432c90C6abc658948d7441'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - signature
              properties:
                signature:
                  type: string
                  pattern: ^[1-9A-HJ-NP-Za-km-z]{64,90}$
                  description: Solana transaction signature (base58, 64-90 chars).
              additionalProperties: false
            example:
              signature: 4e1vcgjBw2yfNTzGSneQdmY87G1ubgTQNvzsbyN9oPMdFmFKvaAx9UnXM1VaKnY7MFRfV5Mx2xtcNaEkrifmA5u8
      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/evm_address:
    post:
      operationId: evm_address
      summary: EVM address lookup
      description: Native balance (with USD), transaction count, contract or wallet, ENS name — for any address on 17 EVM chains at once or one chain. Reads straight from each chain's RPC. chain="all" checks every supported chain in parallel and returns only where the address has balance, transactions or code — the quick "where is this wallet active" answer.
      tags:
      - Market Stem
      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
              required:
              - address
              properties:
                address:
                  type: string
                  pattern: ^0x[0-9a-fA-F]{40}$
                  description: EVM wallet or contract address (0x + 40 hex).
                chain:
                  type: string
                  enum:
                  - all
                  - ethereum
                  - base
                  - arbitrum
                  - optimism
                  - polygon
                  - bsc
                  - avalanche
                  - linea
                  - blast
                  - scroll
                  - gnosis
                  - sonic
                  - unichain
                  - mantle
                  - berachain
                  - hyperevm
                  - monad
                  default: all
                  description: Chain to read, or "all" to check every supported chain. One of "all", "ethereum", "base", "arbitrum", "optimism", "polygon", "bsc", "avalanche", "linea", "blast", "scroll", "gnosis", "sonic", "unichain", "mantle", "berachain", "hyperevm", "monad". Default "all".
              additionalProperties: false
            example:
              address: '0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045'
              chain: all
      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/erc20_info:
    post:
      operationId: erc20_info
      summary: ERC-20 token + balance
      description: Name, symbol, decimals, total supply and USD price of any ERC-20 — plus a wallet's balance of it — read on chain. Direct contract calls (name/symbol/decimals/totalSupply/balanceOf) on the chosen EVM chain, priced via DefiLlama. Works for any token, listed or not.
      tags:
      - Market Stem
      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
              required:
              - token
              properties:
                token:
                  type: string
                  pattern: ^0x[0-9a-fA-F]{40}$
                  description: ERC-20 contract address (0x + 40 hex).
                wallet:
                  type: string
                  pattern: ^0x[0-9a-fA-F]{40}$
                  description: optional holder. 0x + 40 hex chars.
                chain:
                  type: string
                  enum:
                  - ethereum
                  - base
                  - arbitrum
                  - optimism
                  - polygon
                  - bsc
                  - avalanche
                  - linea
                  - blast
                  - scroll
                  - gnosis
                  - sonic
                  - unichain
                  - mantle
                  - berachain
                  - hyperevm
                  - monad
                  default: ethereum
                  description: 'EVM chain: ethereum, base, arbitrum, optimism, polygon, bsc, avalanche, linea, blast, scroll, gnosis, sonic, unichain, mantle, berachain, hyperevm, monad. One of "ethereum", "base", "arbitrum", "optimism", "polygon", "bsc", "avalanche", "linea", "blast", "scroll", "gnosis", "sonic", "unichain", "mantle", "berachain", "hyperevm", "monad". Default "ethereum".'
              additionalProperties: false
            example:
              token: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
              wallet: '0x3304E22DDaa22bCdC5fCa2269b418046aE7b566A'
              chain: base
      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/evm_tx:
    post:
      operationId: evm_tx
      summary: Explain an EVM transaction
      description: 'Any EVM transaction in plain terms: status, from/to, value, fee in native and USD, method called, every ERC-20 transfer decoded with symbols and amounts. Fetches the transaction and receipt from the chain, decodes ERC-20 Transfer events (token symbols/decimals read on chain), and prices the fee.'
      tags:
      - Market Stem
      x-price-usd: 0.003
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.003'
        protocols:
        - x402:
            networks:
            - solana
            - base
            assets:
            - USDC
            - SOL
            payTo:
              solana: RfmsJN8mYvE5Ggjc4yE8i3w5deZEUgRie6W6xehif6R
              base: '0x538d1D8257C6001d7e432c90C6abc658948d7441'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - hash
              properties:
                hash:
                  type: string
                  pattern: ^0x[0-9a-fA-F]{64}$
                  description: EVM transaction hash (0x + 64 hex).
                chain:
                  type: string
                  enum:
                  - ethereum
                  - base
                  - arbitrum
                  - optimism
                  - polygon
                  - bsc
                  - avalanche
                  - linea
                  - blast
                  - scroll
                  - gnosis
                  - sonic
                  - unichain
                  - mantle
                  - berachain
                  - hyperevm
                  - monad
                  default: ethereum
                  description: 'EVM chain: ethereum, base, arbitrum, optimism, polygon, bsc, avalanche, linea, blast, scroll, gnosis, sonic, unichain, mantle, berachain, hyperevm, monad. One of "ethereum", "base", "arbitrum", "optimism", "polygon", "bsc", "avalanche", "linea", "blast", "scroll", "gnosis", "sonic", "unichain", "mantle", "berachain", "hyperevm", "monad". Default "ethereum".'
              additionalProperties: false
            example:
              hash: '0xedc1ff7d3ac9efa7f6cb95814ea54b8a49c4118807769d84fa17260f21bb80ad'
              chain: ethereum
      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/solana_network:
    post:
      operationId: solana_network
      summary: Solana network status
      description: 'Solana right now: TPS (total and non-vote), slot and block height, epoch progress and ETA, priority-fee percentiles, cluster version. Read from mainnet RPC: recent performance samples, epoch info, prioritization fees.'
      tags:
      - Market Stem
      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
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.