NFT Feeds
Get Asset Floor Price: GET
/api/v1/asset-floor-price
Parameters:
Name | Type | Description | Example |
---|---|---|---|
asset_contract_address | string | (required) Address of the contract for this NFT | 0xb932a70a57673d89f4acffbe830e8ed7f75fb9e0 |
token_id | string | (required) Filter by token transfers for this transaction. | 22926 |
key | string | (required) Key provided by Goracle. When using node runner set the key as ##signKey | ##signKey |
Example Call
https://nft-feeds.goracle.io/api/v1/asset-floor-price?asset_contract_address=0xb932a70a57673d89f4acffbe830e8ed7f75fb9e0&token_id=22926&key=##signKey
Example Response (JSON)
{
"status": 200,
"result": "success",
"description": "Successfully fetched OpenSeas Asset",
"query": {
"asset_contract_address": "0xb932a70a57673d89f4acffbe830e8ed7f75fb9e0",
"token_id": "22926"
},
"provider": {
"name": "OpenSeas",
"subscription": true,
"institutionGrade": true
},
"data": {
"name": "Golf",
"creator": "RivenRibbon",
"collection_name": "SuperRare",
"collection_slug": "superrare",
"collection_floor_price": 0
},
"time": "Mon, 26 Jun 2023 16:55:54 GMT",
"timestamp": 1687798554818
}
Results Schema
Name | Type | Description |
---|---|---|
name | string | Name of the item |
creator | string | Name of the creator |
collection_name | string | Name of the asset collection |
collection_slug | string | Collection slug name |
collection_floor_price | number | Asset's collection floor price |
Get Asset Contract: GET
/api/v1/asset-contract
Parameters:
Name | Type | Description | Example |
---|---|---|---|
asset_contract_address | string | (required) Address of the contract for this NFT | 0xb932a70a57673d89f4acffbe830e8ed7f75fb9e0 |
key | string | (required) Key provided by Goracle. When using node runner set the key as ##signKey | ##signKey |
Example Call
https://nft-feeds.goracle.io/api/v1/asset-contract?asset_contract_address=0xb932a70a57673d89f4acffbe830e8ed7f75fb9e0&key=##signKey
Example Response (JSON)
{
"status": 200,
"result": "success",
"description": "Successfully fetched OpenSeas Asset Contract",
"query": {
"asset_contract_address": "0xb932a70a57673d89f4acffbe830e8ed7f75fb9e0"
},
"provider": {
"name": "OpenSeas",
"subscription": true,
"institutionGrade": true
},
"data": {
"address": "0xb932a70a57673d89f4acffbe830e8ed7f75fb9e0",
"asset_contract_type": "non-fungible",
"chain_identifier": "ethereum",
"created_date": "2019-09-05T07:39:47.495758",
"name": "SuperRare",
"nft_version": null,
"opensea_version": null,
"owner": 173444539,
"schema_name": "ERC721",
"symbol": "SUPR",
"total_supply": "39969",
"description": "SuperRare makes it easy to create, sell, and collect rare digital art. SuperRare's smart contract platform allows artists to release limited-edition digital artwork tracked on the blockchain, making the pieces rare, verified, and collectible. Filter the crypto art world's best selling works by artist name, creation type, and year of birth on OpenSea.",
"external_link": "https://superrare.co",
"image_url": "https://i.seadn.io/gae/-1VbTF_qOdwTUTxW8KzJbFcMX0-mDF-BJM-gmmRl8ihvoo53PF_1z1m1snLXxwcxVFyJH7wk_kouq-KVyB55N9U?w=500&auto=format",
"default_to_fiat": false,
"dev_buyer_fee_basis_points": 0,
"dev_seller_fee_basis_points": 0,
"only_proxied_transfers": false,
"opensea_buyer_fee_basis_points": 0,
"opensea_seller_fee_basis_points": 250,
"buyer_fee_basis_points": 0,
"seller_fee_basis_points": 250,
"payout_address": "0x79150011a8dc56857459f652d165fb772ee6eb1c"
},
"time": "Mon, 26 Jun 2023 17:44:35 GMT",
"timestamp": 1687801475340
}
Results Schema
Name | Type | Description |
collection.banner_image_url | string | Image used in the horizontal top banner for the collection |
collection.created_date | string | Date collection was created |
collection.description | string | Description for the collection |
collection.fees | Object | A dictionary for each of the opensea_fees and seller_fees that are vended, mapping recipient address to the basis points paid out to them |
collection.image_url | string | An image for the collection. Note that this is the cached URL we store on our end. The original image url is image_original_url |
collection.name | string | Collection name |
collection.payout_address | number | The payout address for the collection's creator earnings |
collection.slug | string | The collection slug that is used to link to the collection on OpenSea. This value can change by the owner but must be unique across all collection slugs in OpenSea |
address | string | Image used in the horizontal top banner for the collection. |
asset_contract_type | string | Describes if asset is tangible or non-tangible |
chain_identifier | string | The chain identifier than the asset exists on. The options are "arbitrum", "avalanche", "ethereum", "klaytn", "matic" and "optimism" |
created_date | string | Date contract was created. |
name | string | Name of the contract |
nft_version | string | |
opensea_version | string | |
owner | string | Returns current owner |
schema_name | string | Types of tokens supported by the contract |
symbol | string | |
total_supply | string | |
description | string | Description of the contract |
external_link | string | External link to the contracts website |
image_url | string | An image for the item. |
payout_address | string | The payout address for the collection's creator earnings |
Get Collection Floor Price: GET
/api/v1/collection-floor-price
Parameters:
Name | Type | Description | Example |
---|---|---|---|
collection_contract_address | string | Collection address | 0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d |
key | string | (required) Key provided by Goracle. When using node runner set the key as ##signKey | ##signKey |
Example Call
https://nft-feeds.goracle.io/api/v1/collection-floor-price?collection_contract_address=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d&key=##signKey
Example Response (JSON)
{
"status": 200,
"result": "success",
"description": "Successfully fetched OpenSeas Collection Stats",
"query": {
"collection_contract_address": "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"
},
"provider": {
"name": "OpenSeas",
"subscription": true,
"institutionGrade": true
},
"data": {
"collection_name": "Bored Ape Yacht Club",
"floor_price": 37.69
},
"time": "Mon, 26 Jun 2023 19:44:33 GMT",
"timestamp": 1687808673424
}
Results Schema
Name | Type | Description |
---|---|---|
collection_name | string | The name of the collection |
floor_price | number | The collection floor price |
Last modified 2mo ago