Skip to main content

Create an Order

A guide on how to create an order for Marketplace

Updated over a month ago

The Marketplace enables users to create customized over-the-counter (OTC) token sale orders. These orders can be configured for public or private access, priced in various tokens, and optionally include a vesting schedule.

This section outlines the step-by-step process for creating a new order.


Step 1: Access the Marketplace

Navigate to the Marketplace from the app's sidebar on the left.
To initiate the order creation process, click the “Create New” button at the top-left corner of the interface.


Step 2: Define the Token for Sale and Price of an Order

In the order setup form:

  • Amount: Specify the exact quantity of the token to be sold.

  • Token: Select the token you wish to sell from the dropdown list.

  • Price: Enter the amount of the selected payment token the buyer will be required to pay.

  • Payment Token: Choose the token you want to receive in exchange (it can be any mint address).


Once the sale amount and price are set, the system will automatically calculate the Discount value and Price per token.
Discount represents the difference between the contract’s notional value and price, expressed as a percentage. Depending on the pricing configuration, the discount may be either positive or negative.
Price per token represents the total price of the order in $ divided by the number of tokens being received.


Step 3: Configure Listing Visibility

Specify whether the order should be:

  • Public: The order will be visible to all users on the Marketplace. Any user may review and purchase it.

  • Private: The order will be accessible only to a specific wallet address defined by the creator. It will not appear in the public order book and can only be accepted by the designated address.

Private orders are commonly used for direct, one-to-one OTC deals.


Step 4: Define Expiry Conditions

You can set an expiry condition for the order:

  • No Expiry: The order will remain active indefinitely until it is accepted or manually canceled.

  • Expires On: Specify an exact expiration date and time (in UTC). Once expired, the order becomes inactive and cannot be executed.


Step 6: Configure the Contract Delivery Type

Decide how the token funds will be delivered to the buyer upon order execution:

  • Instant: Tokens are transferred to the buyer’s wallet immediately after the order is accepted.

  • Vested: Tokens are distributed over time based on a custom vesting schedule.
    When selecting this option, the following vesting parameters must be configured:

    • Cliff Duration

    • Start Time

    • Unlock Frequency

    • Total Vesting Duration

This functionality is handy for token allocations requiring delayed or gradual distribution. For more information on how to set up a vesting schedule, please check out this guide.


Step 7: Finalize and Submit the Order

Please review all the details you entered to ensure they're correct. Once confirmed:

  • Click the “Place Order” button.

  • Approve the transaction in your connected wallet to finalize the order creation.

The order will now appear in the appropriate section of the Marketplace interface:

  • Public orders will appear in the All Orders tab.

  • Private and personal orders will appear under My Orders.


Summary of Order Parameters

Parameter

Description

Token for Sale

The token and amount being offered

Payment Token & Price

The token and the price that the buyer must pay

Discount

Automatically calculated percentage based on the price-to-value ratio

Listing Type

Public (open to all users) or Private (restricted to a specific wallet)

Expiry

Defines if and when the order will expire

Delivery Type

Instant or Vested (with custom unlock schedule)

Did this answer your question?