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

• ERC-721

• ERC-1155

API Protocol

• REST-API

Data Format

• JSON

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