Get Bid List by Round Number

Retrieve all confirmed bids for a specific auction round using its number

ℹ️

Confirmed Bids Only

This query returns only confirmed bids. Unconfirmed or pending bids are not included in the results.

Query

🔢

getBidListByRound

Retrieve confirmed bids by round number

Schema

getBidListByRound(
  round: Int!
): [Bid]

Parameters

roundRequired

Type: Int!

The round number to retrieve confirmed bids from (e.g., 1, 2, 3, 12)

Return Value

📦

Returns Array of Confirmed Bid Objects

The query returns an array of Bid objects that are confirmed for the specified round number

Round Number vs Round ID

🔍

Understanding the Difference

Round Number vs Round ID

🔢

Round Number

Sequential integer identifier

✓ Human-readable (1, 2, 3...)

✓ Easy to reference

✓ Sequential numbering

round: 12

🆔

Round ID

Unique string identifier

✓ Unique across system

✓ Database-friendly

✓ Immutable reference

roundId: "abcd1234"

Example

💻

Usage Example

Retrieving confirmed bids for round 12

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

Response Example

📤

Sample Response

Confirmed bids for round 12

{
  "data": {
    "getBidListByRound": [
      {
        "userId": "user123",
        "roundId": "round12",
        "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": "round12",
        "tokenAmount": 200.0,
        "totalPrice": 100.0,
        "tokenPrice": 0.5,
        "tempTokenAmount": 0,
        "tempTokenPrice": 0,
        "delta": 0,
        "pendingIncrease": false,
        "holdings": [
          {
            "key": "WALLET",
            "value": {
              "crypto": 0,
              "usd": 100.0
            }
          }
        ],
        "payType": 3,
        "cryptoType": null,
        "placedAt": 1625251200000.0,
        "updatedAt": 1625337600000.0,
        "status": 0
      }
    ]
  }
}

Use Cases

🏆

Leaderboard Display

Display confirmed bids on a leaderboard for a specific round

📊

Round Statistics

Calculate total participation and bid values for a round

🎯

Competition Analysis

Analyze confirmed competitive bids in a specific round

📈

Historical Review

Review confirmed bid patterns from past rounds

💰

Volume Tracking

Track total confirmed bid volume per round

🔔

Public Visibility

Show confirmed bids publicly for transparency

Confirmed vs All Bids

🔄

Query Behavior

Understanding what this query returns

✓

Included: Confirmed Bids

Bids that have been placed and confirmed for the specified round

✗

Excluded: Unconfirmed Bids

Pending bids that are not yet confirmed are filtered out

Use Case Recommendation

Use this query for public-facing features where only verified, confirmed bids should be displayed. For admin purposes requiring all bids, use getBidListById instead.

💡

Tip

Use round numbers for user-friendly URLs and displays (e.g., /round/12). Round numbers are easier to reference and communicate than round IDs.

Get Bid List by Round Number

Get Bid List by Round Number

On this page