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.
1
query MarketplaceListing($uuid: String!) {
2
MarketplaceListing(uuid: $uuid) {
3
asset {
4
metadata {
5
name
6
image
7
description
8
}
9
marketplaceData {
10
lastSoldPrice
11
lastSoldAt
12
currentListings
13
lowestPrice
14
highestPrice
15
}
16
}
17
remaining
18
price
19
seller {
20
address
21
}
22
listedAt
23
}
24
}
Copied!
Example Response
1
{
2
"data": {
3
"MarketplaceListing": {
4
"asset": {
5
"metadata": {
6
"name": "HAPPY NEW YEAR 2020",
7
"image": "https://cdn.enjinx.io/metadata/raw/d26b77650f01f685d05a81a26626c00e7d7e5b0f/e019344f6a52453c7d3822a25fab8b469f45b9cd.jpg",
8
"description": "Lunar New Year 2020 Special Edition"
9
},
10
"marketplaceData": {
11
"lastSoldPrice": null,
12
"lastSoldAt": null,
13
"currentListings": 1,
14
"lowestPrice": null,
15
"highestPrice": null
16
}
17
},
18
"remaining": 1,
19
"price": 0.005,
20
"seller": {
21
"address": "0xc42709c680799ca52851692037326ec8c0019da3"
22
},
23
"listedAt": "2020-05-16T23:54:46+00:00"
24
}
25
}
26
}
Copied!

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.
1
query MarketplaceListings($page: Int, $limit: Int) {
2
MarketplaceListings(limit: $limit, page: $page) {
3
data {
4
uuid
5
asset {
6
metadata {
7
name
8
image
9
description
10
}
11
marketplaceData {
12
lastSoldPrice
13
lastSoldAt
14
currentListings
15
lowestPrice
16
highestPrice
17
}
18
}
19
remaining
20
price
21
seller {
22
address
23
}
24
listedAt
25
}
26
total
27
currentPage
28
lastPage
29
}
30
}
Copied!
Example Response
1
{
2
"data": {
3
"MarketplaceListings": {
4
"data": [
5
{
6
"uuid": "0f090ee7-1d69-4665-a127-65f0c637ad44",
7
"asset": {
8
"metadata": {
9
"name": "HAPPY NEW YEAR 2020",
10
"image": "https://cdn.enjinx.io/metadata/raw/d26b77650f01f685d05a81a26626c00e7d7e5b0f/e019344f6a52453c7d3822a25fab8b469f45b9cd.jpg",
11
"description": "Lunar New Year 2020 Special Edition"
12
},
13
"marketplaceData": {
14
"lastSoldPrice": null,
15
"lastSoldAt": null,
16
"currentListings": 1,
17
"lowestPrice": null,
18
"highestPrice": null
19
}
20
},
21
"remaining": 1,
22
"price": 0.005,
23
"seller": {
24
"address": "0xc42709c680799ca52851692037326ec8c0019da3"
25
},
26
"listedAt": "2020-05-16T23:54:46+00:00"
27
}
Copied!

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.
1
query AddressMarketplaceListings($address: String!, $page: Int, $limit: Int) {
2
Address(address: $address) {
3
marketplaceListings(limit: $limit, page: $page) {
4
data {
5
uuid
6
asset {
7
metadata {
8
name
9
image
10
description
11
}
12
marketplaceData {
13
lastSoldPrice
14
lastSoldAt
15
currentListings
16
lowestPrice
17
highestPrice
18
}
19
}
20
remaining
21
price
22
listedAt
23
}
24
total
25
currentPage
26
lastPage
27
}
28
}
29
}
Copied!
Example Response
1
{
2
"data": {
3
"Address": {
4
"marketplaceListings": {
5
"data": [
6
{
7
"uuid": "cade506d-3187-4065-aa4d-96d803974d69",
8
"asset": {
9
"metadata": {
10
"name": "Major Tom",
11
"image": "https://cdn.enjinx.io/metadata/raw/bad1bffe29f039d102382d02da6f0d0ad2f81df8/119180f23fb9082105df6a1b1c238f7d19cad79e.jpg",
12
"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."
13
},
14
"marketplaceData": {
15
"lastSoldPrice": 6,
16
"lastSoldAt": "2020-07-09T10:31:56+00:00",
17
"currentListings": 64,
18
"lowestPrice": 2.5,
19
"highestPrice": 25
20
}
21
},
22
"remaining": 1,
23
"price": 666,
24
"listedAt": "2020-12-08T22:44:15+00:00"
25
}
26
],
27
"total": 1,
28
"currentPage": 1,
29
"lastPage": 1
30
}
31
}
32
}
33
}
Copied!

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.
1
query AssetMarketplaceListings($id: String!, $index: Int, $page: Int, $limit: Int) {
2
Asset(id: $id, index: $index) {
3
metadata {
4
name
5
image
6
description
7
}
8
marketplaceListings(limit: $limit, page: $page) {
9
data {
10
uuid
11
remaining
12
price
13
seller {
14
address
15
}
16
listedAt
17
}
18
total
19
currentPage
20
lastPage
21
}
22
marketplaceData {
23
lastSoldPrice
24
lastSoldAt
25
currentListings
26
lowestPrice
27
highestPrice
28
}
29
}
30
}
Copied!
Example Response
1
{
2
"data": {
3
"Asset": {
4
"metadata": {
5
"name": "Oindrasdain",
6
"image": "https://cdn.enjinx.io/metadata/raw/a41e1c9a773f11f078a2b479afda8216fb41e8b0/1bef292f4b4f1becd2eb43d12614f97b4c308ec4.jpg",
7
"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."
8
},
9
"marketplaceListings": {
10
"data": [
11
{
12
"uuid": "0da80805-ff1e-4e37-99b2-aac784629594",
13
"remaining": 1,
14
"price": 27.5,
15
"seller": {
16
"address": "0x819d8b7b854ba4d877b9d2557f09dc1c18a3f6d1"
17
},
18
"listedAt": "2019-10-30T06:08:33+00:00"
19
},
20
{
21
"uuid": "7a7eeb1d-281a-4072-a441-51e9cd470cab",
22
"remaining": 1,
23
"price": 28,
24
"seller": {
25
"address": "0x819d8b7b854ba4d877b9d2557f09dc1c18a3f6d1"
26
},
27
"listedAt": "2019-11-14T17:31:53+00:00"
28
}
Copied!

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.
1
query ProjectMarketplaceListings($uuid: String!, $page: Int, $limit: Int) {
2
Project(uuid: $uuid) {
3
marketplaceListings(limit: $limit, page: $page) {
4
data {
5
uuid
6
asset {
7
metadata {
8
name
9
image
10
description
11
}
12
marketplaceData {
13
lastSoldPrice
14
lastSoldAt
15
currentListings
16
lowestPrice
17
highestPrice
18
}
19
}
20
remaining
21
price
22
seller {
23
address
24
}
25
listedAt
26
}
27
total
28
currentPage
29
lastPage
30
}
31
}
32
}
Copied!
Example Response
1
{
2
"data": {
3
"Project": {
4
"marketplaceListings": {
5
"data": [
6
{
7
"uuid": "c93c65c6-a12b-4f47-b920-30f33e8da5e7",
8
"asset": {
9
"metadata": {
10
"name": "FIO Express",
11
"image": "https://cdn.enjinx.io/metadata/raw/7192bda941a7bc6e2f3eac4c66285eefc740966b/c6f9c44ceff0e8bf6ac03c87946cba4ae1379cb8.jpg",
12
"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/."
13
},
14
"marketplaceData": {
15
"lastSoldPrice": 3.4,
16
"lastSoldAt": "2020-05-14T18:08:15+00:00",
17
"currentListings": 43,
18
"lowestPrice": 1,
19
"highestPrice": 9
20
}
21
},
22
"remaining": 1,
23
"price": 3.9,
24
"seller": {
25
"address": "0xecadbaf1fce4db184680169bfa184c59ecdbdf9b"
26
},
27
"listedAt": "2020-04-11T16:13:56+00:00"
28
},
29
{
30
"uuid": "fbb73af8-33b0-4518-bfa6-ee5fb88fcfad",
31
"asset": {
32
"metadata": {
33
"name": "FIO Express",
34
"image": "https://cdn.enjinx.io/metadata/raw/7192bda941a7bc6e2f3eac4c66285eefc740966b/c6f9c44ceff0e8bf6ac03c87946cba4ae1379cb8.jpg",
35
"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/."
36
},
37
"marketplaceData": {
38
"lastSoldPrice": 3.4,
39
"lastSoldAt": "2020-05-14T18:08:15+00:00",
40
"currentListings": 43,
41
"lowestPrice": 1,
42
"highestPrice": 9
43
}
44
}
Copied!

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).
1
query ProjectUuidByAsset($id: String!) {
2
Asset(id: $id) {
3
project {
4
uuid
5
}
6
}
7
}
Copied!
Example Response
1
{
2
"data": {
3
"Asset": {
4
"project": {
5
"uuid": "3223b8fe-0693-4f5d-abed-8d73867ff824"
6
}
7
}
8
}
9
}
Copied!

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.
1
mutation PurchaseListing($uuid: String!, $quantity: Int) {
2
MarketplacePurchaseListing(uuid: $uuid, quantity: $quantity) {
3
uuid
4
link
5
qr
6
}
7
}
Copied!
Example Response
1
{
2
"data": {
3
"MarketplacePurchaseListing": {
4
"uuid": "944ffb26-d4a3-4e0c-956a-c90ef11945d0",
5
"link": "enjinwallet://marketplace/944ffb26-d4a3-4e0c-956a-c90ef11945d0",
6
"qr": "https://enjinx.io/qrcode/marketplace:944ffb26-d4a3-4e0c-956a-c90ef11945d0"
7
}
8
}
9
}
Copied!