← Back to Skills Marketplace
Numinous Forecast
by
Juandbalbi
· GitHub ↗
· v1.0.3
654
Downloads
3
Stars
0
Active Installs
4
Versions
Install in OpenClaw
/install numinous-forecast
Description
Get calibrated probabilities from Numinous (Bittensor Subnet 6) with metadata/provenance.
Usage Guidance
This skill appears to do what it says: call Numinous and pay for predictions via x402. The important security consideration is the required EVM private key: the code uses that key to construct/sign payments, so anyone with that key can spend funds. Before installing or running: 1) Only set NUMINOUS_X402_EVM_PRIVATE_KEY in isolated environments (not shared CI or chat logs); prefer a dedicated wallet with minimal funds. 2) Verify the x402 package source (PyPI/GitHub) and review its code or reputation; pip-installing third-party packages runs remote code. 3) Consider running the scripts in a container or sandbox and monitor outgoing network traffic and any on-chain transactions the key authorizes. 4) If you need stronger protection, use a wallet that supports signing outside of raw private-key import (hardware wallets) — note this code expects a raw private key and may not support hardware wallets. 5) Rotate the key immediately if it is ever exposed. If you want, I can list the exact code paths that use the private key and the network endpoints the skill calls.
Capability Analysis
Type: OpenClaw Skill
Name: numinous-forecast
Version: 1.0.3
The skill is designed to interact with the Numinous forecasting API, which requires payments via the x402 protocol using EVM or Solana private keys. The `SKILL.md` clearly documents the need for `NUMINOUS_X402_EVM_PRIVATE_KEY` (and optionally SVM) and provides a security warning about handling private keys. The Python code (`numinous_api.py`) reads these keys from environment variables and uses them solely for cryptographic signing within the `x402` payment library for calls to `https://api.numinouslabs.io`. There is no evidence of data exfiltration, unauthorized command execution, persistence mechanisms, or prompt injection attempts against the agent in any of the files. The handling of private keys is a necessary and documented part of the skill's functionality, not indicative of malicious intent.
Capability Assessment
Purpose & Capability
Name/description, required binaries (python3), declared env var (NUMINOUS_X402_EVM_PRIVATE_KEY), and the x402 install requests all match the stated purpose of making paid requests to the Numinous forecasting API. The primary credential is an EVM private key which is required for x402 exact-payment flow and is justified by the payment-required (402) flow described in the code and docs.
Instruction Scope
SKILL.md instructs running the provided Python scripts (predict_query.py / predict_event.py). The included code reads only the declared env vars (EVM/SVM private keys and a prefer flag), calls api.numinouslabs.io, constructs/decodes x402 payment headers, and prints JSON results. There are no instructions to read unrelated local files, system credentials, or to exfiltrate data to unexpected endpoints.
Install Mechanism
Install steps recommend using 'uv' to pip install x402[httpx,evm] (optional svm). Installing a third-party Python package (x402) is expected for this functionality but carries the usual supply-chain risk: the package and its dependencies will run code on your system. The install sources are standard Python packaging (no arbitrary download URLs appear in the manifest), but you should verify the x402 package provenance (PyPI/GitHub) before installing.
Credentials
Only NUMINOUS_X402_EVM_PRIVATE_KEY is required (primaryEnv). The code also supports an optional NUMINOUS_X402_SVM_PRIVATE_KEY and an optional NUMINOUS_X402_PREFER flag; these are consistent with optional Solana payment support. These env vars are proportional to the skill's payment-based behavior. Note: these are private keys (high-value secrets) and will be used to sign payments/transactions.
Persistence & Privilege
Skill does not request persistent presence (always=false), does not modify other skills or system-wide config, and does not declare config path access. It only expects env vars and runs as a normal user-space script.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install numinous-forecast - After installation, invoke the skill by name or use
/numinous-forecast - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.3
No user-visible changes in this release.
- Version bump only; documentation and functionality remain the same.
v1.0.2
- Clarified setup instructions: EVM private key (`NUMINOUS_X402_EVM_PRIVATE_KEY`) is now required, not optional.
- Updated metadata to specify required environment variable and primary environment.
- Minor improvements to documentation around key requirements and usage.
- No changes to functionality or file contents.
v1.0.1
- Updated setup to use x402 payment flow (HTTP 402 → pay → retry) requiring EVM/Solana wallet keys instead of API keys.
- Expanded environment variable options for wallet key setup (`NUMINOUS_X402_EVM_PRIVATE_KEY`, `NUMINOUS_X402_SVM_PRIVATE_KEY`, `NUMINOUS_X402_PREFER`).
- Updated dependencies and installation instructions for x402 and payment modules.
- Detailed output structure and metadata fields for forecasts.
- Clarified provenance and context data included in forecast results.
v1.0.0
Initial release: Run decentralized, calibrated forecasts using Numinous (Bittensor Subnet 6).
- Query and event forecast modes with optional topic tagging.
- Requires `NUMINOUS_API_KEY` environment variable for access.
- Provides JSON output with probability, metadata, and provenance details.
- Supports async forecast jobs; responses typically within 30–120 seconds.
- Includes setup tips and usage examples for both modes.
Metadata
Frequently Asked Questions
What is Numinous Forecast?
Get calibrated probabilities from Numinous (Bittensor Subnet 6) with metadata/provenance. It is an AI Agent Skill for Claude Code / OpenClaw, with 654 downloads so far.
How do I install Numinous Forecast?
Run "/install numinous-forecast" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Numinous Forecast free?
Yes, Numinous Forecast is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Numinous Forecast support?
Numinous Forecast is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Numinous Forecast?
It is built and maintained by Juandbalbi (@juandbalbi); the current version is v1.0.3.
More Skills