API Spec

• Items
  • getGet Project Items
  • getGet Marketplace Items
  • getGet Item

API docs by Redocly

ChainSafe Marketplace API (1.19.2)

Download OpenAPI specification:Download

ChainSafe: info@chainsafe.io URL: https://api.gaming.chainsafe.io/

Find out more about ChainSafe

Items

This section lists all the APIs related to marketplace items.

Get Project Items

Get all the items for a project. You can provide various filters to get the items you want.

path Parameters

projectID required

string Project ID

query Parameters

chainId required	string Chain ID
tokenContractAddress	string Token Contract Address
tokenId	string Token ID
seller	string Seller Address
status	string (item_status) Enum: "sold" "listed" "canceled" Status of the item
uniqueToken	boolean get unique token in the marketplace
sortBy	string (item_sort_by) Enum: "listed_at" "price" Sort by
sortOrder	string (item_sort_order) Enum: "asc" "desc" Sort order
cursor	string pagination cursor

Responses

STAGING

https://game-api-stg.chainsafe.io/v1/projects/{projectID}/items

PRODUCTION

https://api.gaming.chainsafe.io/v1/projects/{projectID}/items

Response samples

• 200
• 400
• default

Content type

application/json

[

• {

  • "page_number": 0,
  • "page_size": 0,
  • "total": 0,
  • "cursor": "string",
  • "items": [

    • {

      • "id": "string",
      • "chain_id": "string",
      • "project_id": "string",
      • "marketplace_id": "string",
      • "token": {

        • "id": "string",
        • "token_id": "string",
        • "token_type": "string",
        • "contract_address": "string",
        • "uri": "string",
        • "metadata": {

          • "property1": "string",
          • "property2": "string"

          }

        },
      • "marketplace_contract_address": "string",
      • "seller": "string",
      • "buyer": "string",
      • "price": "string",
      • "listed_at": 0,
      • "status": "sold"

      }

    ]

  }

]

Get Marketplace Items

Get all the items for a project under a marketplace.

path Parameters

projectID required	string Project ID
marketplaceID required	string Marketplace ID

query Parameters

tokenContractAddress	string Token Contract Address
tokenId	string Token ID
seller	string Seller Address
status	string (item_status) Enum: "sold" "listed" "canceled" Status of the item
uniqueToken	boolean get unique token in the marketplace
sortBy	string (item_sort_by) Enum: "listed_at" "price" Sort by
sortOrder	string (item_sort_order) Enum: "asc" "desc" Sort order
cursor	string pagination cursor

Responses

STAGING

https://game-api-stg.chainsafe.io/v1/projects/{projectID}/marketplaces/{marketplaceID}/items

PRODUCTION

https://api.gaming.chainsafe.io/v1/projects/{projectID}/marketplaces/{marketplaceID}/items

Response samples

• 200
• 400
• default

Content type

application/json

{

• "page_number": 0,
• "page_size": 0,
• "total": 0,
• "cursor": "string",
• "items": [

  • {

    • "id": "string",
    • "chain_id": "string",
    • "project_id": "string",
    • "marketplace_id": "string",
    • "token": {

      • "id": "string",
      • "token_id": "string",
      • "token_type": "string",
      • "contract_address": "string",
      • "uri": "string",
      • "metadata": {

        • "property1": "string",
        • "property2": "string"

        }

      },
    • "marketplace_contract_address": "string",
    • "seller": "string",
    • "buyer": "string",
    • "price": "string",
    • "listed_at": 0,
    • "status": "sold"

    }

  ]

}

Get Item

Get specific Item for a project under a marketplace.

path Parameters

projectID required	string Project ID
marketplaceID required	string Marketplace ID
itemID required	string Item ID

Responses

STAGING

https://game-api-stg.chainsafe.io/v1/projects/{projectID}/marketplaces/{marketplaceID}/items/{itemID}

PRODUCTION

https://api.gaming.chainsafe.io/v1/projects/{projectID}/marketplaces/{marketplaceID}/items/{itemID}

Response samples

• 200
• 400
• default

Content type

application/json

{

• "id": "string",
• "chain_id": "string",
• "project_id": "string",
• "marketplace_id": "string",
• "token": {

  • "id": "string",
  • "token_id": "string",
  • "token_type": "string",
  • "contract_address": "string",
  • "uri": "string",
  • "metadata": {

    • "property1": "string",
    • "property2": "string"

    }

  },
• "marketplace_contract_address": "string",
• "seller": "string",
• "buyer": "string",
• "price": "string",
• "listed_at": 0,
• "status": "sold"

}