Description Of SRR Data
Please note that we may add a new field. So make sure that your implementation can support accepting new fields without breaking your implementation. In case we remove the field, we will deprecate it first and let you know beforehand.
Source of truth: subgraph + IPFS CDN gateway
The fields below mirror the Startrail subgraph schema. The Get SRR REST endpoints are thin convenience wrappers that proxy this data; for richer / faster / more flexible queries, query the subgraph directly.
The metadata JSON itself lives on IPFS and is fetched from the Startrail IPFS CDN gateway (https://cdn.startrail.io/ipfs/<metadataDigest>). The same gateway also serves any image and attachment file CIDs that appear inside the metadata.
* indicates field that will always exist
id*
Subgraph SRR id (<collectionAddress>-<tokenId>)
string
tokenId*
NFT token ID
string
ownerAddress
Current owner EOA / contract address.
string
isPrimaryIssuer
true if it's primary sales
boolean
artistAddress
Artist LUW wallet address
string
metadataDigest*
IPFS CID of the SRR metadata JSON. Resolve via the Startrail IPFS CDN gateway at https://cdn.startrail.io/ipfs/<metadataDigest>.
string
bafkrei…
transferCommitment
If set, the SRR currently has a pending transfer commitment hash.
string
lockExternalTransfer
If true, standard ERC721 transfer methods are disabled for this SRR.
boolean
royaltyReceiver
EIP-2981 royalty receiver address.
string
royaltyBasisPoints
EIP-2981 royalty basis points (e.g. 1570 = 15.70%).
number
createdAt*
Time when SRR was minted on chain.
Date
updatedAt*
Time when SRR data was last updated on chain.
Date
issuer.walletAddress*
Issuer LUW wallet address
string
issuer.originalName*
Issuer name (originalName)
string
issuer.englishName*
Issuer name (EN)
string
issuer.userType*
User type
string
'artist', 'handler'
issuer.salt
LUW salt
string
issuer.owners
EOA owners of the LUW
string[]
issuer.threshold
Multisig threshold of the LUW
number
issuer.createdAt*
Time when issuer LUW was created
Date
issuer.updatedAt*
Time when issuer LUW was updated
Date
artist.walletAddress*
Artist LUW wallet address
string
artist.originalName*
Artist name (originalName)
string
artist.englishName*
Artist name (EN)
string
artist.userType*
User type
string
'artist', 'handler'
artist.salt
LUW salt
string
artist.owners
EOA owners of the LUW
string[]
artist.threshold
Multisig threshold of the LUW
number
artist.createdAt*
Time when artist LUW was created
Date
artist.updatedAt*
Time when artist LUW was updated
Date
collection
Collection the SRR belongs to. Absent for SRRs not issued under a custom collection.
object
collection.id
Collection contract address (lowercased).
string
collection.name
Name of collection
string
collection.symbol
Symbol of collection
string
collection.ownerAddress
Owner LUW wallet address of the collection
string
collection.createdAt
Time when collection was created
Date
collection.updatedAt
Time when collection was last updated
Date
metadata
Raw SRR metadata JSON fetched from IPFS via the Startrail IPFS CDN gateway.
Only present on endpoints that aggregate the metadata (e.g. Get Owned SRRs). For Get SRR by Token Id, fetch it yourself from https://cdn.startrail.io/ipfs/<metadataDigest>. See Metadata Schema.
Object
metadataHistory
History of metadata changes (each entry has its own metadataDigest CID).
Array
customHistories
Aggregated custom histories (only on aggregating endpoints).
Array
transfers
Aggregated provenance / transfers with metadata (only on aggregating endpoints).
Array
Example
Last updated
Was this helpful?