NYYU Logo
APIBid

Get Bid

Retrieve your bid for a specific auction round

Get Bid

Retrieve your bid information for a specific auction round

Query

🔍
getBid
Retrieve your bid for a specific round

Schema

getBid(
  round: Int!
): Bid

Parameters

roundRequired
Type: Int!
The round number to retrieve your bid for

Return Value

📦
Returns Bid Object

The query returns your Bid object for the specified round

Authentication

🔐
User Authentication

The user ID is automatically obtained from your JWT authentication token

Example

💻
Usage Example
Retrieving your bid for round 12
query {
  getBid(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
Example bid data
{
  "data": {
    "getBid": {
      "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
    }
  }
}

Use Cases

📊
Bid Status Check

Check your current bid status and details in an active round

💰
Payment Verification

Verify payment method and holdings for your bid

📈
Bid Analysis

Analyze your bid performance and pending increases

🎯
Decision Making

Review current bid to decide if you need to increase it

💡
Tip
Regularly check your bid status during active rounds to stay competitive and make timely adjustments