๐ŸŽ Get the FREE AI Skills Starter Guide โ€” Subscribe โ†’
BytesAgainBytesAgain
BytesAgain โ€บ Skills โ€บ Numinous Forecast
๐Ÿฆ€ ClawHub

Numinous Forecast

by @juandbalbi

Get calibrated probabilities from Numinous (Bittensor Subnet 6) with metadata/provenance.

Versionv1.0.3
Downloads1,114
Starsโญ 3
#clawhub
TERMINAL
clawhub install numinous-forecast

๐Ÿ“– About This Skill

name: numinous-forecast description: Get calibrated probabilities from Numinous (Bittensor Subnet 6) with metadata/provenance. homepage: https://numinouslabs.io/ metadata: {"clawdbot":{"emoji":"๐Ÿ”ฎ","homepage":"https://numinouslabs.io/","requires":{"bins":["python3"],"env":["NUMINOUS_X402_EVM_PRIVATE_KEY"]},"primaryEnv":"NUMINOUS_X402_EVM_PRIVATE_KEY","install":[{"id":"uv-evm","kind":"uv","module":"x402[httpx,evm]","label":"Install x402 (httpx + EVM) (uv)"},{"id":"uv-evm-svm","kind":"uv","module":"x402[httpx,evm,svm]","label":"Install x402 (httpx + EVM + SVM) (uv)"}]}}

Numinous Forecast

This skill calls the Numinous forecasting API and returns a calibrated probability \(p \in [0,1]\) plus metadata/provenance.

Note: requests are paid per-call via x402 (HTTP 402 โ†’ pay โ†’ retry). Youโ€™ll need a wallet key configured (see setup).

Setup

Install Python deps (recommended: uv).

EVM-only (recommended):

uv pip install "x402[httpx,evm]"

If you also want Solana payments:

uv pip install "x402[httpx,evm,svm]"

Set the buyer key (required):

  • NUMINOUS_X402_EVM_PRIVATE_KEY: EVM key (0xโ€ฆ) for Base / EVM payments

    • Optional (Solana payments):

  • NUMINOUS_X402_SVM_PRIVATE_KEY: Solana key (base58) for Solana payments

    • Optional:

  • NUMINOUS_X402_PREFER: auto (default) | evm | svm

    • Security note: these are private keys. Treat them like cash. Donโ€™t paste them into chats/logs.

    Predict (query mode)

    python3 "{baseDir}/predict_query.py" "Will BTC be above $100k by 2026-12-31?"
python3 "{baseDir}/predict_query.py" "Will Team X win League Y in 2026?" --topics sports

    Predict (event mode)

    python3 "{baseDir}/predict_event.py" \
  --title "Will BTC be above $100k by 2026-12-31?" \
  --description "Resolve YES if BTC/USD spot price is strictly above $100,000 at 2026-12-31 23:59:59 UTC." \
  --cutoff "2026-12-31T23:59:59Z" \
  --topics general

    Output

    Both scripts print JSON with these top-level fields:

  • ok: true|false
  • prediction: probability \(p \in [0, 1]\)
  • forecasted_at: ISO timestamp (UTC)
  • forecaster_name: forecaster identifier
  • metadata: provenance/debug context (see below)
  • parsed_fields: query mode only โ€” structured event parsed from your query (see below)
  • error: null on success; otherwise an error string

    • metadata (common keys)

  • pool: aggregation pool name
  • miner_uid: miner UID chosen for this forecast
  • miner_hotkey: miner hotkey identifier
  • reasoning: model reasoning / explanation text
  • agent_name: which forecaster agent produced the result
  • version_id: model/version identifier
  • version_number: integer version
  • raw_prediction: original prediction value before any formatting
  • event_title: resolved event title
  • event_cutoff: resolved cutoff timestamp (UTC)

    • parsed_fields (query mode only)

  • title: resolved event title
  • description: resolution criteria / event description
  • cutoff: ISO cutoff (often ends with Z)
  • topics: list of topic tags

    • โš™๏ธ Configuration

    Install Python deps (recommended: uv).

    EVM-only (recommended):

    uv pip install "x402[httpx,evm]"

    If you also want Solana payments:

    uv pip install "x402[httpx,evm,svm]"

    Set the buyer key (required):

  • NUMINOUS_X402_EVM_PRIVATE_KEY: EVM key (0xโ€ฆ) for Base / EVM payments

    • Optional (Solana payments):

  • NUMINOUS_X402_SVM_PRIVATE_KEY: Solana key (base58) for Solana payments

    • Optional:

  • NUMINOUS_X402_PREFER: auto (default) | evm | svm

    • Security note: these are private keys. Treat them like cash. Donโ€™t paste them into chats/logs.