Spot Games

Fetch the current live game and the upcoming next game for a given asset and interval.

Endpoint

GET https://api.metafide.io/v1/surge/games/spot

Query Parameters

Parameter	Type	Required	Description
asset	string	Yes	The asset to fetch games for (e.g. BTC_USDT)
interval	number	Yes	The game duration in seconds (e.g. 60 for 1 minute, 3600 for 1 hour, 86400 for BTC_USDT for 24 hours)

Headers

Header	Value
Accept	*/*
x-api-key	Your Metafide API key

Example Request

// Node 18+ has native fetch — no import needed

const url = 'https://api.metafide.io/v1/surge/games/spot?asset=BTC_USDT&interval=60';

const options = {
  method: 'GET',
  headers: {
    'Accept': '*/*',
    'x-api-key': 'metafide_11111111111111111111111111111',
  },
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

Response

{
  "asset": "BTC_USDT",
  "interval": 60,
  "early_precision_window": false,
  "can_place_position": true,
  "nextGame": {
    "gid": "489888",
    "starts_at": 1771340769000,
    "ends_at": 1771340829000
  },
  "liveGame": {
    "gid": "489886",
    "open_price": "67036.047800",
    "ai_price": "67018.30517498772",
    "start_at": 1771340694000,
    "closes_at": 1771340754000,
    "ends_at": 1771340769000,
    "lobby": {
      "start_at": 1771340754000,
      "end_at": 1771340769000,
      "isLobby": false
    }
  },
  "timestamp": 1771340714973
}

Response Fields

Root

Field	Type	Description
asset	string	The asset the games are running for
interval	number	The game duration in seconds
early_precision_window	boolean	Whether the early precision bonus window is currently active
can_place_position	boolean	Whether the user is currently able to place a prediction
timestamp	number	Unix timestamp in milliseconds of when the response was generated

nextGame

Field	Type	Description
gid	string	Unique identifier of the next game
starts_at	number	Unix timestamp in milliseconds of when the next game starts
ends_at	number	Unix timestamp in milliseconds of when the next game ends

liveGame

Field	Type	Description
gid	string	Unique identifier of the live game
open_price	string	The asset price at the time the game opened
ai_price	string	The AI-generated target price for the current game
start_at	number	Unix timestamp in milliseconds of when the live game started
closes_at	number	Unix timestamp in milliseconds of when predictions close
ends_at	number	Unix timestamp in milliseconds of when the live game ends

liveGame.lobby

Field	Type	Description
start_at	number	Unix timestamp in milliseconds of when the lobby period starts
end_at	number	Unix timestamp in milliseconds of when the lobby period ends
isLobby	boolean	Whether the game is currently in the lobby period