Comment on page

Information queries

Information, read-only, queries are open to everyone. These queries do not require any signature. Examples of such queries include: inquiring about the assets of a given owner, retrieving the current properties of an NFT, etc.
Getting Started
One of the features of GraphQL is introspection, which easily allows to find out about the underlying schema, and get documentation about every single method available.
So, go ahead, visit a Living Assets test network endpoint, and click on the right-most tabs (DOCS, SCHEMA) to learn about the entities that live in the platform, and the means to access them.
Example Read-only Queries
Familiarize yourself with some of the most used queries by introducing the queries provided in the examples below.
Get all assets in a given universe
The following query returns the assetId, the owner's web3 address, the properties, and the creation time, of all assets in universeId = 0:
GraphQL
query {
    allAssets(condition: {universeId: 0}) {
        nodes {
            id
            ownerId
            props
            createdAt
        }
    }
}
Get all assets owned by a user, and their properties
The following query returns the assetId and the properties of all assets owned by a given owner.
GraphQL
query {
    allAssets(
        condition: { ownerId: "0x291081e5a1bF0b9dF6633e4868C88e1FA48900e7" }
    ) {
        nodes {
            id
            props
        }
    }
}
Get all assets and associated BuyNow trades
The following query runs through all assets in universeId = 0, and returns number of assets found (totalCount) as well as the main data associated to every trade that each of those assets has been involved in:
GraphQL
query {
    allAssets(condition: { universeId: 0 }) {
        totalCount
        nodes {
            id
            buynowsByAssetId {
                nodes {
                id
                assetId
                currencyId
                price
                validUntil
                signature
                state
                sellerId
                buynowPaymentId
                txId
                universeId
                }
            }
        }
    }
}

Living Assets API - Previous

Overview

Next - Living Assets API

Create & Evolve

Last modified 4mo ago