APIBid
Place a New Bid
Submit a new bid in an active auction round
Place a New Bid
Submit bids in active auction rounds with flexible payment options
Mutation
🎯
placeBid
Place a new bid in an auction round
Schema
placeBid(
roundId: String!
tokenAmount: Float!
tokenPrice: Float!
payment: Int!
cryptoType: String
): BidParameters
roundIdRequiredType:
String!The ID of the auction round to place a bid in
tokenAmountRequiredType:
Float!The number of tokens you want to purchase
tokenPriceRequiredType:
Float!Your bid price per token (must exceed round minimum)
paymentRequiredType:
Int!Payment method:
•
1 - CREDIT (credit card)•
2 - CRYPTO (cryptocurrency)•
3 - WALLET (NYYU wallet)cryptoTypeOptionalType:
StringCryptocurrency type (e.g., "BTC", "ETH", "BCH") - required if payment is CRYPTO
Return Value
📦
Returns Bid Object
The mutation returns the newly created Bid object if successful
Example
💻
Usage Example
Placing a bid with Bitcoin payment
mutation {
placeBid(
roundId: "abcd1234"
tokenAmount: 100.0
tokenPrice: 0.5
payment: 2
cryptoType: "BTC"
) {
userId
roundId
tokenAmount
totalPrice
tokenPrice
tempTokenAmount
tempTokenPrice
delta
pendingIncrease
holdings {
key
value {
crypto
usd
}
}
payType
cryptoType
placedAt
updatedAt
status
}
}Important Rules
⚠️
Bidding Requirements
Important rules to follow
Round Status
Bids can only be placed in rounds with status STARTED
Crypto Payment Timing
If using CRYPTO payment, bids must be placed at least 10 minutes before round end
Minimum Price
Token price must be greater than the round's minimum price
Crypto Type Required
If payment method is not CREDIT, cryptoType must be provided
Payment Methods
💳
Credit Card (1)
Instant payment processing with no cryptocurrency required
₿
Cryptocurrency (2)
Pay with Bitcoin, Ethereum, or other supported cryptocurrencies
👛
NYYU Wallet (3)
Use your NYYU wallet balance for instant payment
💡
Pro Tip
Monitor round minimum price and competing bids to optimize your bid price and increase winning chances