augur-trade-com Knowledge Cortex API

openapi: 3.2.0
info:
  title: A.U.G.U.R Foresight — agent tool exchange Knowledge Cortex…
  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: Knowledge Cortex
paths:
  /hub/api/v1/tools/wiki:
    post:
      operationId: wiki
      summary: Wikipedia lookup
      description: 'Wikipedia in any language: search a topic and get the best article''s summary, description, thumbnail and link — or the full article text. Search + REST summary from Wikipedia. full=true returns the article as plain text (sections kept), capped by max_chars. Disambiguation pages are flagged with alternatives.'
      tags:
      - Knowledge Cortex
      x-price-usd: 0
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - query
              properties:
                query:
                  type: string
                  description: Topic or article title to look up.
                lang:
                  type: string
                  pattern: ^[a-z]{2,3}(-[a-z]+)?$
                  default: en
                  description: Wikipedia language code, e.g. "en", "de", "pt-br". Default "en".
                full:
                  type: boolean
                  default: false
                  description: true = return the full article text, not just the summary. Default false.
                max_chars:
                  type: integer
                  minimum: 500
                  maximum: 60000
                  default: 8000
                  description: Truncate full article text to this many characters (with full=true). Range 500-60000. Default 8000.
              additionalProperties: false
            example:
              query: Solana blockchain
      responses:
        '200':
          description: 'ok: {ok, tool, ms, billing, data}'
        '400':
          description: invalid arguments
  /hub/api/v1/tools/arxiv_search:
    post:
      operationId: arxiv_search
      summary: arXiv paper search
      description: Search arXiv research papers by keywords, author or category — newest or most relevant — with abstracts, authors, dates and PDF links. arXiv's official API. query supports arXiv syntax (ti:, au:, abs:, cat:cs.AI, AND/OR). Paced to arXiv's one-request-per-3-seconds policy and cached, so repeated queries are instant.
      tags:
      - Knowledge Cortex
      x-price-usd: 0.001
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.001'
        protocols:
        - x402:
            networks:
            - solana
            - base
            assets:
            - USDC
            - SOL
            payTo:
              solana: RfmsJN8mYvE5Ggjc4yE8i3w5deZEUgRie6W6xehif6R
              base: '0x538d1D8257C6001d7e432c90C6abc658948d7441'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - query
              properties:
                query:
                  type: string
                  description: e.g. "tool use agents" or au:hinton or cat:cs.CL AND ti:reasoning
                sort:
                  type: string
                  enum:
                  - relevance
                  - newest
                  default: relevance
                  description: Order by relevance to the query or by submission date. One of "relevance", "newest". Default "relevance".
                limit:
                  type: integer
                  minimum: 1
                  maximum: 30
                  default: 10
                  description: How many papers to return. Range 1-30. Default 10.
              additionalProperties: false
            example:
              query: LLM agents tool use
              sort: newest
              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)
  /hub/api/v1/tools/package_info:
    post:
      operationId: package_info
      summary: Software package info
      description: 'Any npm, PyPI or crates.io package: latest version and release date, license, downloads, maintainers, repo, dependency count, deprecation — to pick or vet a dependency. Straight from each registry (plus npm and pypistats download counts). Flags deprecated packages and ones with no release in 2+ years.'
      tags:
      - Knowledge Cortex
      x-price-usd: 0.001
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.001'
        protocols:
        - x402:
            networks:
            - solana
            - base
            assets:
            - USDC
            - SOL
            payTo:
              solana: RfmsJN8mYvE5Ggjc4yE8i3w5deZEUgRie6W6xehif6R
              base: '0x538d1D8257C6001d7e432c90C6abc658948d7441'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - name
              properties:
                name:
                  type: string
                  description: Exact package name as published, e.g. "express" or "requests".
                ecosystem:
                  type: string
                  enum:
                  - npm
                  - pypi
                  - crates
                  default: npm
                  description: Registry to look in. One of "npm", "pypi", "crates". Default "npm".
              additionalProperties: false
            example:
              name: '@solana/web3.js'
              ecosystem: npm
      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/github_repo:
    post:
      operationId: github_repo
      summary: GitHub repo health
      description: 'A GitHub repository at a glance: stars, forks, open issues, last commit, latest release, license, languages, contributors, archived — is it alive and trustworthy? From the GitHub REST API. "activity" summarizes days since last push and last release so an agent can judge whether a project is maintained.'
      tags:
      - Knowledge 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
              required:
              - repo
              properties:
                repo:
                  type: string
                  description: owner/name or a github.com URL
              additionalProperties: false
            example:
              repo: solana-labs/solana-web3.js
      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/hn_search:
    post:
      operationId: hn_search
      summary: Hacker News search
      description: Search Hacker News stories and comments by keyword, sorted by relevance or date, filtered by time window and minimum points — what developers are saying about anything. Algolia's official HN search. Returns title, url, points, comment count, author, date and the HN discussion link.
      tags:
      - Knowledge Cortex
      x-price-usd: 0.001
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.001'
        protocols:
        - x402:
            networks:
            - solana
            - base
            assets:
            - USDC
            - SOL
            payTo:
              solana: RfmsJN8mYvE5Ggjc4yE8i3w5deZEUgRie6W6xehif6R
              base: '0x538d1D8257C6001d7e432c90C6abc658948d7441'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - query
              properties:
                query:
                  type: string
                  description: Keywords to search for.
                type:
                  type: string
                  enum:
                  - story
                  - comment
                  - show_hn
                  - ask_hn
                  default: story
                  description: Stories, comments, Show HN or Ask HN posts. One of "story", "comment", "show_hn", "ask_hn". Default "story".
                sort:
                  type: string
                  enum:
                  - relevance
                  - date
                  default: relevance
                  description: Order by relevance or newest first. One of "relevance", "date". Default "relevance".
                days:
                  type: integer
                  minimum: 1
                  maximum: 3650
                  default: 365
                  description: Only items from the last N days. Range 1-3650. Default 365.
                min_points:
                  type: integer
                  minimum: 0
                  default: 0
                  description: Only items with at least this many points. Default 0.
                limit:
                  type: integer
                  minimum: 1
                  maximum: 50
                  default: 15
                  description: How many results to return. Range 1-50. Default 15.
              additionalProperties: false
            example:
              query: MCP server
              days: 30
              min_points: 50
              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)
  /hub/api/v1/tools/doi_lookup:
    post:
      operationId: doi_lookup
      summary: Citation / DOI lookup
      description: 'Resolve a DOI — or search a paper title — to full citation metadata: title, authors, journal, year, citations count, publisher, license, and a ready-made APA/BibTeX citation. Crossref''s open metadata (150M+ works). Search mode returns the top matches for a title/author query.'
      tags:
      - Knowledge Cortex
      x-price-usd: 0.001
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.001'
        protocols:
        - x402:
            networks:
            - solana
            - base
            assets:
            - USDC
            - SOL
            payTo:
              solana: RfmsJN8mYvE5Ggjc4yE8i3w5deZEUgRie6W6xehif6R
              base: '0x538d1D8257C6001d7e432c90C6abc658948d7441'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                doi:
                  type: string
                  description: e.g. 10.1038/nature14539
                query:
                  type: string
                  description: title/author search instead of a DOI
                limit:
                  type: integer
                  minimum: 1
                  maximum: 20
                  default: 5
                  description: How many matches to return when searching by title. Range 1-20. Default 5.
              additionalProperties: false
            example:
              doi: 10.1038/nature14539
      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/book_search:
    post:
      operationId: book_search
      summary: Book search
      description: 'Find books by title, author, subject or ISBN: first published year, editions, ISBNs, page count, ratings, subjects and cover image. Open Library (Internet Archive) catalogue of 30M+ titles.'
      tags:
      - Knowledge Cortex
      x-price-usd: 0.001
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.001'
        protocols:
        - x402:
            networks:
            - solana
            - base
            assets:
            - USDC
            - SOL
            payTo:
              solana: RfmsJN8mYvE5Ggjc4yE8i3w5deZEUgRie6W6xehif6R
              base: '0x538d1D8257C6001d7e432c90C6abc658948d7441'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - query
              properties:
                query:
                  type: string
                  description: title, author or ISBN
                limit:
                  type: integer
                  minimum: 1
                  maximum: 20
                  default: 5
                  description: How many books to return. Range 1-20. Default 5.
              additionalProperties: false
            example:
              query: Dune Frank Herbert
              limit: 3
      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.