NYYU Logo
APIPresale Orders

Place New Presale Order

Create a new presale order to purchase tokens from active presale rounds

USER ACTION

Place New Presale Order

Create a new order to participate in active presale rounds and secure your token allocation.

Order Creation

This mutation allows users to place presale orders. Orders must be confirmed with payment to complete the purchase.

Overview

The placePreSaleOrder mutation enables users to create presale orders with specified token amounts and delivery destinations (internal wallet or external address).


GraphQL Schema

mutation {
  placePreSaleOrder(
    presaleId: Int!
    ndbAmount: Float!
    destination: Int!
    extAddr: String
  ): PreSaleOrder
}

Parameters

presaleId

Required

Int

The unique ID of the presale round you want to participate in.

ndbAmount

Required

Float

The amount of NDB tokens you wish to purchase in this order.

destination

Required

Int

Token delivery destination:

1Internal (NYYU Wallet)
2External (External Wallet Address)

extAddr

Optional

String

External wallet address to receive tokens. Required if destination is set to 2.


Return Value

Success Response

Returns a PreSaleOrder object containing:

idUnique order identifier
presaleIdAssociated presale round ID
userIdUser who placed the order
ndbAmountToken amount ordered
destinationDelivery destination (1=Internal, 2=External)
extAddrExternal address if applicable
statusOrder status (0=Pending payment)
createdAtOrder creation timestamp

Example Usage

Request - Internal Delivery

mutation PlaceInternalOrder {
  placePreSaleOrder(
    presaleId: 12
    ndbAmount: 1000.0
    destination: 1
  ) {
    id
    presaleId
    userId
    ndbAmount
    destination
    extAddr
    status
    createdAt
    updatedAt
  }
}

Response

{
  "data": {
    "placePreSaleOrder": {
      "id": 456,
      "presaleId": 12,
      "userId": 789,
      "ndbAmount": 1000.0,
      "destination": 1,
      "extAddr": null,
      "status": 0,
      "createdAt": 1704067200,
      "updatedAt": 1704067200
    }
  }
}

Request - External Delivery

mutation PlaceExternalOrder {
  placePreSaleOrder(
    presaleId: 12
    ndbAmount: 2500.0
    destination: 2
    extAddr: "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
  ) {
    id
    presaleId
    ndbAmount
    destination
    extAddr
    status
  }
}

Response

{
  "data": {
    "placePreSaleOrder": {
      "id": 457,
      "presaleId": 12,
      "ndbAmount": 2500.0,
      "destination": 2,
      "extAddr": "0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb",
      "status": 0
    }
  }
}

Payment Required

Orders are created with status 0 (pending). You must complete payment using one of the payment methods to confirm your order.


Order Status Values

Status: 0

Pending Payment

Order created, awaiting payment

⏱️

Status: 1

Processing

Payment received, processing

Status: 2

Completed

Order fulfilled


Use Cases

💼

Investment Portfolio

Place orders to build your token portfolio during early presale rounds with favorable pricing.

🎯

Strategic Allocation

Choose between internal wallet storage for trading or external delivery for cold storage security.

🔒

Secure Custody

Specify external addresses for direct delivery to hardware wallets or institutional custody solutions.

Quick Participation

Create orders quickly to secure your allocation before presale rounds reach capacity limits.


Best Practices

✅ Verify Presale Status

Ensure the presale round is active (status: 2) before placing orders to avoid rejected transactions.

🔍 Validate External Addresses

Double-check external wallet addresses before submission - incorrect addresses may result in permanent token loss.

💰 Check Presale Conditions

Review minimum/maximum purchase amounts and other conditions defined in the presale round before ordering.

⚡ Complete Payment Promptly

Orders remain pending (status: 0) until payment is confirmed. Complete payment to secure your allocation.


Order Workflow

🔄 Presale Order Lifecycle

📝

Create Order
Place order mutation

💳

Make Payment
Complete payment

Receive Tokens
Order completed