market-snapshot

name	market-snapshot
description	Fetch a token market snapshot (price/liquidity/volume) and return stable JSON (backed by Jupiter).
homepage	https://app.vecstack.com

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.