augur-trade-com Utility Cerebellum API

openapi: 3.2.0
info:
  title: A.U.G.U.R Foresight — agent tool exchange Utility…
  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: Utility Cerebellum
paths:
  /hub/api/v1/tools/qr_code:
    post:
      operationId: qr_code
      summary: QR code generator
      description: 'Make a QR code for any text, URL, Solana Pay / wallet address or Wi-Fi login — as a PNG (base64 data URL) or SVG, with size, margin, colours and error correction. Rendered on our server. For Wi-Fi pass wifi_ssid + wifi_password; for Solana Pay pass a solana: URI as text.'
      tags:
      - Utility Cerebellum
      x-price-usd: 0
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                text:
                  type: string
                  x-raw: true
                  description: Text or URL to encode (ignored when wifi_ssid is set).
                format:
                  type: string
                  enum:
                  - png
                  - svg
                  default: png
                  description: PNG (base64 data URL) or SVG markup. One of "png", "svg". Default "png".
                size:
                  type: integer
                  minimum: 64
                  maximum: 2048
                  default: 512
                  description: Image width/height in pixels. Range 64-2048. Default 512.
                margin:
                  type: integer
                  minimum: 0
                  maximum: 16
                  default: 2
                  description: Quiet-zone width in modules. Range 0-16. Default 2.
                error_correction:
                  type: string
                  enum:
                  - L
                  - M
                  - Q
                  - H
                  default: M
                  description: 'Error-correction level: L 7%, M 15%, Q 25%, H 30%. One of "L", "M", "Q", "H". Default "M".'
                dark:
                  type: string
                  pattern: ^#[0-9a-fA-F]{6}$
                  default: '#000000'
                  description: 'Foreground colour as #rrggbb. Default "#000000".'
                light:
                  type: string
                  pattern: ^#[0-9a-fA-F]{6}$
                  default: '#ffffff'
                  description: 'Background colour as #rrggbb. Default "#ffffff".'
                wifi_ssid:
                  type: string
                  description: Wi-Fi network name; makes a join-network QR instead of text.
                wifi_password:
                  type: string
                  description: Wi-Fi password (with wifi_ssid; omit for open networks).
              additionalProperties: false
            example:
              text: https://example.com
              format: svg
              size: 256
      responses:
        '200':
          description: 'ok: {ok, tool, ms, billing, data}'
        '400':
          description: invalid arguments
  /hub/api/v1/tools/hash_encode:
    post:
      operationId: hash_encode
      summary: Hash + encode/decode
      description: Hash data (SHA-256/512, SHA3, Keccak-256, BLAKE2, MD5, SHA-1, RIPEMD-160, HMAC) and convert between utf8, hex, base64, base64url and base58 — exact, in one call. Useful for signatures, content addressing, EVM selectors (keccak of a function signature), and decoding blobs agents are handed. Input can itself be hex/base64/base58.
      tags:
      - Utility Cerebellum
      x-price-usd: 0
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - input
              properties:
                input:
                  type: string
                  x-raw: true
                  description: Data to hash or re-encode.
                input_encoding:
                  type: string
                  enum:
                  - utf8
                  - hex
                  - base64
                  - base58
                  default: utf8
                  description: How the input string is encoded. One of "utf8", "hex", "base64", "base58". Default "utf8".
                hashes:
                  type: array
                  maxItems: 12
                  items:
                    type: string
                  default:
                  - sha256
                  - keccak256
                  description: sha256, sha512, sha3-256, sha3-512, keccak256, blake2b512, blake2s256, md5, sha1, ripemd160. 0-12 items. Default ["sha256","keccak256"].
                hmac_key:
                  type: string
                  description: if set, HMAC instead of plain hash (utf8 key)
              additionalProperties: false
            example:
              input: transfer(address,uint256)
              hashes:
              - keccak256
              - sha256
      responses:
        '200':
          description: 'ok: {ok, tool, ms, billing, data}'
        '400':
          description: invalid arguments
  /hub/api/v1/tools/json_schema_validate:
    post:
      operationId: json_schema_validate
      summary: JSON Schema validator
      description: Validate JSON data against a JSON Schema (draft-07/2019-09/2020-12, formats like email/uri/date-time) and get every error with its exact path — check tool I/O before acting on it. Ajv, strict about types, all errors reported. Pass data and schema as JSON values (or JSON strings).
      tags:
      - Utility Cerebellum
      x-price-usd: 0
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - data
              - schema
              properties:
                data:
                  description: any JSON value (or a JSON string with parse_strings=true)
                schema:
                  type: object
                  description: The JSON Schema to validate against.
                parse_strings:
                  type: boolean
                  default: false
                  description: true = if data is a string, parse it as JSON first. Default false.
              additionalProperties: false
            example:
              data:
                name: Ada
                age: -1
                email: nope
              schema:
                type: object
                required:
                - name
                - age
                properties:
                  name:
                    type: string
                  age:
                    type: integer
                    minimum: 0
                  email:
                    type: string
                    format: email
      responses:
        '200':
          description: 'ok: {ok, tool, ms, billing, data}'
        '400':
          description: invalid arguments
  /hub/api/v1/tools/cron_explain:
    post:
      operationId: cron_explain
      summary: Cron expression explain + next runs
      description: Explain a cron expression in plain English and list its next N run times in any time zone — catch a schedule mistake before it fires at 3 am. Supports 5-field and 6-field (seconds) cron, ranges, steps, L/W/#, and nicknames (@daily, @hourly…).
      tags:
      - Utility Cerebellum
      x-price-usd: 0
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - expression
              properties:
                expression:
                  type: string
                  description: Cron expression, 5 fields (or 6 with seconds), e.g. "*/15 9-17 * * 1-5".
                tz:
                  type: string
                  default: UTC
                  description: IANA time zone for the next-run times. Default "UTC".
                count:
                  type: integer
                  minimum: 1
                  maximum: 50
                  default: 5
                  description: How many upcoming run times to list. Range 1-50. Default 5.
              additionalProperties: false
            example:
              expression: '*/15 9-17 * * 1-5'
              tz: America/New_York
              count: 4
      responses:
        '200':
          description: 'ok: {ok, tool, ms, billing, data}'
        '400':
          description: invalid arguments
  /hub/api/v1/tools/markdown_convert:
    post:
      operationId: markdown_convert
      summary: Markdown ⇄ HTML
      description: 'Convert Markdown to clean HTML (GitHub-flavoured: tables, task lists, fenced code) or HTML back to Markdown. marked for md→html, Turndown for html→md. Scripts/styles are dropped on html→md.'
      tags:
      - Utility Cerebellum
      x-price-usd: 0
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - input
              properties:
                input:
                  type: string
                  x-raw: true
                  description: Markdown or HTML to convert.
                to:
                  type: string
                  enum:
                  - html
                  - markdown
                  default: html
                  description: Target format. One of "html", "markdown". Default "html".
              additionalProperties: false
            example:
              input: '# Hello


                | a | b |

                |---|---|

                | 1 | 2 |


                - [x] done'
              to: html
      responses:
        '200':
          description: 'ok: {ok, tool, ms, billing, data}'
        '400':
          description: invalid arguments
  /hub/api/v1/tools/text_diff:
    post:
      operationId: text_diff
      summary: Text diff
      description: 'Diff two texts: unified diff (patch format), a line/word-level change list, and similarity % — compare versions of a doc, config or code. jsdiff. mode=lines gives a unified patch; mode=words gives word-level changes for prose.'
      tags:
      - Utility Cerebellum
      x-price-usd: 0
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - a
              - b
              properties:
                a:
                  type: string
                  x-raw: true
                  description: Original text.
                b:
                  type: string
                  x-raw: true
                  description: Changed text.
                mode:
                  type: string
                  enum:
                  - lines
                  - words
                  default: lines
                  description: Diff granularity. One of "lines", "words". Default "lines".
                context:
                  type: integer
                  minimum: 0
                  maximum: 20
                  default: 3
                  description: Unchanged lines of context around each change in the patch. Range 0-20. Default 3.
              additionalProperties: false
            example:
              a: 'rate limit: 10/min

                retries: 2

                '
              b: 'rate limit: 120/min

                retries: 2

                timeout: 30s

                '
      responses:
        '200':
          description: 'ok: {ok, tool, ms, billing, data}'
        '400':
          description: invalid arguments
  /hub/api/v1/tools/unit_convert:
    post:
      operationId: unit_convert
      summary: Unit converter
      description: 'Convert between units of length, mass, volume, temperature, speed, area, time, data size, energy, power, pressure, frequency and more — or list every unit a value converts to. Exact conversion tables (convert-units). Use abbreviations: m, km, mi, ft, kg, lb, oz, l, gal, C, F, K, km/h, mph, knot, B, KB, MB, GB (binary, 1 GB = 1024 MB), J, kWh, W, Pa, bar, psi, Hz…'
      tags:
      - Utility Cerebellum
      x-price-usd: 0
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - value
              - from
              properties:
                value:
                  type: number
                  description: Number to convert.
                from:
                  type: string
                  description: Source unit, e.g. "mi", "kg", "degF", "GB".
                to:
                  type: string
                  description: omit to get every compatible unit
              additionalProperties: false
            example:
              value: 100
              from: km/h
              to: mph
      responses:
        '200':
          description: 'ok: {ok, tool, ms, billing, data}'
        '400':
          description: invalid arguments
  /hub/api/v1/tools/jwt_decode:
    post:
      operationId: jwt_decode
      summary: JWT decoder
      description: Decode a JSON Web Token's header and claims, show issued/expiry times in plain dates and whether it has expired — optionally verify an HS256/384/512 signature with a secret. Decoding does not need the key. Never paste production secrets into third-party tools you do not trust; verification here is local and nothing is stored or logged.
      tags:
      - Utility Cerebellum
      x-price-usd: 0
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - token
              properties:
                token:
                  type: string
                  description: The JWT (three base64url parts). The signature is not verified.
                secret:
                  type: string
                  description: optional HMAC secret to verify HS* signatures
              additionalProperties: false
            example:
              token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJhbGYiLCJpYXQiOjE3OTAwMDAwMDAsImV4cCI6MTc5MDAwMzYwMH0.kS2XSeH9sgBX7w0Zm6D7g8Eo3HjQyGAJk1S1vXbFpXE
      responses:
        '200':
          description: 'ok: {ok, tool, ms, billing, data}'
        '400':
          description: invalid arguments
  /hub/api/v1/tools/random_gen:
    post:
      operationId: random_gen
      summary: Secure random + IDs
      description: 'Cryptographically secure randomness: UUID v4/v7, passwords, API-key-style tokens, integers in a range, dice, coin flips, or a fair shuffle / pick from a list. Node''s CSPRNG. Output is generated fresh per call and never stored or logged.'
      tags:
      - Utility Cerebellum
      x-price-usd: 0
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                kind:
                  type: string
                  enum:
                  - uuid4
                  - uuid7
                  - password
                  - token
                  - int
                  - shuffle
                  - pick
                  - coin
                  - dice
                  default: uuid4
                  description: What to generate. One of "uuid4", "uuid7", "password", "token", "int", "shuffle", "pick", "coin", "dice". Default "uuid4".
                count:
                  type: integer
                  minimum: 1
                  maximum: 100
                  default: 1
                  description: How many values to generate. Range 1-100. Default 1.
                length:
                  type: integer
                  minimum: 4
                  maximum: 256
                  default: 20
                  description: Length for passwords and tokens. Range 4-256. Default 20.
                min:
                  type: integer
                  default: 1
                  description: Lowest integer (kind=int or dice sides). Default 1.
                max:
                  type: integer
                  default: 100
                  description: Highest integer (kind=int). Default 100.
                items:
                  type: array
                  maxItems: 1000
                  items:
                    type: string
                  description: List to shuffle or pick from (kind=shuffle or pick). 0-1000 items.
                symbols:
                  type: boolean
                  default: true
                  description: Include symbols in passwords. Default true.
              additionalProperties: false
            example:
              kind: password
              count: 2
              length: 24
      responses:
        '200':
          description: 'ok: {ok, tool, ms, billing, data}'
        '400':
          description: invalid arguments
  /hub/api/v1/tools/text_stats:
    post:
      operationId: text_stats
      summary: Text stats + token estimate
      description: 'Count characters, words, sentences, lines and paragraphs, estimate LLM tokens, reading time and readability (Flesch), and pull out every URL, email, @handle, #tag, number and crypto address. Token count is an estimate (~4 characters per token for English; code and non-Latin scripts differ). Extraction uses strict patterns; EVM addresses are checksum-validated.'
      tags:
      - Utility Cerebellum
      x-price-usd: 0
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - text
              properties:
                text:
                  type: string
                  x-raw: true
                  description: Text (or a URL when extract=true) to analyse.
                extract:
                  type: boolean
                  default: true
                  description: true = if text is a URL, fetch the page and analyse its readable text. Default true.
              additionalProperties: false
            example:
              text: 'Solana processed 3,000 transactions a second today. Read more at https://example.com — or ask @someone. #solana'
      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.