Uptick Service Documentation
  1. Developer documentation
Uptick Service Documentation
  • Platform introduction
    • Product Overview
    • Basic Terminology
  • User Guide
    • Service Callback method
    • Developer settlement process
    • Price and Fee Description
  • Developer documentation
    • Explanation of NFT Market Trading Models
    • Introduction to SDK and usage instructions.
    • Gateway authentication signature example
    • List of market trading contracts.
    • API
      • Collection of endpoints related to address book
      • Collection of endpoints related to asset
      • Collection of endpoints related to auction
      • Collection of endpoints related to common market
      • Collection of endpoints related to contract
      • Collection of endpoints related to coupon
      • Collection of endpoints related to limited-time coupon
      • Collection of endpoints related to the sale of specified NFTs.
      • Collection of endpoints related to fans
      • Collection of endpoints related to follow
      • Collection of endpoints related to Lazy minting
        • Query the information of the lazy minting collection.
        • Query lazy casting set extension information(logo banner twitter)
        • Modify the information of the lazy minting collection.
        • Modify lazy casting collection extension information (logo banner Twitter address)
      • Collection of endpoints related to nft
      • Collection of endpoints related to offer
      • Collection of endpoints related to order
      • Collection of endpoints related to wallet
      • Collection of endpoints related to words
      • Collection of endpoints related to product card
      • Collection of endpoints related to coupon code
  • Q&A
    • API invocation related issues
  • Contact us
    • Contact us
  • Collection of endpoints related to address book
    • Add address book.
      POST
    • Delete address book
      DELETE
    • Import address book by following fans
      GET
    • Query address book
      GET
    • Address book list
      GET
    • Update address book
      PATCH
  • Collection of endpoints related to asset
    • Query asset according to the ID.
      GET
    • Query assets by pagination.
      GET
    • Query asset transfers
      GET
  • Collection of endpoints related to auction
    • Create bid
      POST
    • Get the auction info.
      GET
    • Query the list of tokens I own,sort by creator
      GET
    • Get the auction info.
      GET
    • Query the list of tokens I own,sort by creator
      GET
  • Commemorative Card Management
    • Paginated Query of Commemorative Cards
    • Create Commemorative Card
    • Batch Create Commemorative Cards
    • Delete Commemorative Card
    • Query Commemorative Card Details
    • Paginated Query of Commemorative Cards
    • Paginated Query of Commemorative Cards
    • Paginated Query of Commemorative Cards
    • Paginated Query of Commemorative Cards
    • Paginated Query of Commemorative Cards
    • Update Commemorative Card
    • Query Commemorative Card Details
  • Collection of endpoints related to common market
    • List of ordinary sales contracts.
    • Information on listed NFTs
    • List of NFTs on the shelf.
    • Put on the shelf for sale.
  • Collection of endpoints related to contract
    • Add contract info
    • Delete contract
    • Query contract extension information(logo banner twitter)
    • Query contract info
    • Query contract by pagination.
    • Modify contract extension information
    • Modify the information of the contract.
  • Collection of endpoints related to coupon code
    • Create a coupon code.
    • List of collection.
    • Get coupon information.
    • List of NFTs on shelf.
    • Put on the shelf with preferential treatment.
  • Collection of endpoints related to coupon
    • Put on the shelf with limited-time coupon.
    • List of collection.
    • Get coupon information.
    • List of NFTs on shelf.
    • Put on the shelf with preferential treatment.
  • Collection of endpoints related to limited-time coupon
    • Put on the shelf with limited-time coupon.
    • List of collection.
    • Get couponTime information by coupon code.
    • Get couponTime information.
    • List of NFTs on shelf.
    • Put on the shelf with limited-time coupon.
  • Event Card Management
    • Paginated Query of Event Cards
    • Create Event Card
    • Batch Create Event Cards
    • Delete Event Card
    • Query Event Card Details
    • Perform a paged query of the activity list
    • Perform a paged query of the activity list
    • Perform a paged query of the activity list
    • Perform a paged query of the activity list
    • Paginated Query of Event Cards
    • Update Event Card
    • Create Verification
    • Paginated Query of Verification Records
    • Query Event Card Details
  • Collection of endpoints related to the sale of specified NFTs.
    • List of collection.
    • Get information.
    • List of NFTs on shelf.
    • Put specified NFTs on the shelf for sale.
  • Collection of endpoints related to fans
    • Add fans
    • Is fans
    • My fans
    • My focus
    • Delete fans
  • Collection of endpoints related to follow
    • Add follow
    • Is follow
    • Follow list
  • Collection of endpoints related to Lazy minting
    • Add NFT information (metadata information).
    • Add NFT information (metadata information).
    • Add presale information (ticket tiers).
    • Add placement preview images and multimedia information.
    • Add white list information (ticket tiers).
    • Delete NFT information (metadata information).
    • Delete the placement preview images and multimedia information.
    • Delete white list (ticket tiers).
    • Get current presale info
    • Get current presale info
    • Get rand nft info.
    • Is the current user on the whitelist
    • Details of the placement page.
    • Mint NFT sign
    • Details of NFT information (metadata information).
    • Details of NFT information (metadata information).
    • List of mints.
    • List of presale information (ticket tiers).
    • Details of placement preview images and multimedia information.
    • List of placement preview images and multimedia information.
    • Product details
    • Modify NFT information (metadata information).
    • Modify the placement preview images and multimedia information.
    • List of placement preview images and multimedia information.
  • Membership Card Management
    • Paginated Query of Membership Cards
    • Create Membership Card
    • Batch Create Membership Cards
    • Delete Membership Card
    • Query Membership Card Details
    • Perform a paged query of the membership cards.
    • Perform a paged query of the membership cards.
    • Perform a paged query of the membership cards.
    • Perform a paged query of the membership cards.
    • Paginated Query of Membership Cards
    • Update Membership Card
    • Create Verification
    • Paginated Query of Verification Records
    • Query Membership Card Details
  • Collection of endpoints related to nft
    • Add nft info
    • Add nft info
    • Delete nft
    • Get properties
    • Query NFT info
    • Query NFTs by pagination.
  • Collection of endpoints related to offer
    • List of offers received for the specified NFT.
    • Create a offer.
    • Search NFT highest offer list based on nft address
    • Search NFT highest offer list based on owner
    • Search NFT highest offer list based on owner
    • Get max offer group by token type
    • List of offers i have received.
    • My offer list.
  • Collection of endpoints related to order
    • Cancel order
    • Delete the unsuccessful orders.
    • Query according to the order number.
    • Order list
    • Nft Order history
    • Order in progress
    • Pre order
    • Sold order list
  • Collection of endpoints related to product card
    • Add NFT information.
    • Add white list information
    • Delete NFT information.
    • Delete white list.
    • Get current presale info
    • Query product card preview information
    • Get token data
    • Get token data update log
    • Is the current user on the whitelist
    • Mint NFT sign
    • Details of NFT information.
    • Details of NFT information.
    • List of mints.
    • Details of NFT information.
    • Query product card preview information
    • Product details
    • Modify NFT information (metadata information).
    • Modify NFT information (metadata information).
    • Modify product card preview information
    • List of white list.
    • write data
  • Promo Code Card Management
    • Paginated Query of Promo Code Cards
    • Create Promo Code Card
    • Batch Create Promo Code Cards
    • Delete Promo Code Card
    • Query Promo Code Card Details
    • Perform a paged query of the coupon list.
    • Perform a paged query of the coupon list.
    • Perform a paged query of the coupon list.
    • Perform a paged query of the coupon list.
    • Paginated Query of Promo Code Cards
    • Update Promo Code Card
    • Create Verification
    • Paginated Query of Verification Records
    • Query Promo Code Card Details
  • Collection of endpoints related to wallet
    • Add wallet info
    • Edit wallet info
    • Get wallet info
  • Collection of endpoints related to words
    • Add words
    • Delete message/reply records
    • Delete message/reply records to a group
    • Message/reply records to a group
    • Leave messages when adding to a group..
    • Message/Reply List
    • Message/Reply page list
    • Message/Reply read all
    • Message/Reply records
  1. Developer documentation

Explanation of NFT Market Trading Models

1.
Fixed Price Sale
Model Description: This model applies to a single NFT or multiple NFTs, where the seller sets a fixed price for the NFT(s), and the buyer can purchase it directly at that price.
Features:
Simple and straightforward; no bidding is required between the buyer and seller.
Suitable for quick sales and NFTs at a predetermined price.
Applicable Scenarios: Sellers looking to sell single or multiple NFTs at a fixed price.

2.
Timed Auction
Model Description: Suitable for trading ERC-721 NFTs. The seller sets a starting price, a reserve price (optional), a buy-it-now price (optional), and a time limit. Buyers can place bids during the auction period, and the highest bidder wins the NFT once the auction ends. If no bids are placed, the NFT is removed from the auction when the time expires.
Features:
Potential for higher profits through bidding.
Time constraints create a sense of scarcity and urgency.
Applicable Scenarios: Sellers looking to auction a single NFT at a higher price through market competition.
3.
Understanding Timed Auction Terms Before participating in a timed auction, it's essential to understand the following terms:
Starting Price: The minimum price at which the NFT can be auctioned. Any bids below this amount will be rejected.
Reserve Price Mechanism: If a reserve price is set, bids above this price will be accepted. If no reserve price is set, the highest bid at the end of the auction wins the NFT.
Buy-It-Now Price: If the bid exceeds the buy-it-now price, the auction ends immediately, and the NFT is sold at that price.
Withdrawal Mechanism: Sellers can withdraw their auction item before receiving a valid bid. Once a valid bid is placed, the auction cannot be canceled.
Minimum Bid Increment: Each new bid must be at least 5% higher than the current bid. If a higher bid appears, the previous bid will be refunded.
Extension Mechanism: Any bids placed in the last 10 minutes of the auction will extend the auction by an additional 10 minutes.
No Bid Mechanism: If no bids are placed by the end of the auction, the NFT will be considered unsold.
Auction Acceptance Mechanism: After the auction ends, the platform will follow these rules:
If a reserve price is set and the final bid exceeds it, the auction is "successful."
If the final bid is below the reserve price, the auction is "abandoned."
If no reserve price is set, the auction is "successful."
Auction Service Fee: The platform charges a 5% service fee on the final bid amount to maintain platform operations.

3.
Discount Promotion
Model Description: Sellers offer NFTs at discounted prices, optionally binding the discount to the ownership of specific NFTs (e.g., all or any NFTs in a collection), encouraging buyers to purchase quickly to take advantage of the offer.
Features:
Attracts buyers with discounts, boosting sales.
Often used for marketing activities or to promote rapid NFT circulation.
Applicable Scenarios: NFT project owners or sellers looking to promote sales or attract attention with discount offers.

4.
Exclusive Sale
Model Description: Sellers set conditions for eligibility, such as requiring ownership of specific NFTs. Only buyers who meet these conditions can purchase the NFT.
Features:
Offers a more private or targeted sales approach.
Buyers can be filtered based on specific criteria like identity or holdings.
Applicable Scenarios: Sellers offering exclusive or limited-edition NFTs to a specific group of users.

5.
QR Code Claim
Model Description: This model involves users claiming an NFT by scanning a QR code.
Features:
Convenient claim method, ideal for offline events or quick NFT distribution.
Useful for giveaways or promotional events.
Applicable Scenarios: Engaging users through QR codes in online or offline events such as meetups, exhibitions, or campaigns.

6.
Limited-Time Discount
Model Description: This is a special variant of fixed price sales, where the seller sets a discounted price for NFTs within a specific time frame. During this period, buyers can purchase the NFT at a discount. Once the time ends, the price returns to its original value.
Features:
Buyers can purchase NFTs at a discounted price within a limited time.
Creates urgency and motivates buyers to act quickly.
Increases sales and generates buying momentum.
Applicable Scenarios: Sellers looking to attract more buyers through promotional campaigns or limited-time offers.

7.
Lazy Mint Sales Model
Model Description: In this model, sellers can choose "lazy mint" NFTs. The seller lists the NFT and sets a price but does not mint the NFT (i.e., does not create it on the blockchain) until it is sold.
When a buyer makes a purchase, the NFT is minted and transferred to the buyer.
Features:
Saves minting costs: Sellers avoid paying minting fees before a sale is confirmed.
Easy listing: Sellers can quickly list and showcase NFTs without minting them in advance.
Applicable Scenarios: Sellers who wish to reduce upfront costs, especially if the NFT sale is not guaranteed, and want to minimize risk.

8.
RWA Mint
Model Description: RWA Mint, based on the ERC-1948 protocol, supports NFTs with dynamic data updates. Similar to lazy minting, the NFT is not minted at the time of listing. Instead, the metadata of the NFT can be updated or modified dynamically during the sale or even after the transaction.
Once purchased by a buyer, the content of the NFT (such as metadata, attributes, etc.) can be updated in real-time according to predefined rules or conditions.
Features:
Dynamic Data: The NFT's content can be updated dynamically, moving beyond fixed metadata.
Flexibility: Suitable for NFTs that need content or status updates during the sales process or afterward.
Similar to Lazy Minting: The NFT is not minted until a purchase is made and is then linked to the buyer's wallet.
Applicable Scenarios: NFTs that require dynamic updates, tracking, or modifications of metadata throughout the NFT lifecycle.

Order Transaction Revenue Sharing
In the NFT market, revenue sharing consists of a platform fee and a creator royalty. Both the platform and creators collect a percentage from each successful transaction. The details include:
1.
Platform Fee
The platform charges a service fee based on the final sale price of the NFT (typically 5% of the total transaction amount).
This fee supports the platform's operations, service guarantees, and feature maintenance.
2.
Creator Royalties (Optional)
Creators can set a royalty percentage, and each time the NFT is resold, the creator will receive a share of the sale amount.
Royalties typically range from 0% to 10%, depending on what the creator sets.
Example If the final price of an NFT is 100 UPTICK, with a platform fee of 5% and a creator royalty of 5%:
Platform Fee: 100 UPTICK × 5% = 5 UPTICK
Creator Royalty: 100 UPTICK × 5% = 5 UPTICK
Seller's Final Revenue: 100 UPTICK - 5 UPTICK - 5 UPTICK = 90 UPTICK
Previous
Price and Fee Description
Next
Introduction to SDK and usage instructions.
Built with