augur-trade-com Liquidity Lobe API

openapi: 3.2.0
info:
  title: A.U.G.U.R Foresight — agent tool exchange Liquidity Lobe 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: Liquidity Lobe
paths:
  /hub/api/v1/tools/dlmm_pool:
    post:
      operationId: dlmm_pool
      summary: Meteora DLMM pool
      description: 'State of a Meteora DLMM pool: price, bin step, fees, TVL, volume and fees by window (30 m–24 h), 24 h fee yield and its annualized APR/APY. For LP agents choosing where to provide liquidity.'
      tags:
      - Liquidity Lobe
      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:
              - pool
              properties:
                pool:
                  type: string
                  pattern: ^[1-9A-HJ-NP-Za-km-z]{32,44}$
                  description: DLMM pool (pair) address. Base58 Solana address, 32-44 chars.
              additionalProperties: false
            example:
              pool: HTvjzsfX3yU6BUodCjZ5vZkUrAxMDTrBs3CJaq43ashR
      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/dlmm_positions:
    post:
      operationId: dlmm_positions
      summary: Wallet DLMM positions
      description: 'Open Meteora DLMM positions of any wallet: value, unclaimed fees, PnL, in/out of range — or its closed-position history. Set history=true for closed positions with deposits, withdrawals, fees and PnL per pool.'
      tags:
      - Liquidity Lobe
      x-price-usd: 0.005
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.005'
        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.
                history:
                  type: boolean
                  default: false
                  description: true = closed-position history instead of open positions. Default false.
                page:
                  type: integer
                  minimum: 1
                  maximum: 50
                  default: 1
                  description: Page of closed-position history (only with history=true). Range 1-50. Default 1.
              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/dlmm_whales:
    post:
      operationId: dlmm_whales
      summary: DLMM LP whales
      description: 'Meteora DLMM liquidity providers ranked by measured on-chain edge: net USD, median multiple, win rate, hold time, size, recency. Produced by our own discovery engine, which decodes DLMM liquidity instructions across high-volume and high-yield pools every few hours and scores each wallet''s completed round trips. These are the wallets our live copier watches.'
      tags:
      - Liquidity Lobe
      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: 25
                  default: 10
                  description: How many ranked LP wallets to return. Range 1-25. Default 10.
              additionalProperties: false
            example:
              limit: 5
      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.