EnjinX API
Learn more about EnjinX

What is the EnjinX API?

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.
GraphiQL EnjinX API link - https://api.enjinx.io/graphql
For further reference on the EnjinX API, please refer to the docs here - https://api-docs.enjinx.io/#intro

‍Queries

Fetch Listing

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"
}
}
}

Fetch All Listings

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"
}

Fetch All Listings By Address

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
}
}
}
}

Fetch All Listings By Asset

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"
}

Fetch All Listings By Project

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
}
}

Fetch Project UUID By Asset

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"
}
}
}
}

Mutations

Purchase Listing

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"
}
}
}
Export as PDF
Copy link
On this page
What is the EnjinX API?
‍Queries
Fetch Listing
Fetch All Listings
Fetch All Listings By Address
Fetch All Listings By Asset
Fetch All Listings By Project
Fetch Project UUID By Asset
Mutations
Purchase Listing