Quickstart

1. Check the service is up

curl https://api.vatic.trading/health

{ "ok": true, "service": "vatic-api", "now": "2025-04-07T12:00:00.000Z" }

2. Fetch the current BTC 5-minute target price

curl "https://api.vatic.trading/api/v1/targets/active?asset=btc&types=5min"

{
  "now": "2025-04-07T12:00:00.000Z",
  "asset": "btc",
  "results": [
    {
      "marketType": "5min",
      "ok": true,
      "windowStart": 1744027500,
      "windowStartIso": "2025-04-07T12:05:00.000Z",
      "source": "chainlink",
      "price": 82450.75
    }
  ]
}

3. Get all market windows for today

curl "https://api.vatic.trading/api/v1/markets/timestamps?asset=btc&intervals=5min"

Each entry includes the Polymarket event slug and URL — no manual slug-building needed.

4. Compare target, snapshot close, and TWAP close

For a closed BTC 5m market:

curl "https://api.vatic.trading/api/v1/twap/resolve?asset=btc&type=5min&marketStart=1785603000"

Use /api/v1/twap/recent for the last closed markets:

curl "https://api.vatic.trading/api/v1/twap/recent?asset=btc&type=5min&limit=50"

5. Fetch an active Hyperliquid prediction market by official slug

curl -H "x-api-key: YOUR_API_KEY" \
  "https://api.vatic.trading/api/v1/hyperliquid/targets/active?slug=btc-above-78213-yes-may-04-0600"

{
  "now": "2026-05-03T10:20:04.943Z",
  "slug": "btc-above-78213-yes-may-04-0600",
  "source": "hyperliquid",
  "results": [
    {
      "outcomeId": 1,
      "marketSlug": "btc-above-78213-may-04-0600",
      "yesSlug": "btc-above-78213-yes-may-04-0600",
      "noSlug": "btc-above-78213-no-may-04-0600",
      "tradeUrls": {
        "yes": "https://app.hyperliquid.xyz/trade/btc-above-78213-yes-may-04-0600",
        "no": "https://app.hyperliquid.xyz/trade/btc-above-78213-no-may-04-0600"
      },
      "underlying": "BTC",
      "marketClass": "priceBinary",
      "period": "1d",
      "windowStart": 1777788000,
      "windowStartIso": "2026-05-03T06:00:00.000Z",
      "expiry": 1777874400,
      "expiryIso": "2026-05-04T06:00:00.000Z",
      "source": "hyperliquid",
      "price": 78213,
      "yesPrice": 0.592455,
      "noPrice": 0.407545,
      "question": "BTC above 78213 at 2026-05-04T06:00:00.000Z"
    }
  ]
}

Omit slug to return every active Hyperliquid prediction market in the live catalog. You can also pass the full Hyperliquid trade URL instead of only the slug.

6. Look up a token ID by market slug

curl "https://api.vatic.trading/api/v1/markets/tokenId?slug=will-arsenal-win-the-202526-english-premier-league&outcome=Yes"

{
  "tokenId": "71321045679252212594626385532706912750332728571942532289631379312455583992563",
  "outcome": "Yes",
  "outcomeIndex": 0,
  "conditionId": "0xabc...",
  "negRisk": false
}

7. Place a market order (API key required)

curl -X POST https://api.vatic.trading/api/v1/simpleOrders/easyMarketOrder \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "walletId": "550e8400-e29b-41d4-a716-446655440000",
    "slug": "will-arsenal-win-the-202526-english-premier-league",
    "outcome": "Yes",
    "side": "BUY",
    "amount": 50
  }'

{
  "ok": true,
  "orderId": "0xdef...",
  "status": "matched",
  "latencyS": 0.83,
  "order": { "slug": "...", "outcome": "Yes", "side": "BUY", "amount": 50 }
}

The easyMarketOrder endpoint resolves the token ID for you. For programmatic trading where you already have a tokenId, use createMarketOrder or createLimitOrder directly.

Get Started

Real-time

Concepts

1. Check the service is up

2. Fetch the current BTC 5-minute target price

3. Get all market windows for today

4. Compare target, snapshot close, and TWAP close

5. Fetch an active Hyperliquid prediction market by official slug

6. Look up a token ID by market slug

7. Place a market order (API key required)

​1. Check the service is up

​2. Fetch the current BTC 5-minute target price

​3. Get all market windows for today

​4. Compare target, snapshot close, and TWAP close

​5. Fetch an active Hyperliquid prediction market by official slug

​6. Look up a token ID by market slug

​7. Place a market order (API key required)

1. Check the service is up

2. Fetch the current BTC 5-minute target price

3. Get all market windows for today

4. Compare target, snapshot close, and TWAP close

5. Fetch an active Hyperliquid prediction market by official slug

6. Look up a token ID by market slug

7. Place a market order (API key required)