Get Bid List By Round ID

Retrieve all bids submitted for a specific auction round using its unique ID

Query

📋

getBidListById

Retrieve all bids for a specific round by ID

Schema

getBidListById(
  roundId: String!
): [Bid]

Parameters

roundIdRequired

Type: String!

The unique ID of the auction round to retrieve bids from

Return Value

📦

Returns Array of Bid Objects

The query returns an array of Bid objects representing all bids placed in the specified round

Example

💻

Usage Example

Retrieving all bids for round abcd1234

query {
  getBidListById(roundId: "abcd1234") {
    userId
    roundId
    tokenAmount
    totalPrice
    tokenPrice
    tempTokenAmount
    tempTokenPrice
    delta
    pendingIncrease
    holdings {
      key
      value {
        crypto
        usd
      }
    }
    payType
    cryptoType
    placedAt
    updatedAt
    status
  }
}

Response Example

📤

Sample Response

Example bid list for round abcd1234

{
  "data": {
    "getBidListById": [
      {
        "userId": "user123",
        "roundId": "abcd1234",
        "tokenAmount": 100.0,
        "totalPrice": 50.0,
        "tokenPrice": 0.5,
        "tempTokenAmount": 0,
        "tempTokenPrice": 0,
        "delta": 0,
        "pendingIncrease": false,
        "holdings": [
          {
            "key": "BTC",
            "value": {
              "crypto": 0.0012,
              "usd": 50.0
            }
          }
        ],
        "payType": 2,
        "cryptoType": "BTC",
        "placedAt": 1625247600000.0,
        "updatedAt": 1625334000000.0,
        "status": 0
      },
      {
        "userId": "user456",
        "roundId": "abcd1234",
        "tokenAmount": 200.0,
        "totalPrice": 100.0,
        "tokenPrice": 0.5,
        "tempTokenAmount": 0,
        "tempTokenPrice": 0,
        "delta": 0,
        "pendingIncrease": false,
        "holdings": [
          {
            "key": "ETH",
            "value": {
              "crypto": 0.035,
              "usd": 100.0
            }
          }
        ],
        "payType": 2,
        "cryptoType": "ETH",
        "placedAt": 1625251200000.0,
        "updatedAt": 1625337600000.0,
        "status": 0
      }
    ]
  }
}

Use Cases

📊

Round Analytics

Analyze all bids in a specific round for insights and statistics

🏆

Competition Monitoring

View all competing bids in a round to track auction activity

💰

Total Value Calculation

Calculate total bid value and participation in a round

📈

Payment Method Distribution

Analyze payment methods and crypto types used in the round

Returned Fields

🔍

Bid Object Fields

Each bid includes comprehensive details

User & Round Info

userId, roundId

Token Details

tokenAmount, tokenPrice, totalPrice

Pending Changes

tempTokenAmount, tempTokenPrice, delta, pendingIncrease

Payment Info

payType, cryptoType, holdings

Timestamps

placedAt, updatedAt

Status

status (0: Not Confirmed, 1: Winner, 2: Failed)

💡

Tip

Use this query to display leaderboards, calculate total participation, or analyze bidding patterns for a specific round

Get Bid List By Round ID

Get Bid List By Round ID

On this page