Omni Terminal · Symbols Resolve

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://omniterminal.app/api/x402/v1/symbols/resolve", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "mentions": [
      "bitcoin",
      "BTC-PERP"
    ],
    "venue": "hyperliquid"
  }),
});
const data = await res.json();

curl -X POST \
  "https://omniterminal.app/api/x402/v1/symbols/resolve" \
  -H "Content-Type: application/json" \
  -d '{"mentions":["bitcoin","BTC-PERP"],"venue":"hyperliquid"}' \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "data_as_of": "2026-07-28T11:55:00.000Z",
  "freshness": {
    "age_seconds": 300,
    "data_as_of": "2026-07-28T11:55:00.000Z",
    "max_age_seconds": 1800,
    "status": "fresh"
  },
  "generated_at": "2026-07-28T12:00:00.000Z",
  "product_version": "v1",
  "registry": {
    "historical_as_of_supported": false,
    "snapshot_revision": 1785239700000,
    "temporal_mode": "current",
    "version": "hl_meta_ctx.v1"
  },
  "results": [
    {
      "alternatives": [],
      "asset_id": 0,
      "base": "BTC",
      "canonical_symbol": "hyperliquid:BTC:USDC:perp",
      "confidence": 0.97,
      "dex": "main",
      "input": "bitcoin",
      "market_type": "perp",
      "match_kind": "name_alias",
      "normalized_alias": "BITCOIN",
      "product_supported": true,
      "quote": "USDC",
      "resolution_status": "resolved",
      "settle": "USDC",
      "subscription_key": "BTC",
      "venue": "hyperliquid"
    }
  ],
  "schema": "market_entity_resolution.v1",
  "service": "omni.market_entity_resolution",
  "usage": {
    "mention_count": 1,
    "mention_limit": 20,
    "resolved_count": 1
  },
  "venue": "hyperliquid"
}