Current space weather from NOAA SWPC public feeds. Returns the latest planetary K-index (3-hour geomagnetic activity), solar wind plasma (density / speed / temperature from ACE/DSCOVR at L1), GOES X-ray flux with NOAA flare class (A/B/C/M/X), and the current NOAA R (radio blackout) / S (solar radiation) / G (geomagnetic storm) scales plus a 24-hour forecast in 6-hour windows. All timestamps are ISO 8601 UTC. No parameters. Useful for aurora forecasting, HF-radio propagation, satellite-operations planning, and GPS-degradation alerts. Data is public domain (NOAA / US government work).
/api/space/weatherPAYMENT-SIGNATURE.The weather API is a pay-per-call space endpoint built for AI agents and autonomous software. Current space weather from NOAA SWPC public feeds.
There is no signup and no API key. An agent (or any HTTP client) hits the endpoint, receives an x402 "402 Payment Required" challenge, signs a sub-cent USDC payment on Base or Solana, and retries — the data comes back on the paid request. That makes it a drop-in weather data source for an agent tool-use loop, an MCP host, or a backend that needs space data on demand without onboarding to yet another vendor portal.
# 1. Probe with no auth → 402 envelope with PaymentRequirements curl -sS 'https://2s.io/api/space/weather' # 2. Sign + retry with PAYMENT-SIGNATURE: curl -sS 'https://2s.io/api/space/weather' \ -H 'PAYMENT-SIGNATURE: <base64-json-payload>' # Or use the canonical runner (handles probe → sign → retry): # EVM_PRIVATE_KEY=0x... node --env-file=.env.local \ # --experimental-strip-types scripts/x402-pay.ts \ # 'https://2s.io/api/space/weather'
import { TwoS } from '@2sio/sdk'
const client = new TwoS({
privateKey: process.env.EVM_PRIVATE_KEY as `0x${string}`,
})
const result = await client.space.weather({})
console.log('endpoint:', result.endpoint)
console.log('cost:', result.costUsd, 'USDC')
console.log('tx:', result.settlement?.txHash)
console.log('data:', result.data)import os
from twosio import TwoS
client = TwoS(private_key=os.environ["EVM_PRIVATE_KEY"])
result = client.space.weather()
print("endpoint:", result.endpoint)
print("cost:", result.cost_usd, "USDC")
print("tx:", (result.settlement or {}).get("tx_hash"))
print("data:", result.data)// 1. Add @2sio/mcp to your MCP host config (Claude Desktop example below).
// EVM_PRIVATE_KEY funds x402 payments per call.
// claude_desktop_config.json
{
"mcpServers": {
"2sio": {
"command": "npx",
"args": ["-y", "@2sio/mcp"],
"env": { "EVM_PRIVATE_KEY": "0x..." }
}
}
}
// 2. Once the server is running, agents call this tool via standard MCP:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "space.weather",
"arguments": {}
}
}| Field | Type | Description |
|---|---|---|
ok | boolean | one of: true |
items | array | |
total | integer | Total matching rows upstream; null when unknown. |
source | object |
{
"ok": true,
"items": [
{
"kp": {
"latest": {
"time": "example",
"kp": 1,
"gScale": 1,
"gLabel": "example"
},
"recent": [
{
"time": "example",
"kp": 1,
"gScale": 1,
"gLabel": "example"
}
]
},
"solarWind": {
"time": "example",
"densityPerCm3": 1,
"speedKmPerSec": 1,
"temperatureK": 1
},
"xray": {
"time": "example",
"fluxLongWm2": 1,
"flareClass": "example",
"satellite": 1
},
"scales": {
"current": {
"observedAt": "example",
"rRadio": {
"scale": 1,
"label": "example"
},
"sRadiation": {
"scale": 1,
"label": "example"
},
"gGeomagnetic": {
"scale": 1,
"label": "example"
}
},
"forecast": [
{
"startsAt": "example",
"rMinorPercent": 1,
"rMajorPercent": 1,
"sPercent": 1,
"gScale": 1,
"gLabel": "example"
}
]
}
}
],
"total": 1,
"source": {
"provider": "example",
"url": "example",
"license": "example"
}
}