NYYU Logo
APIBid

Get Bid By Admin

Admin access to retrieve any user's bid information

Get Bid By Admin

Admin-only query to retrieve any user's bid information

🔐
Admin Access Required

This query is accessible only to users with ADMIN privileges

Query

🔍
getBidByAdmin
Retrieve any user's bid for a specific round

Schema

getBidByAdmin(
  userId: String!
  round: Int!
): Bid

Parameters

userIdRequired
Type: String!
The ID of the user whose bid you want to retrieve
roundRequired
Type: Int!
The round number to retrieve the bid for

Return Value

📦
Returns Bid Object

The query returns the Bid object for the specified user and round

Example

💻
Usage Example
Admin retrieving user's bid
query {
  getBidByAdmin(
    userId: "user123"
    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 for user123 in round 12
{
  "data": {
    "getBidByAdmin": {
      "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

🔍
User Support

Help users troubleshoot bid issues by viewing their bid details

📊
Bid Monitoring

Monitor specific user bids for compliance and verification

⚖️
Dispute Resolution

Review bid details when resolving user disputes or complaints

📈
Analytics

Analyze individual user bidding patterns and behavior

💡
Admin Responsibility
Use this query responsibly and only for legitimate administrative purposes. Respect user privacy and data protection policies.