plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "0xarchive",
  "version": "1.0.3",
  "description": "Real-time and historical market data for Hyperliquid and Lighter. Research and build with tick-level order books, trades, funding, open interest, account positions, liquidation levels, and more.\n\nSet up market and wallet intelligence alerts through webhooks.",
  "author": {
    "name": "Archive Labs Inc",
    "email": "support@0xarchive.io",
    "url": "https://0xarchive.io"
  },
  "homepage": "https://0xarchive.io",
  "keywords": [
    "hyperliquid",
    "lighter",
    "market data",
    "order book",
    "funding",
    "webhooks"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "0xArchive",
        "shortDescription": "Market data and webhooks",
        "longDescription": "Real-time and historical market data for Hyperliquid and Lighter. Research and build with tick-level order books, trades, funding, open interest, account positions, liquidation levels, and more.\n\nSet up market and wallet intelligence alerts through webhooks.",
        "developerName": "Archive Labs Inc",
        "category": "Finance",
        "websiteURL": "https://0xarchive.io",
        "supportURL": "https://0xarchive.io/contact",
        "privacyPolicyURL": "https://0xarchive.io/privacy",
        "termsOfServiceURL": "https://0xarchive.io/terms",
        "defaultPrompt": [
          "What share of Hyperliquid BTC top-of-book depth is in the three largest resting orders?",
          "Compare BTC funding on Hyperliquid and Lighter over the last 24 hours, and tell me which was more expensive for longs.",
          "What percent of Hyperliquid perps are trading above their session VWAP right now?"
        ],
        "brandColor": "#21C55E",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Current order book for one market",
              "prompt": "Show the current Hyperliquid BTC order book: best bid, best ask and spread.",
              "tools_triggered": "get_orderbook",
              "expected_behavior": "Returns the live BTC order book snapshot with its timestamp, and states the best bid and best ask with their sizes, the mid price and the spread in dollars and basis points."
            },
            {
              "description": "Funding comparison across the two venues",
              "prompt": "Compare BTC funding on Hyperliquid and Lighter over the last 24 hours, and tell me which was more expensive for longs.",
              "tools_triggered": "get_funding_history, get_lighter_funding",
              "expected_behavior": "Fetches BTC funding rates for the last 24 hours from each venue separately, compares them in the same units (fraction per interval, as returned), and says which venue charged longs more. It does not invent values for either venue."
            },
            {
              "description": "Market breadth right now",
              "prompt": "What percent of Hyperliquid perps are trading above their session VWAP right now?",
              "tools_triggered": "get_breadth_above_vwap_current",
              "expected_behavior": "Reports the current percentage of eligible perps above their session VWAP, with the session date, the calculation time and the counts behind it (eligible, above, below)."
            },
            {
              "description": "Recent price history as candles",
              "prompt": "Show ETH 4-hour candles on Hyperliquid for the last day and summarize the price range.",
              "tools_triggered": "get_candles",
              "expected_behavior": "Returns the 4-hour OHLCV candles for ETH over the last 24 hours and summarizes the high, the low and the change from the first open to the last close."
            },
            {
              "description": "Order-level concentration at the top of the book",
              "prompt": "What share of Hyperliquid BTC top-of-book depth is in the three largest resting orders?",
              "tools_triggered": "get_l4_orderbook",
              "expected_behavior": "Retrieves the current BTC order-level (L4) book and reports the share of top-of-book depth held by the three largest resting orders, with the snapshot time, the sizes used and how many orders per side were considered. This is the case shown in the demo recording."
            }
          ],
          "negative": [
            {
              "description": "Trading is out of scope: the plugin reads market data and cannot place orders.",
              "prompt": "Buy 0.5 BTC on Hyperliquid at market for me.",
              "expected_behavior": "Does not attempt to trade. Explains that 0xArchive provides market data and alerts, not order placement."
            },
            {
              "description": "Moving funds is out of scope: the plugin cannot transfer assets.",
              "prompt": "Send 100 USDC from my Hyperliquid account to 0x2f1c09d7e3a5b4c6f8e0d1a2b3c4d5e6f7a8b9c0.",
              "expected_behavior": "Does not attempt a transfer. Explains that 0xArchive cannot move funds or sign transactions."
            },
            {
              "description": "Exchanges outside coverage: 0xArchive covers Hyperliquid and Lighter only.",
              "prompt": "What is the BTC price on Binance right now?",
              "expected_behavior": "Does not present a Binance price. Explains that 0xArchive covers Hyperliquid and Lighter, and may offer the Hyperliquid or Lighter BTC price instead."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "0xArchive does not sell products or process payments in ChatGPT.",
        "demo_recording_url": "https://drive.google.com/file/d/1PvRJTYXzHNo2cpBF4Zd5K64GUpFm_7AL/view?usp=sharing"
      },
      "publication": {
        "release_notes": "Market data for Hyperliquid and Lighter (order books, trades, candles, funding, open interest, liquidations, account positions, coverage and data quality) and webhook alert management. Every tool states readOnlyHint, destructiveHint, openWorldHint and idempotentHint explicitly to match its behavior: reads are closed-world, open world is set only on webhook tools that deliver to a customer-provided URL, and tools that delete, overwrite, reset state or send irreversibly are destructive."
      },
      "apps": "./.app.json"
    }
  }
}