EnjinX API
Learn more about EnjinX
The EnjinX API is a scalable blockchain development and data infrastructure service for companies building blockchain products, such as apps, games, wallets, marketplaces, and exchanges.
With the EnjinX API, users are able to tap into a wealth of data available on the Ethereum & Jumpnet chains, such as:
- Transaction history
- Validate transactions
- Balances (for ETH and ERC-20 tokens)
- ERC-721 & ERC-1155 assets
All of this data can be paginated and sorted.
For further reference on the EnjinX API, please refer to the docs here - https://api-docs.enjinx.io/#intro
MarketplaceListing
This query can be used to access the data of a marketplace listing.The
uuid
variable is that unique identifier of the marketplace listing. You can retrieve this from the uuid
property on the marketplace listing.query MarketplaceListing($uuid: String!) {
MarketplaceListing(uuid: $uuid) {
asset {
metadata {
name
image
description
}
marketplaceData {
lastSoldPrice
lastSoldAt
currentListings
lowestPrice
highestPrice
}
}
remaining
price
seller {
address
}
listedAt
}
}
Example Response
{
"data": {
"MarketplaceListing": {
"asset": {
"metadata": {
"name": "HAPPY NEW YEAR 2020",
"image": "https://cdn.enjinx.io/metadata/raw/d26b77650f01f685d05a81a26626c00e7d7e5b0f/e019344f6a52453c7d3822a25fab8b469f45b9cd.jpg",
"description": "Lunar New Year 2020 Special Edition"
},
"marketplaceData": {
"lastSoldPrice": null,
"lastSoldAt": null,
"currentListings": 1,
"lowestPrice": null,
"highestPrice": null
}
},
"remaining": 1,
"price": 0.005,
"seller": {
"address": "0xc42709c680799ca52851692037326ec8c0019da3"
},
"listedAt": "2020-05-16T23:54:46+00:00"
}
}
}
MarketplaceListing
This query can be used to access all marketplace listings.The
page
variable (optional, default = 1
) is the current cursor position of the query.The
limit
variable (optional, default = 25
) is the maximum number of marketplace listings to return per page.query MarketplaceListings($page: Int, $limit: Int) {
MarketplaceListings(limit: $limit, page: $page) {
data {
uuid
asset {
metadata {
name
image
description
}
marketplaceData {
lastSoldPrice
lastSoldAt
currentListings
lowestPrice
highestPrice
}
}
remaining
price
seller {
address
}
listedAt
}
total
currentPage
lastPage
}
}
Example Response
{
"data": {
"MarketplaceListings": {
"data": [
{
"uuid": "0f090ee7-1d69-4665-a127-65f0c637ad44",
"asset": {
"metadata": {
"name": "HAPPY NEW YEAR 2020",
"image": "https://cdn.enjinx.io/metadata/raw/d26b77650f01f685d05a81a26626c00e7d7e5b0f/e019344f6a52453c7d3822a25fab8b469f45b9cd.jpg",
"description": "Lunar New Year 2020 Special Edition"
},
"marketplaceData": {
"lastSoldPrice": null,
"lastSoldAt": null,
"currentListings": 1,
"lowestPrice": null,
"highestPrice": null
}
},
"remaining": 1,
"price": 0.005,
"seller": {
"address": "0xc42709c680799ca52851692037326ec8c0019da3"
},
"listedAt": "2020-05-16T23:54:46+00:00"
}
AddressMarketPlaceListings
This query can be used to access all marketplace listings for a given seller.The
address
variable is the wallet address of the seller (eg. 0x65ffe5a603b9dac9bca330bf387979701374c96c
).The
page
variable (optional, default = 1
) is the current cursor position of the query.The
limit
variable (optional, default = 25
) is the maximum number of marketplace listings to return per page.query AddressMarketplaceListings($address: String!, $page: Int, $limit: Int) {
Address(address: $address) {
marketplaceListings(limit: $limit, page: $page) {
data {
uuid
asset {
metadata {
name
image
description
}
marketplaceData {
lastSoldPrice
lastSoldAt
currentListings
lowestPrice
highestPrice
}
}
remaining
price
listedAt
}
total
currentPage
lastPage
}
}
}
Example Response
{
"data": {
"Address": {
"marketplaceListings": {
"data": [
{
"uuid": "cade506d-3187-4065-aa4d-96d803974d69",
"asset": {
"metadata": {
"name": "Major Tom",
"image": "https://cdn.enjinx.io/metadata/raw/bad1bffe29f039d102382d02da6f0d0ad2f81df8/119180f23fb9082105df6a1b1c238f7d19cad79e.jpg",
"description": "The fastest astronaut in the crypto universe from the Changelly space team. Major Tom has more than 3 years of everyday crypto-to-crypto exchange experience. As a genuine explorer, Major Tom personally landed on over 130 star-coins and tokens, and he keeps discovering the crypto universe, infinitely driven by Satoshi’s revolutionary ideas. What about his superpower? He is awake 24/7, ready to guide you through the maze of crypto galaxies."
},
"marketplaceData": {
"lastSoldPrice": 6,
"lastSoldAt": "2020-07-09T10:31:56+00:00",
"currentListings": 64,
"lowestPrice": 2.5,
"highestPrice": 25
}
},
"remaining": 1,
"price": 666,
"listedAt": "2020-12-08T22:44:15+00:00"
}
],
"total": 1,
"currentPage": 1,
"lastPage": 1
}
}
}
}
AssetMarketPlaceListings
This query can be used to access all marketplace listings for a given asset.The
id
variable is the on-chain unique identifier for the asset (eg. 5080000000000027
).The
index
(optional) is the on-chain unique index for a specific (non-fungible) asset represented as a decimal (eg. 1
).The
page
variable (optional, default = 1
) is the current cursor position of the query.The
limit
variable (optional, default = 25
) is the maximum number of marketplace listings to return per page.query AssetMarketplaceListings($id: String!, $index: Int, $page: Int, $limit: Int) {
Asset(id: $id, index: $index) {
metadata {
name
image
description
}
marketplaceListings(limit: $limit, page: $page) {
data {
uuid
remaining
price
seller {
address
}
listedAt
}
total
currentPage
lastPage
}
marketplaceData {
lastSoldPrice
lastSoldAt
currentListings
lowestPrice
highestPrice
}
}
}
Example Response
{
"data": {
"Asset": {
"metadata": {
"name": "Oindrasdain",
"image": "https://cdn.enjinx.io/metadata/raw/a41e1c9a773f11f078a2b479afda8216fb41e8b0/1bef292f4b4f1becd2eb43d12614f97b4c308ec4.jpg",
"description": "Oindrasdain is a fearsome and powerful weapon.\nAccording to the Saga of the Seven Worlds, the battleaxe design was invented by the members of the Order of Sylas, a legendary faction of mages that toppled a god-tyrant, lifted the barriers keeping them trapped inside their own realm, and continued to mercilessly spread their rule across the multiverse—as well as their mystical knowledge.\nThe secrets of the Order found their way to countless sorcerers across a myriad of realms, who used their newly-obtained craft of mythspell weaving to infuse weapons with powerful electro-magical properties—the cleaver becoming one of the most replicated designs."
},
"marketplaceListings": {
"data": [
{
"uuid": "0da80805-ff1e-4e37-99b2-aac784629594",
"remaining": 1,
"price": 27.5,
"seller": {
"address": "0x819d8b7b854ba4d877b9d2557f09dc1c18a3f6d1"
},
"listedAt": "2019-10-30T06:08:33+00:00"
},
{
"uuid": "7a7eeb1d-281a-4072-a441-51e9cd470cab",
"remaining": 1,
"price": 28,
"seller": {
"address": "0x819d8b7b854ba4d877b9d2557f09dc1c18a3f6d1"
},
"listedAt": "2019-11-14T17:31:53+00:00"
}
ProjectMarketplaceListings
This query can be used to access all marketplace listings for a given project.The
uuid
variable is the unique identifier of the project you're querying for.The
page
variable (optional, default = 1
) is the current cursor position of the query.The
limit
variable (optional, default = 25
) is the maximum number of marketplace listings to return per page.query ProjectMarketplaceListings($uuid: String!, $page: Int, $limit: Int) {
Project(uuid: $uuid) {
marketplaceListings(limit: $limit, page: $page) {
data {
uuid
asset {
metadata {
name
image
description
}
marketplaceData {
lastSoldPrice
lastSoldAt
currentListings
lowestPrice
highestPrice
}
}
remaining
price
seller {
address
}
listedAt
}
total
currentPage
lastPage
}
}
}
Example Response
{
"data": {
"Project": {
"marketplaceListings": {
"data": [
{
"uuid": "c93c65c6-a12b-4f47-b920-30f33e8da5e7",
"asset": {
"metadata": {
"name": "FIO Express",
"image": "https://cdn.enjinx.io/metadata/raw/7192bda941a7bc6e2f3eac4c66285eefc740966b/c6f9c44ceff0e8bf6ac03c87946cba4ae1379cb8.jpg",
"description": "The FIO Express is an elite troop of servicemen whose mission is to swiftly deliver gifts and goods directly to their intended recipients. Their dedication to customer satisfaction is second to none, riding day and night to track down their targets and execute timely deliveries. Riding on healthy, tireless steeds and equipped with strong leather satchels, the FIO Express is always running during this crucial time when trusted lines of communication are more important than ever for our developing blockchain nation.\nThe Foundation for Interwallet Operability (FIO) is a consortium of leading blockchain wallets, exchanges, and payment providers supporting the FIO Protocol—a decentralized, open-source service layer that removes the risk, complexity, and inconvenience of sending and receiving tokens and coins from any blockchain on any wallet or exchange. To learn more, visit https://fio.foundation/."
},
"marketplaceData": {
"lastSoldPrice": 3.4,
"lastSoldAt": "2020-05-14T18:08:15+00:00",
"currentListings": 43,
"lowestPrice": 1,
"highestPrice": 9
}
},
"remaining": 1,
"price": 3.9,
"seller": {
"address": "0xecadbaf1fce4db184680169bfa184c59ecdbdf9b"
},
"listedAt": "2020-04-11T16:13:56+00:00"
},
{
"uuid": "fbb73af8-33b0-4518-bfa6-ee5fb88fcfad",
"asset": {
"metadata": {
"name": "FIO Express",
"image": "https://cdn.enjinx.io/metadata/raw/7192bda941a7bc6e2f3eac4c66285eefc740966b/c6f9c44ceff0e8bf6ac03c87946cba4ae1379cb8.jpg",
"description": "The FIO Express is an elite troop of servicemen whose mission is to swiftly deliver gifts and goods directly to their intended recipients. Their dedication to customer satisfaction is second to none, riding day and night to track down their targets and execute timely deliveries. Riding on healthy, tireless steeds and equipped with strong leather satchels, the FIO Express is always running during this crucial time when trusted lines of communication are more important than ever for our developing blockchain nation.\nThe Foundation for Interwallet Operability (FIO) is a consortium of leading blockchain wallets, exchanges, and payment providers supporting the FIO Protocol—a decentralized, open-source service layer that removes the risk, complexity, and inconvenience of sending and receiving tokens and coins from any blockchain on any wallet or exchange. To learn more, visit https://fio.foundation/."
},
"marketplaceData": {
"lastSoldPrice": 3.4,
"lastSoldAt": "2020-05-14T18:08:15+00:00",
"currentListings": 43,
"lowestPrice": 1,
"highestPrice": 9
}
}
ProjectUuidByAsset
This query can be used to retrieve the uuid
of a project through an asset that belongs to the project.The
id
variable is the on-chain unique identifier for the asset (eg. 5080000000000027
).query ProjectUuidByAsset($id: String!) {
Asset(id: $id) {
project {
uuid
}
}
}
Example Response
{
"data": {
"Asset": {
"project": {
"uuid": "3223b8fe-0693-4f5d-abed-8d73867ff824"
}
}
}
}
PurchaseListing
This mutation can be used to purchase an asset from the marketplace.The
uuid
variable is that unique identifier of the marketplace listing. You can retrieve this from the uuid
property on the marketplace listing.The
quantity
variable (optional, default = 1
) is the number of assets to purchase from this listing. This number cannot exceed the remaining
property of the marketplace listing.mutation PurchaseListing($uuid: String!, $quantity: Int) {
MarketplacePurchaseListing(uuid: $uuid, quantity: $quantity) {
uuid
link
qr
}
}
Example Response
{
"data": {
"MarketplacePurchaseListing": {
"uuid": "944ffb26-d4a3-4e0c-956a-c90ef11945d0",
"link": "enjinwallet://marketplace/944ffb26-d4a3-4e0c-956a-c90ef11945d0",
"qr": "https://enjinx.io/qrcode/marketplace:944ffb26-d4a3-4e0c-956a-c90ef11945d0"
}
}
}