NFT API Reference

Search…

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​

Integrate ONTO in Mobile dApp

Last modified 10mo ago

Copy link

On this page

Overview

NFT Standards

API Protocol

Data Format

API List

1. Fetch NFTs from Marketplace

2. Fetch NFT Details

3. Fetch NFTs by wallet and contract address