NYYU Logo
APIBid

Get Bid List By User

Retrieve all bids placed by the authenticated user across all auction rounds

Get Bid List By User

Retrieve your complete bidding history across all auction rounds

Query

📝
getBidListByUser
Retrieve all your bids across all rounds

Schema

getBidListByUser: [Bid]

Parameters

â„šī¸
No Parameters Required

This query requires no parameters. Your user ID is automatically obtained from your JWT authentication token.

Return Value

đŸ“Ļ
Returns Array of Bid Objects

The query returns an array of all Bid objects placed by you across all auction rounds

Privacy & Security

🔒
User Privacy Protected
Your data is secure and private
✓
Authentication Required

Valid JWT token required to access your bid history

✗
No Access to Other Users

You cannot retrieve bids placed by other users

✓
Complete History

Access all your bids regardless of round or status

Example

đŸ’ģ
Usage Example
Retrieving your complete bid history
query {
  getBidListByUser {
    userId
    roundId
    tokenAmount
    totalPrice
    tokenPrice
    tempTokenAmount
    tempTokenPrice
    delta
    pendingIncrease
    holdings {
      key
      value {
        crypto
        usd
      }
    }
    payType
    cryptoType
    placedAt
    updatedAt
    status
  }
}

Response Example

📤
Sample Response
Example of your bid history
{
  "data": {
    "getBidListByUser": [
      {
        "userId": "currentUser",
        "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": 1
      },
      {
        "userId": "currentUser",
        "roundId": "round13",
        "tokenAmount": 150.0,
        "totalPrice": 75.0,
        "tokenPrice": 0.5,
        "tempTokenAmount": 0,
        "tempTokenPrice": 0,
        "delta": 0,
        "pendingIncrease": false,
        "holdings": [
          {
            "key": "WALLET",
            "value": {
              "crypto": 0,
              "usd": 75.0
            }
          }
        ],
        "payType": 3,
        "cryptoType": null,
        "placedAt": 1625334000000.0,
        "updatedAt": 1625420400000.0,
        "status": 0
      }
    ]
  }
}

Use Cases

📊
Portfolio Overview

View all your active and historical bids in one place

💰
Investment Tracking

Track total investment across all auction rounds

🏆
Win Rate Analysis

Calculate your success rate across all participated rounds

📈
Strategy Review

Review past bidding patterns to improve future strategies

đŸ’ŗ
Payment History

View payment methods and holdings used across all bids

âąī¸
Timeline View

See chronological history of your bidding activity

Data Insights

📊
Analyze Your Bidding Activity
What you can learn from your bid list
Total Investment

Sum all totalPrice values

totalInvestment = ÎŖ(bid.totalPrice)

Win Rate

Calculate percentage of winning bids

winRate = (status=1 count / total) × 100%

Token Accumulation

Total tokens won across rounds

totalTokens = ÎŖ(bid.tokenAmount) where status=1

Average Bid Size

Mean investment per bid

avgBid = totalInvestment / bidCount

💡
Tip
Use this query to build a personal dashboard showing your bidding statistics, win rate, and investment overview. Filter by status to separate active bids from completed ones.