NFT Data (coming soon)

Our NFT Metadata dataset is an incredibly comprehensive scraped and derived metadata including:

• Image metadata
• Royalty metadata
• Floor price and previous sales
• Transfers
• Off-chain and on-chain Bids/Sales
• Rarity

As a mirror source, you'd be able to sink it into any of our supported sinks, as well as do transformations and aggregations on the dataset.

This dataset is in technical preview - it's in production with pilot customers, but subject to change.

Email us if you'd like to join our technical preview program.

The Goldsky platform offers comprehensive insights into the collection associated with a particular NFT. Notably, these collections are often tied to specific NFT marketplaces. The Collection Table, which is embedded within the NFT Table, includes a variety of fields. Presently, the Goldsky platform encompasses collections from a range of platforms like OpenSea, Trove, and MagicEden.

Here are the details encapsulated in the Collection Table available within NFT responses and core Collection queries:

Marketplace Page Details:

[{
`marketplace_id`: string,
`marketplace_name`: string,
`marketplace_collection_id`: string,
`nft_url`: string / null,
`collection_url`: string,
`verified`: boolean / null
}]

The Goldsky platform presents detailed, normalized data related to NFTs in the form of the NFT Table. This table consists of the following fields:

Previews:

{
`image_small_url`: string / null,
`image_medium_url`: string / null,
`image_large_url`: string / null,
`image_opengraph_url`: string / null,
`blurhash`: string / null,
`predominant_color`: string / null
}

Image Properties:

{
`width`: int / null,
`height`: int / null,
`size` : int / null,
`mime_type`: str / null
}

Video Properties:

{
`width`: int / null,
`height`: int / null,
`duration`: float / null,
`video_coding`: str / null,
`audio_coding`: str / null,
`size`: int / null,
`mime_type`: str / null
}

Audio Properties:

{
`duration`: float / null,
`audio_coding`: str / null,
`size`: int / null,
`mime_type`: str / null
}

Model Properties:

{
`size`: int / null,
`mime_type`: str / null
}

Other Properties:

{
`size`: int / null,
`mime_type`: str / null
}

Owners:

[{
`owner_address`: string,
`quantity`: int,
`first_acquired_date`: string,
`last_acquired_date`: string
}]

First Created:

{
`minted_to: string / null,
quantity: int / null,
timestamp: string / null,
block_number: int / null,
transaction: string / null,
transaction_initiator: string / null
}

Contract:

{
type:string,
name:string / null,
symbol:string / null,
deployed_by: string / null,
deployed_via_contract: string / null
}

Royalty:

[{
source: string,
total_creator_fee_basis_points: int,
recipients: [{
address: string,
percentage: float,
basis_points: int
}]
}]

Extra Metadata:

{
attributes: [{
trait_type:string,
value:string,
display_type:string / null
}],
...,
image_original_url:string / null,
animation_original_url:string / null,
metadata_original_url:string / null
}

The Goldsky platform includes details of active and historical listings on NFT marketplaces.

Currently supported live marketplaces:

• MagicEden: Live
• CryptoPunks: Live
• Tensor: Live
• Blur: Live
• OpenSea: Live
• LooksRare: Live
• X2Y2: Live

More marketplaces will be covered in the near future.

Listing Table:

Listing Event Table:

Payment Token Table:

On the Goldsky platform, users have the ability to view top bids -— these are the highest ongoing propositions for any NFT in a given collection.

Currently, top bids from the Blur marketplace are incorporated into the platform. We are constantly looking to expand our marketplace coverage and include various bid types.

The array containing the top bids can be located in the field top_bids in the Collection Table, available in the "NFT by..." queries, and also direct in the Collections by Wallet query.

Key Information on Bids:

Payment Token Information:

The Goldsky platform offers in-depth details on the sale of NFTs, which are included within the NFT and transfer tables.

In NFT responses, sale information can be found in the last_sale field, and transfer responses are included in the sale_details field.

NFT Sale Table (embedded within the NFT Table):

Transfer Sale Details Table (embedded within the transfer Table):

Payment Token Details:

A floor price is the minimum listed price for an NFT within a specific collection—this often applies to a specific NFT marketplace.

The Goldsky platform provides insights into the floor price of NFT collections across various chains, currently including:

• Ethereum: Live
• Polygon: Live

The platform encompasses floor prices from multiple marketplaces such as CryptoPunks, Tensor, Blur, OpenSea, X2Y2, LooksRare, and Magic Eden.

Please note, marketplaces like LooksRare and Blur might display the "global floor price", representing the lowest price across several marketplaces.

We are continually working to cover more chains and marketplaces.

You can locate the floor_prices array in the floor_prices field within the Collection Table for "NFT by..." queries, and it is also accessible directly in the Collections by Wallet query.

Comprehensive Floor Price Details:

Payment Token Information:

The Goldsky platform delivers transfer data in a standardized format. The Transfer Table encompasses fields that usually signify the transfer of an NFT between addresses. Here are the included fields:

The Goldsky platform adopts the OpenRarity standard to derive a consistent and mathematically-based rarity score for NFTs.

Currently, our system lends support to ERC-721 and Metaplex non-fungible token standards. We are working towards providing support for ERC-1155 in the near future.

Rarity Score Details:

Background

The rising popularity of NFTs has led to an upsurge in spam NFTs, degrading user experience significantly. Users often find themselves puzzled or irritated by unfamiliar, low-quality NFTs appearing in their wallets and dapp use cases. More ominously, these NFTs—usually mass-airdropped—may contain harmful links to external sites or resources. Spam NFTs are proliferating rapidly on popular networks with lower transaction fees or costs, notably Polygon and Solana. Presently, spam scores are accessible to enterprise plan customers on the main EVM chains and Solana.

Objectives

Goldsky's implementation of spam scoring pursues two primary goals:

1. Facilitate the identification of low-quality, unwanted airdropped NFTs, referred to as "spam NFTs."
2. Aid in recognizing NFTs that carry dangerous or malicious external links—"scam NFTs."

There's a somewhat blurred line separating these two types of NFTs, and the current implementation may target those falling under both categories.

Goldsky Spam Scoring - Current Approach

Goldsky offers a spam score for most NFT collections, equipping end users with additional tools to tackle spam NFTs. This score is calculated using a blend of models, heuristics, and external data sources. The resulting score is a numerical value that ranges from 0 to 100—0 being considered non-spam and 100 indicating likely spam.

The spam_score field is provided inline with the API's NFT response bodies within the collection field.

Currently, the spam scores are generated at the NFT collection level. This means all NFTs within a specific collection will share the same score. If the response is null, it indicates that the collection either lacks sufficient information for scoring or has not yet been evaluated.