Increase Existing Bid

Raise your token amount or price to stay competitive in the auction

Mutation

📈

increaseBid

Increase token amount or price of your existing bid

Schema

increaseBid(
  roundId: String!
  tokenAmount: Float!
  tokenPrice: Float!
  payment: Int!
  cryptoType: String
): Bid

Parameters

roundIdRequired

Type: String!

The ID of the auction round containing your bid

tokenAmountRequired

Type: Float!

New token amount (can be same or higher than original)

tokenPriceRequired

Type: Float!

New price per token (must be ≥ original price)

paymentRequired

Type: Int!

Payment method:

• 1 - CREDIT

• 2 - CRYPTO

• 3 - WALLET

cryptoTypeOptional

Type: String

Cryptocurrency type - required if payment is CRYPTO

Return Value

📦

Returns Updated Bid Object

The mutation returns the updated Bid object if successful

Example

💻

Usage Example

Increasing bid amount and price

mutation {
  increaseBid(
    roundId: "abcd1234"
    tokenAmount: 150.0
    tokenPrice: 0.6
    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

⚠️

Increase Requirements

Rules for increasing bids

Price Minimum

New price must be greater than or equal to your original bid price

Round Status

Round must have status STARTED

Crypto Timing

CRYPTO payments must be made at least 10 minutes before round end

Round Minimum

Price must exceed the round's minimum token price

Use Cases

📊

Competitive Adjustment

Increase your bid price to outbid competitors and improve winning chances

📈

Volume Increase

Purchase more tokens by increasing your token amount

💰

Price Optimization

Adjust to market conditions as token prices fluctuate during the round

🎯

Last-Minute Strategy

Make final adjustments before the auction round closes

Delta Calculation

🔢

Understanding Delta

How bid increases are calculated

Delta Field

The delta field represents the price difference between your current and previous bid

delta = (newTokenPrice × newTokenAmount) - (oldTokenPrice × oldTokenAmount)

Payment Adjustment

You only pay the delta amount when increasing a bid, not the full new amount

💡

Strategy Tip

You can increase your bid multiple times before round end - monitor competitor activity and adjust strategically

Increase an Existing Bid