NFT API
Get NFT token information
## Request
curl -X "POST" "https://oracle-api.banksea.finance/nft/v1/token" \
-H 'x-api-key: test-api-key' \
-H 'Content-Type: application/json; charset=utf-8' \
-d $'{
"token_address":"7ZBRCR83jqYk7bbG3RY8Qn14E341n3qwWgY6NTTPko5k"
}'
Interface: /nft/v1/token
Method: POST
Data Format: JSON
Request Parameter:
token_address
String
Y
The token address of the NFT token.
Request Example:
{ "token_address":"7ZBRCR83jqYk7bbG3RY8Qn14E341n3qwWgY6NTTPko5k" }
Response Data:
token_address
String
The token address of the NFT token.
token_name
String
The name of the NFT token.
image_url
String
The image url of the NFT token.
attributes
List
The attributes of the NFT token.
attributes.trait_type
String
Attribute type.
attributes.value
String
Attribute value.
attributes.amount
Number
Attribute amount.
attributes.rarity
Number
Attribute rarity.
valuation
Number
The valuation of the NFT token.
valuation_24_hours
Number
The valuation of the NFT token from 24 hours ago.
change_rate_24_hours
Number
change_rate_24_hours = (valuation - valuation_24_hours) / valuation_24_hours.
valuation_7_days
Number
The valuation of the NFT token from 7 days ago.
change_rate_7_days
Number
change_rate_7_days = (valuation - valuation_7_days) / valuation_7_days.
valuation_30_days
Number
The valuation of the NFT token from 30 days ago.
change_rate_30_days
Number
change_rate_30_days = (valuation - valuation_30_days) / valuation_30_days.
risk
Number
The token's risk reflects the degree of volatility of the NFT.
max_price
Number
The highest transaction price in history.
min_price
Number
The lowest transaction price in history.
price_history
List
The list of transaction prices in history.
price_history.price
Number
historical price.
price_history.timestamp
Number
The transaction time of the historical price.
valuation_history
List
The list of valuation over the past 30 days.
valuation_history.valuation
Number
valuation.
valuation_history.timestamp
Number
valuation time.
holder_history
List
The list of former holders in history.
activities
List
The list of activities.
activities.event_type
String
Type of activity.
activities.price
Number
Price of activity.
activities.from_address
String
The source address of the NFT transfer .
activities.to_address
String
The destination address of the NFT transfer.
activities.timestamp
Number
Time of activity.
rarity_score
Number
The Rarity Score is an indicator of the rarity of NFT attributes.
rank
Number
Rank within the NFT collection for rarity scores.
token_popularity
Number
The popularity of the NFT token
Response Example:
{ "success": true, "code": "200", "message": "success", "data": { "attributes": [ { "amount": 250, "rarity": 14.04, "value": "Blue", "trait_type": "Background" }, { "amount": 180, "rarity": 10.11, "value": "Guitar", "trait_type": "Back" }, { "amount": 137, "rarity": 7.69, "value": "Silver", "trait_type": "Body" }, { "amount": 361, "rarity": 20.27, "value": "Wire Neck", "trait_type": "Neck" }, { "amount": 155, "rarity": 8.7, "value": "Police", "trait_type": "Body Feature" }, { "amount": 1405, "rarity": 78.89, "value": "None", "trait_type": "Head" }, { "amount": 1405, "rarity": 78.89, "value": "None", "trait_type": "Ear" }, { "amount": 746, "rarity": 41.89, "value": "None", "trait_type": "Mouth" }, { "amount": 230, "rarity": 12.91, "value": "Mechanical Heart", "trait_type": "Energy" }, { "amount": 746, "rarity": 41.89, "value": "None", "trait_type": "Eye" }, { "amount": 150, "rarity": 8.42, "value": "Orange Helmet", "trait_type": "Helmet" }, { "amount": 209, "rarity": 11.73, "value": "Parrot", "trait_type": "Shoulder" } ], "valuation": 1.8989, "risk": 0.8409, "activities": [ { "seller": "P1eKsmV8dAYaNBcWpjg7L3mpTbJkVscJuiRs6cgEHQe", "buyer": "", "transaction_type": "Listing", "total_amount": 5.0, "transaction_time": 1645150419000 }, { "seller": "P1eKsmV8dAYaNBcWpjg7L3mpTbJkVscJuiRs6cgEHQe", "buyer": "", "transaction_type": "Listing", "total_amount": 2.0, "transaction_time": 1645150503000 }, { "seller": "P1eKsmV8dAYaNBcWpjg7L3mpTbJkVscJuiRs6cgEHQe", "buyer": "", "transaction_type": "Listing", "total_amount": 0.99, "transaction_time": 1646393269000 }, { "seller": "", "buyer": "3TpJsd2x4njtah6sPgmBCXS4MLSoZ9zEpqpt2meQADmU", "transaction_type": "PlaceBid", "total_amount": 0.99, "transaction_time": 1648372533000 }, { "seller": "P1eKsmV8dAYaNBcWpjg7L3mpTbJkVscJuiRs6cgEHQe", "buyer": "3TpJsd2x4njtah6sPgmBCXS4MLSoZ9zEpqpt2meQADmU", "transaction_type": "Sale", "total_amount": 0.99, "transaction_time": 1648372533000 } ], "rank": 1536, "token_address": "7ZBRCR83jqYk7bbG3RY8Qn14E341n3qwWgY6NTTPko5k", "token_name": "CitizenOne #1024", "image_url": "https://arweave.net/WGb_Cj2IhHA0N6ZgSzr5gcx0RtdFe36IDHMNnKHHr0w", "valuation_24_hours": 1.6234, "change_rate_24_hours": 0.1697, "valuation_7_days": 1.6433, "change_rate_7_days": 0.1555, "valuation_30_days": null, "change_rate_30_days": null, "max_price": 0.99, "min_price": 0.99, "price_history": [ { "price": 0.99, "timestamp": 1648372533000 } ], "valuation_history": [ { "valuation": 1.4964, "timestamp": 1654015157000 }, { "valuation": 1.5532, "timestamp": 1654101536000 }, { "valuation": 1.6433, "timestamp": 1654188018000 }, { "valuation": 1.6469, "timestamp": 1654274513000 }, { "valuation": 1.6410, "timestamp": 1654360804000 }, { "valuation": 1.7024, "timestamp": 1654447136000 }, { "valuation": 1.7223, "timestamp": 1654533508000 }, { "valuation": 1.7295, "timestamp": 1654620109000 }, { "valuation": 1.6234, "timestamp": 1654704147000 }, { "valuation": 1.8989, "timestamp": 1654849802000 } ], "holder_history": [ "3TpJsd2x4njtah6sPgmBCXS4MLSoZ9zEpqpt2meQADmU" ], "rarity_score": 76.0, "token_popularity": 67.0619 } }
Get NFT token metadata
## Request
curl -X "POST" "https://oracle-api.banksea.finance/nft/v1/token/metadata" \
-H 'x-api-key: test-api-key' \
-H 'Content-Type: application/json; charset=utf-8' \
-d $'{
"token_address":"7ZBRCR83jqYk7bbG3RY8Qn14E341n3qwWgY6NTTPko5k"
}'
Interface: /nft/v1/token/metadata
Method: POST
Data Format: JSON
Request Parameter:
token_address
String
Y
The token address of the NFT token.
Request Example:
{ "token_address":"7ZBRCR83jqYk7bbG3RY8Qn14E341n3qwWgY6NTTPko5k" }
Response Data
token_name
String
The name of the NFT token.
image_url
String
The image url of the NFT token.
attributes
List
The attributes of the NFT token.
attributes.trait_type
String
Attribute type.
attributes.value
String
Attribute value.
attributes.amount
Number
Attribute amount.
attributes.rarity
Number
Attribute rarity.
rarity_score
Number
The Rarity Score is an indicator of the rarity of NFT attributes.
rank
Number
Rank within the NFT collection for rarity scores.
Response Example:
{ "success": true, "code": "200", "message": "success", "data": { "attributes": [ { "amount": 250, "rarity": 14.04, "value": "Blue", "trait_type": "Background" }, { "amount": 180, "rarity": 10.11, "value": "Guitar", "trait_type": "Back" }, { "amount": 137, "rarity": 7.69, "value": "Silver", "trait_type": "Body" }, { "amount": 361, "rarity": 20.27, "value": "Wire Neck", "trait_type": "Neck" }, { "amount": 155, "rarity": 8.7, "value": "Police", "trait_type": "Body Feature" }, { "amount": 1405, "rarity": 78.89, "value": "None", "trait_type": "Head" }, { "amount": 1405, "rarity": 78.89, "value": "None", "trait_type": "Ear" }, { "amount": 746, "rarity": 41.89, "value": "None", "trait_type": "Mouth" }, { "amount": 230, "rarity": 12.91, "value": "Mechanical Heart", "trait_type": "Energy" }, { "amount": 746, "rarity": 41.89, "value": "None", "trait_type": "Eye" }, { "amount": 150, "rarity": 8.42, "value": "Orange Helmet", "trait_type": "Helmet" }, { "amount": 209, "rarity": 11.73, "value": "Parrot", "trait_type": "Shoulder" } ], "rank": 1536, "token_name": "CitizenOne #1024", "image_url": "https://arweave.net/WGb_Cj2IhHA0N6ZgSzr5gcx0RtdFe36IDHMNnKHHr0w", "rarity_score": 76.0 } }
Get NFT token transactions
## Request
curl -X "POST" "https://oracle-api.banksea.finance/nft/v1/token/transactions" \
-H 'x-api-key: test-api-key' \
-H 'Content-Type: application/json; charset=utf-8' \
-d $'{
"token_address":"7ZBRCR83jqYk7bbG3RY8Qn14E341n3qwWgY6NTTPko5k"
}'
Interface: /nft/v1/token/transactions
Method: POST
Data Format: JSON
Request Parameter:
token_address
String
Y
The token address of the NFT token.
Request Example:
{ "token_address":"7ZBRCR83jqYk7bbG3RY8Qn14E341n3qwWgY6NTTPko5k" }
Response Data:
max_price
Number
The highest transaction price in history.
min_price
Number
The lowest transaction price in history.
price_history
List
The list of transaction prices in history.
price_history.price
Number
historical price.
price_history.timestamp
Number
The transaction time of the historical price.
holder_history
List
The list of former holders in history.
activities
List
The list of activities.
activities.event_type
String
Type of activity.
activities.price
Number
Price of activity.
activities.from_address
String
The source address of the NFT transfer .
activities.to_address
String
The destination address of the NFT transfer.
activities.timestamp
Number
Time of activity.
token_popularity
Number
The popularity of the NFT token
Response Example:
{ "success": true, "code": "200", "message": "success", "data": { "activities": [ { "seller": "P1eKsmV8dAYaNBcWpjg7L3mpTbJkVscJuiRs6cgEHQe", "buyer": "", "transaction_type": "Listing", "total_amount": 5.0, "transaction_time": 1645150419000 }, { "seller": "P1eKsmV8dAYaNBcWpjg7L3mpTbJkVscJuiRs6cgEHQe", "buyer": "", "transaction_type": "Listing", "total_amount": 2.0, "transaction_time": 1645150503000 }, { "seller": "P1eKsmV8dAYaNBcWpjg7L3mpTbJkVscJuiRs6cgEHQe", "buyer": "", "transaction_type": "Listing", "total_amount": 0.99, "transaction_time": 1646393269000 }, { "seller": "", "buyer": "3TpJsd2x4njtah6sPgmBCXS4MLSoZ9zEpqpt2meQADmU", "transaction_type": "PlaceBid", "total_amount": 0.99, "transaction_time": 1648372533000 }, { "seller": "P1eKsmV8dAYaNBcWpjg7L3mpTbJkVscJuiRs6cgEHQe", "buyer": "3TpJsd2x4njtah6sPgmBCXS4MLSoZ9zEpqpt2meQADmU", "transaction_type": "Sale", "total_amount": 0.99, "transaction_time": 1648372533000 } ], "max_price": 0.99, "min_price": 0.99, "price_history": [ { "price": 0.99, "timestamp": 1648372533000 } ], "holder_history": [ "3TpJsd2x4njtah6sPgmBCXS4MLSoZ9zEpqpt2meQADmU" ], "token_popularity": 67.0619 } }
Get NFT token valuation
## Request
curl -X "POST" "https://oracle-api.banksea.finance/nft/v1/token/valuation" \
-H 'x-api-key: test-api-key' \
-H 'Content-Type: application/json; charset=utf-8' \
-d $'{
"token_address":"7ZBRCR83jqYk7bbG3RY8Qn14E341n3qwWgY6NTTPko5k"
}'
Interface: /nft/v1/token/valuation
Method: POST
Data Format: JSON
Request Parameter:
token_address
String
Y
The token address of the NFT token.
Request Example:
{ "token_address":"7ZBRCR83jqYk7bbG3RY8Qn14E341n3qwWgY6NTTPko5k" }
Response Data:
valuation
Number
The valuation of the NFT token.
valuation_24_hours
Number
The valuation of the NFT token from 24 hours ago.
change_rate_24_hours
Number
change_rate_24_hours = (valuation - valuation_24_hours) / valuation_24_hours.
valuation_7_days
Number
The valuation of the NFT token from 7 days ago.
change_rate_7_days
Number
change_rate_7_days = (valuation - valuation_7_days) / valuation_7_days.
valuation_30_days
Number
The valuation of the NFT token from 30 days ago.
change_rate_30_days
Number
change_rate_30_days = (valuation - valuation_30_days) / valuation_30_days.
risk
Number
The token's risk reflects the degree of volatility of the NFT.
valuation_history
List
The list of valuation over the past 30 days.
valuation_history.valuation
Number
valuation.
valuation_history.timestamp
Number
valuation time.
Response Example:
{ "success": true, "code": "200", "message": "success", "data": { "valuation": 1.8989, "risk": 0.8409, "valuation_24_hours": 1.6234, "change_rate_24_hours": 0.1697, "valuation_7_days": 1.6433, "change_rate_7_days": 0.1555, "valuation_30_days": null, "change_rate_30_days": null, "valuation_history": [ { "valuation": 1.4964, "timestamp": 1654015157000 }, { "valuation": 1.5532, "timestamp": 1654101536000 }, { "valuation": 1.6433, "timestamp": 1654188018000 }, { "valuation": 1.6469, "timestamp": 1654274513000 }, { "valuation": 1.6410, "timestamp": 1654360804000 }, { "valuation": 1.7024, "timestamp": 1654447136000 }, { "valuation": 1.7223, "timestamp": 1654533508000 }, { "valuation": 1.7295, "timestamp": 1654620109000 }, { "valuation": 1.6234, "timestamp": 1654704147000 }, { "valuation": 1.8989, "timestamp": 1654849802000 } ] } }
Last updated