NFT API Reference

Overview

NFT APIs are to enable users to receive, display and send NFTs that haven't been published on GhostMarket or OpenSea using ONTO.

NFT Standards

API Protocol

Data Format

API List

1. Fetch NFTs from Marketplace

Filters and fetches NFTs based on specified conditions from the marketplace
Request Format for GhostMarket
https://api.ghostmarket.io/api/v1/assets?order_by=list_or_bid_time&order_direction=desc&offset=0&limit=50&with_total=1&fiat_currency=USD&auction_state=auction_ongoing&auction_started=all&chain=bsc&grouping=1&only_verified=0&status=all&nsfw_mode=only_safe
Sample Response
View here

Request Format for OpenSea
https://api.opensea.io/api/v1/assets?token_ids={token_ids}&asset_contract_address={asset_contract_address}&collection={collection}
Parameters
Name
Type
Description
token_ids
QUERY PARAMS
token ID
asset_contract_addresses
QUERY PARAMS
contract address
collection
QUERY PARAMS
name of NFT collection
Sample Request
curl --request GET \
--url 'https://api.opensea.io/api/v1/assets?token_ids=9973&asset_contract_address=0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d&collection=boredapeyachtclub'
Sample Response
View here

2. Fetch NFT Details

Fetches detailed information on a specific NFT
Request Format
https://api.opensea.io/api/v1/asset/{asset_contract_address}/{token_id}/
Parameters
Name
Type
Description
asset_contract_address
PATH PARAMS
contract address
token_id
PATH PARAMS
toke ID
Sample Request
curl --request GET \
--url 'https://api.opensea.io/api/v1/asset/0x3edf71a31b80ff6a45fdb0858ec54de98df047aa/1/'
Sample Response
View here

3. Fetch NFTs by wallet and contract address

Fetches NFTs by user wallet addresses and contract addresses
Request Format
https://api.opensea.io/api/v1/assets?owner={owner}&asset_contract_address={asset_contract_address}&token_ids={token_ids}
Parameters
Name
Type
Description
owner
QUERY PARAMS
user wallet address
asset_contract_address
QUERY PARAMS
contract address
token_id
QUERY PARAMS
token ID
Sample Request
curl --request GET \
--url 'https://api.opensea.io/api/v1/assets?owner=0xbdb6fdd2bf2aa01051540a0630ae568282a4bbef&asset_contract_address=0x3edf71a31b80ff6a45fdb0858ec54de98df047aa&token_ids=343'
Sample Response
View here