Market Snapshot

Fetch stable JSON market data including price, liquidity, and volume for one or more tokens using Jupiter-backed sources.

Security Scan

The skill's requests and runtime instructions are consistent with its stated purpose: it performs simple GET requests to a known vecstack endpoint and returns stable JSON market snapshots.

Purpose & Capability

The name/description say it will fetch Jupiter-backed market snapshots; the SKILL.md only requires calling a vecstack API endpoint and returning JSON. There are no unrelated binaries, credentials, or config paths requested.

Instruction Scope

Instructions are narrowly scoped to doing HTTP GETs to https://app.vecstack.com/api/skills/market-snapshot, parsing the JSON, and returning a structured JSON object. The skill does not instruct reading local files or environment variables. Important privacy note: user token queries (symbols/names/mints) are sent to the third-party vecstack endpoint and may be logged by that service.

Install Mechanism

No install spec or code files — instruction-only. Nothing is written to disk or fetched during install.

Credentials

The skill declares no environment variables or credentials and its instructions do not require any secrets. This is proportionate to a read-only market-data fetcher.

Persistence & Privilege

always is false and the skill does not request persistent system-wide privileges or modify other skills' configurations. Autonomous invocation is allowed (platform default) but not excessive here.

Assessment

This skill contacts a third-party endpoint (app.vecstack.com) with whatever token identifiers the user provides and returns that service's snapshot as JSON. It asks for no credentials and does not access local files, but you should: (1) avoid sending any sensitive strings (private keys, wallet seeds) as query input, (2) review vecstack's privacy/terms if you care about logging, and (3) be aware that cached URLs may be reused unless you append a cache-buster for fresh data. Overall the skill appears coherent for its purpose.

Market Snapshot (Skill-Only, OpenClaw)

This skill is designed for OpenClaw/ClawHub bots that need a fast, low-friction market snapshot.

What This Skill Does

• Calls a hosted market snapshot endpoint (/skills/market-snapshot) with one or more token queries.
• The API resolves tokens + fetches pricing/metadata server-side (backed by Jupiter Tokens V2 + Price V3).
• Emits a stable JSON object (no prose) so other agents/bots can parse it reliably.

What This Skill Will Not Do

• It will not create or manage wallets.
• It will not request, store, or handle private keys / seed phrases.
• It will not execute swaps or provide "trade recommendations".

How To Use

When the user asks for prices, market snapshots, token metadata, or "what is X doing", run a snapshot.

Input formats supported:

• Symbols: SOL, USDC, JUP
• Names: solana, jupiter
• Mints: So11111111111111111111111111111111111111112

If multiple tokens are provided, resolve all of them and return a combined snapshot.

Data Sources (GET, No Headers Needed)

• Market snapshot:
  • https://app.vecstack.com/api/skills/market-snapshot?q=<CSV_TOKENS>&source=openclaw

Examples (copy/paste):

• Single token:
  • https://app.vecstack.com/api/skills/market-snapshot?q=SOL&source=openclaw
• Multiple tokens (comma-separated, no spaces):
  • https://app.vecstack.com/api/skills/market-snapshot?q=SOL,USDC,JUP&source=openclaw

Notes:

• web_fetch caches by URL. If the user explicitly needs "fresh right now" data, append a cache-buster query param like &_t=<unix> to the URL.
• Do not invent values. If a fetch fails, keep null fields and include an entry in warnings/errors.

Output Contract (Return JSON Only)

Return a single JSON object with this shape:

{
  "as_of_unix": 0,
  "provider": "jupiter",
  "inputs": ["SOL", "USDC"],
  "tokens": [
    {
      "query": "SOL",
      "mint": "So11111111111111111111111111111111111111112",
      "symbol": "SOL",
      "name": "Wrapped SOL",
      "decimals": 9,
      "verified": true,
      "tags": [],
      "liquidity_usd": null,
      "mcap_usd": null,
      "fdv_usd": null,
      "usd_price": null,
      "price_change_24h_pct": null,
      "stats": {
        "5m": {
          "price_change_pct": null,
          "volume_usd": null,
          "buy_volume_usd": null,
          "sell_volume_usd": null
        },
        "1h": {
          "price_change_pct": null,
          "volume_usd": null,
          "buy_volume_usd": null,
          "sell_volume_usd": null
        },
        "24h": {
          "price_change_pct": null,
          "volume_usd": null,
          "buy_volume_usd": null,
          "sell_volume_usd": null
        }
      },
      "sources": {
        "token_search_url": null,
        "price_url": null
      }
    }
  ],
  "warnings": [],
  "errors": []
}

Field rules:

• as_of_unix: set to current Unix time when you finish assembling the response.
• liquidity_usd, mcap_usd, fdv_usd, and stats.* are populated from Tokens V2 search when present.
• usd_price and price_change_24h_pct are populated from Price V3 when present.
• warnings: non-fatal issues (missing price, ambiguous match, rate limits, etc).
• errors: fatal issues that prevented a snapshot (e.g., all sources failed).

Implementation Notes For OpenClaw

• Prefer the web_fetch tool for the endpoint, using extractMode=text so the body stays parseable as JSON.
• If web_fetch returns non-JSON content, retry once with a cache-buster (append &_t=<unix>).
• Keep the final response strictly JSON.