QAF NFT
  • Getting Started
  • 📚TERMS/DOMAINS
    • Network
    • Project
    • Contract
    • Category
    • Nft Item
    • Nft Item Attribute
    • Project Token
    • Marketplace Fees
    • Marketplace Token
    • Marketplace Items
  • ⚙️API REFERENCE
    • Postman Collection
    • Authentication
    • NFT API
      • List Networks
      • Create Project
      • Get Project Detail
      • Filter Projects
      • Deploy Contract
      • Get Contract Detail
      • Filter Contracts
      • Add Category
      • Update Category
      • Delete Category
      • Get Category Detail
      • Filter Categories
      • Create Nft Item
      • Batch Create Nft Item
      • Validate Metadata File
      • Mint Nft Items
      • Update Nft Item Metadata
      • Set Nft Item Category
      • Get Nft Item Detail
      • Filter Nft Items
      • Add Nft Item Attribute
      • Update Nft Item Attribute
      • Delete Nft Item Attribute
      • Get Nft Item Attribute Detail
      • Filter Nft Item Attributes
      • Get Balance by Nft Item and Address
      • Get Balance by Address
      • Get Balance by Nft Item
      • Filter Nft Item Transfers
      • Deploy Project Token
      • Get Project Token Detail
      • Init Project Token Transfer
      • Client Token Transfer
      • Init Project Token Allowance
      • Check Project Token Allowance
      • Filter Project Tokens
      • Get Project Token Balance by Symbol and Address
      • Get Project Token Balance by Address
      • Get Project Token Balance by Symbol
      • Update Marketplace Royalty Fee
      • Filter Marketplace Fees
      • Add Marketplace Token
      • Get Marketplace Token Detail
      • Init Marketplace Token Allowance
      • Check Marketplace Token Allowance
      • Filter Marketplace Tokens
      • Init List Nft Item on Marketplace
      • Init Buy Nft Item from Marketplace
      • Init Cancel Listing from Marketplace
      • Get Marketplace Item Detail
      • Filter Marketplace Items
      • Init Transfer Nft Item
      • Init Transfer Nft Item to Client
      • Transfer Nft Item from Client
      • Init Lock Nft Item
      • Init Nft Approval Permission
      • Check Nft Item Approval Permission
      • Create Project Session
      • Get Project Session Detail
      • Filter Project Sessions
      • Create Off Chain Transaction
      • Get Off Chain Transaction
      • Filter Off Chain Transactions
      • Upload File
    • Error Codes
    • FAQ
      • How can I implement listing Nft Item on marketplace service properly?
      • How can I implement buy Nft Item from marketplace service properly?
Powered by GitBook
On this page
  • Filter Marketplace Items
  • Example Response Body
  • Response Fields
  1. API REFERENCE
  2. NFT API

Filter Marketplace Items

This service returns marketplace items with pagination

Filter Marketplace Items

GET {{server-url}}/marketplace-items/filter

It returns list of marketplace items with pagination

Query Parameters

Name
Type
Description

page

Number

Represents page number. Default 0

orderDirection

String

Represents order direction. It can be ASC or DESC. Default DESC

size

Number

Represents content size. Default 10

id

String

Represents marketplace item's identifier.

sellerAddress

String

Represents wallet address of the marketplace item's seller.

symbol

String

Represents the currency symbol of marketplace item

Headers

Name
Type
Description

Authorization*

String

UUID formatted access token

PROJECT-ID*

String

UUID formatted project's identifier

{
    // Response
}
{
    // Response
}
{
    // Response
}
{
    // Response
}

Example Response Body

{
    "data": {
        "content": [
            {
                "id": 11,
                "sellerAddress": "0xe3b52cE4b365cF50A4e03F04B92ce542666f5C73",
                "price": 40000000000000000,
                "amount": 5,
                "nftItem": {
                    "id": 409,
                    "name": "r/place - 180",
                    "description": "Reddit r/place 2022 Edition - 180",
                    "url": "https://stagingnftgift.s3.eu-west-1.amazonaws.com/1649243914981",
                    "totalSupply": 180,
                    "contractType": "ERC1155",
                    "attributes": [],
                    "categories": []
                },
                "marketplaceToken": {
                    "icon": "https://ethereum.org/static/6b935ac0e6194247347855dc3d328e83/6ed5f/eth-diamond-black.webp",
                    "symbol": "BLW",
                    "name": "Blackwolf",
                    "address": "0xe3b52cE4b365cF50A4e03F04B92ce542666f5C73",
                    "artifactName": "Qaf20",
                    "decimal": 18,
                    "networkId": 4
                },
                "status": "LISTED"
            }
        ],
        "pageable": {
            "sort": {
                "sorted": true,
                "unsorted": false,
                "empty": false
            },
            "pageNumber": 0,
            "pageSize": 10,
            "offset": 0,
            "paged": true,
            "unpaged": false
        },
        "totalPages": 1,
        "totalElements": 1,
        "last": true,
        "numberOfElements": 1,
        "number": 0,
        "first": true,
        "size": 10,
        "sort": {
            "sorted": true,
            "unsorted": false,
            "empty": false
        },
        "empty": false
    },
    "message": null,
    "code": 0,
    "error": false
}

Response Fields

Key
Type
Description

id

Number

Represents marketplace item's identifier

sellerAddress

String

Represents wallet address of the marketplace item's seller.

price

BigNumber

Represents marketplace Item's price

amount

Number

Represents count of Nft item on the marketplace

nftItem

Object

Represents Nft Item's metadata object.

marketplaceToken

Object

Represents marketplace item's currency (marketplace token) informations

status

String

Represents marketplace item's status

PreviousGet Marketplace Item DetailNextInit Transfer Nft Item

Last updated 2 years ago

⚙️