# Send Numinous Forecast to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "numinous-forecast",
    "name": "Numinous Forecast",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/Juandbalbi/numinous-forecast",
    "canonicalUrl": "https://clawhub.ai/Juandbalbi/numinous-forecast",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/numinous-forecast",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=numinous-forecast",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "numinous_api.py",
      "SKILL.md",
      "predict_query.py",
      "predict_event.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "numinous-forecast",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-02T19:33:14.637Z",
      "expiresAt": "2026-05-09T19:33:14.637Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=numinous-forecast",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=numinous-forecast",
        "contentDisposition": "attachment; filename=\"numinous-forecast-1.0.3.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "numinous-forecast"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/numinous-forecast"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/numinous-forecast",
    "downloadUrl": "https://openagent3.xyz/downloads/numinous-forecast",
    "agentUrl": "https://openagent3.xyz/skills/numinous-forecast/agent",
    "manifestUrl": "https://openagent3.xyz/skills/numinous-forecast/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/numinous-forecast/agent.md"
  }
}
```
## Documentation

### 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
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Juandbalbi
- Version: 1.0.3
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-02T19:33:14.637Z
- Expires at: 2026-05-09T19:33:14.637Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/numinous-forecast)
- [Send to Agent page](https://openagent3.xyz/skills/numinous-forecast/agent)
- [JSON manifest](https://openagent3.xyz/skills/numinous-forecast/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/numinous-forecast/agent.md)
- [Download page](https://openagent3.xyz/downloads/numinous-forecast)