Game Status

Fetch your active positions for a game along with projected winnings based on the current price at the time of the request. Also returns any streaks you are on track to win.

Endpoint

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

Query Parameters

Parameter	Type	Required	Description
asset	string	Yes	The asset the game is running on (e.g. BTC_USDT)
token	string	Yes	The currency used for the position (e.g. USDC)
network	string	Yes	The network the position was placed on (e.g. mainnet, testnet)
interval	number	Yes	The game duration in seconds (e.g. 60, 3600, 86400)

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/status?asset=BTC_USDT&token=USDC&network=testnet&interval=86400';

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

{
  "positions": [
    {
      "gid": "489808",
      "c": "USDC",
      "a": "BTC_USDT",
      "id": 1,
      "f": "5",
      "sp": "66169",
      "cm": false,
      "cmt": null,
      "w": 4.587819563491935,
      "r": -8.243608730161291,
      "pw": "0x79a0f3D2c6765cff1b36F6A942c5D8241c3BB8a9",
      "win": null,
      "t": "1771495586504",
      "tx": null,
      "txid": "95c7bbf3-94c7-4141-8401-719b634a7552",
      "p": null,
      "created_at": "2026-02-19T10:06:26.505Z",
      "st": "success",
      "it": 86400,
      "n": "testnet",
      "username": "John Doe",
      "avatar": {
        "imageUrl": "/avatars/default.svg",
        "backgroundColor": "#4285f4"
      }
    }
  ],
  "streaks": []
}

Response Fields

Root

Field	Type	Description
positions	array	List of active positions placed in the current game
streaks	array	List of streaks you are on track to win based on current projected results

positions[]

Field	Type	Description
gid	string	Unique identifier of the game the position belongs to
c	string	Currency used for the position (e.g. USDC)
a	string	Asset the position was placed on (e.g. BTC_USDT)
id	number	User ID of the position owner (shared across all positions by the same user)
f	string	The stake amount placed
sp	string	The predicted price submitted by the user
cm	boolean	Whether the position has been claimed
cmt	string | null	Claim transaction hash, null if not yet claimed
w	number	Projected winnings if the game ended at the time of this request
r	number	Projected return percentage if the game ended at the time of this request
pw	string	The wallet address of the position owner
win	number | null	Final winnings, null if the game is still ongoing
t	string	Unix timestamp in milliseconds of when the position was placed
tx	string | null	Transaction hash of the position, null if not yet confirmed
txid	string	Internal unique identifier for the transaction
p	any | null	Additional position metadata, null if not applicable
created_at	string	ISO 8601 timestamp of when the position was created
st	string	Status of the position (e.g. success)
it	number	Game interval in seconds
n	string	Network the position was placed on (e.g. testnet, mainnet)
username	string	Display name of the position owner

positions[].avatar

Field	Type	Description
imageUrl	string	URL of the user's avatar image
backgroundColor	string	Hex color code of the avatar background