augur-trade-com World Map API

openapi: 3.2.0
info:
  title: A.U.G.U.R Foresight — agent tool exchange World Map 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: World Map
paths:
  /hub/api/v1/tools/weather:
    post:
      operationId: weather
      summary: Weather now + forecast
      description: 'Current weather and hourly/daily forecast for any place name or lat,lon: temperature, feels-like, wind, gusts, rain, cloud, humidity, UV — up to 9 days. Forecast from the Norwegian Meteorological Institute (MET Norway), the same model data yr.no uses, worldwide. Place names are geocoded with OpenStreetMap. Times are UTC plus local time when tz is given (IANA, e.g. Australia/Sydney).'
      tags:
      - World Map
      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:
              - place
              properties:
                place:
                  type: string
                  description: city/address or "lat,lon"
                days:
                  type: integer
                  minimum: 1
                  maximum: 9
                  default: 3
                  description: Days of daily forecast to include. Range 1-9. Default 3.
                tz:
                  type: string
                  description: IANA time zone for local times (optional)
              additionalProperties: false
            example:
              place: Sydney, Australia
              days: 2
              tz: Australia/Sydney
      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/geocode:
    post:
      operationId: geocode
      summary: Geocode / reverse geocode
      description: Place name or address → coordinates (with city, state, country, postcode), or lat,lon → the nearest address. Up to 10 candidates. OpenStreetMap data via Photon. Returns OSM links so results can be checked.
      tags:
      - World Map
      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: address/place, or "lat,lon" for reverse
                limit:
                  type: integer
                  minimum: 1
                  maximum: 10
                  default: 3
                  description: How many candidate matches to return. Range 1-10. Default 3.
              additionalProperties: false
            example:
              query: Eiffel Tower
              limit: 2
      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/fx_rates:
    post:
      operationId: fx_rates
      summary: Currency exchange rates
      description: 'Official exchange rates for 30 major currencies (European Central Bank reference rates): latest or any date since 1999, convert an amount, or a time series. Frankfurter API over ECB reference rates, published each working day ~16:00 CET. For crypto use crypto_price.'
      tags:
      - World Map
      x-price-usd: 0
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                from:
                  type: string
                  pattern: ^[A-Za-z]{3}$
                  default: USD
                  description: Base currency ISO 4217 code, e.g. "USD". Default "USD".
                to:
                  type: array
                  maxItems: 30
                  items:
                    type: string
                    pattern: ^[A-Za-z]{3}$
                  description: 'targets (default: all) 0-30 items.'
                amount:
                  type: number
                  minimum: 0
                  default: 1
                  description: Amount of the base currency to convert. Default 1.
                date:
                  type: string
                  pattern: ^\d{4}-\d{2}-\d{2}$
                  description: historical date (optional)
                end_date:
                  type: string
                  pattern: ^\d{4}-\d{2}-\d{2}$
                  description: 'with date: returns a daily series'
              additionalProperties: false
            example:
              from: USD
              to:
              - EUR
              - AUD
              - JPY
              amount: 100
      responses:
        '200':
          description: 'ok: {ok, tool, ms, billing, data}'
        '400':
          description: invalid arguments
  /hub/api/v1/tools/holidays:
    post:
      operationId: holidays
      summary: Public holidays
      description: Public holidays for 100+ countries for any year, whether today is a holiday there, and the next upcoming ones — including regional (state) holidays. Nager.Date open holiday data. Use for scheduling, market-closure awareness or delivery estimates.
      tags:
      - World Map
      x-price-usd: 0
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - country
              properties:
                country:
                  type: string
                  description: ISO code or name, e.g. AU, United States
                year:
                  type: integer
                  minimum: 1975
                  maximum: 2075
                  description: Calendar year; defaults to the current year. Range 1975-2075.
              additionalProperties: false
            example:
              country: AU
      responses:
        '200':
          description: 'ok: {ok, tool, ms, billing, data}'
        '400':
          description: invalid arguments
  /hub/api/v1/tools/time_convert:
    post:
      operationId: time_convert
      summary: Time zones + date math
      description: 'Current time in any time zones, convert a time between zones (DST-correct), and date arithmetic: add/subtract durations, days between dates, weekday, ISO week, Unix time. Computed locally from the IANA time-zone database — no rate limits, exact. Zones are IANA names (America/New_York, Asia/Tokyo, UTC).'
      tags:
      - World Map
      x-price-usd: 0
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                time:
                  type: string
                  description: ISO time, "now", or a Unix timestamp; naive times are read in from_tz
                from_tz:
                  type: string
                  default: UTC
                  description: IANA time zone the input time is in, e.g. "America/New_York". Default "UTC".
                to_tz:
                  type: array
                  maxItems: 20
                  items:
                    type: string
                  default:
                  - UTC
                  description: IANA time zones to convert into. 0-20 items. Default ["UTC"].
                add:
                  type: string
                  description: e.g. "+3d 4h", "-90m", "+2w"
                until:
                  type: string
                  description: 'second ISO date: returns the difference'
              additionalProperties: false
            example:
              time: 2026-12-25T09:00
              from_tz: Australia/Sydney
              to_tz:
              - America/New_York
              - Europe/London
              - Asia/Tokyo
              add: +1d
      responses:
        '200':
          description: 'ok: {ok, tool, ms, billing, data}'
        '400':
          description: invalid arguments
  /hub/api/v1/tools/country_info:
    post:
      operationId: country_info
      summary: Country facts
      description: 'Any country''s essentials: capital, population, GDP and GDP per capita (World Bank), currencies, languages, calling code, internet TLD, time zones, driving side, borders, flag. Static facts from the world-countries dataset (no rate limits) plus the latest World Bank population and GDP figures.'
      tags:
      - World Map
      x-price-usd: 0
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - country
              properties:
                country:
                  type: string
                  description: name or ISO code
              additionalProperties: false
            example:
              country: Japan
      responses:
        '200':
          description: 'ok: {ok, tool, ms, billing, data}'
        '400':
          description: invalid arguments
  /hub/api/v1/tools/earthquakes:
    post:
      operationId: earthquakes
      summary: Recent earthquakes
      description: Earthquakes worldwide from the last hour to 30 days, filtered by minimum magnitude and optionally within a radius of a place — with depth, tsunami flag and USGS alert level. USGS real-time earthquake feeds (updated every minute).
      tags:
      - World Map
      x-price-usd: 0
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                min_magnitude:
                  type: number
                  minimum: 0
                  maximum: 9
                  default: 4.5
                  description: Only quakes at or above this magnitude. Range 0-9. Default 4.5.
                period:
                  type: string
                  enum:
                  - hour
                  - day
                  - week
                  - month
                  default: day
                  description: Look-back window. One of "hour", "day", "week", "month". Default "day".
                near:
                  type: string
                  description: place or lat,lon (optional)
                radius_km:
                  type: number
                  minimum: 10
                  maximum: 5000
                  default: 1000
                  description: Search radius around the given place (only when a place is given). Range 10-5000. Default 1000.
                limit:
                  type: integer
                  minimum: 1
                  maximum: 100
                  default: 20
                  description: How many quakes to return, largest first. Range 1-100. Default 20.
              additionalProperties: false
            example:
              min_magnitude: 5
              period: week
      responses:
        '200':
          description: 'ok: {ok, tool, ms, billing, data}'
        '400':
          description: invalid arguments
  /hub/api/v1/tools/sun_moon:
    post:
      operationId: sun_moon
      summary: Sunrise, sunset + moon
      description: Sunrise, sunset, golden hour, twilight, day length and solar noon for any place and date — plus moon phase, illumination, moonrise and moonset. Astronomical calculation (SunCalc), exact and instant. Pass tz for local times.
      tags:
      - World Map
      x-price-usd: 0
      security: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - place
              properties:
                place:
                  type: string
                  description: Place name or "lat,lon".
                date:
                  type: string
                  pattern: ^\d{4}-\d{2}-\d{2}$
                  description: default today (UTC)
                tz:
                  type: string
                  description: IANA zone for local times
              additionalProperties: false
            example:
              place: Reykjavik
              tz: Atlantic/Reykjavik
      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.