Skip to main content

Sample Requests

Contracts​

List Contracts​

Retrieve a list of contracts on Ethereum Mainnet. Orders response by seven day trading volume. Specifies page number as 500, with a page size of 2.

curl "https://mainnet.ethereum.coinbasecloud.net/api/nft/v2/contracts?networkName=ethereum-mainnet&pageSize=2&orderBy=sevendaytradingvolume&page=500" \
-u username:password \
-H 'Content-Type: application/json'

List Contracts by Addresses​

List multiple NFT collections by their contract addresses on Ethereum Mainnet.

curl "https://mainnet.ethereum.coinbasecloud.net/api/nft/v2/contracts" \
-u username:password \
-X POST \
-H 'Content-Type: application/json' \
-d '{
  "networkName": "ethereum-mainnet",
  "contractAddressList": [
    "0xc4219ce63cec2236a955655951aea9b6f8b2431b",
    "0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d",
    "0x60e4d786628fea6478f785a6d7e704777c86a7c6",
    "0x8a90cab2b38dba80c64b7734e58ee1db38b8992e",
    "0x34d85c9cdeb23fa97cb08333b511ac86e1c4e258"
  ]
}'

Get Contract by Address​

Get an NFT contract by its address on Ethereum Mainnet.

curl "https://mainnet.ethereum.coinbasecloud.net/api/nft/v2/contracts/0xc4219ce63cec2236a955655951aea9b6f8b2431b?networkName=ethereum-mainnet" \
-u username:password \
-H 'Content-Type: application/json'

List Contract Activities​

List all the transaction and transfer activity of an NFT collection contract on Ethereum Mainnet. Data sorted in descending order with a page size of 3.

curl "https://mainnet.ethereum.coinbasecloud.net/api/nft/v2/contracts/0x34d85c9cdeb23fa97cb08333b511ac86e1c4e258/activities?networkName=ethereum-mainnet&pageSize=3&sortDirection=DESC&activity_types=transaction&activity_types=transfer" \
-u username:password \
-H 'Content-Type: application/json'

Tokens​

List Tokens in a Contract​

List all NFT tokens in a contract on Ethereum Mainnet, with a page size of 5

curl "https://mainnet.ethereum.coinbasecloud.net/api/nft/v2/contracts/0xc4219ce63cec2236a955655951aea9b6f8b2431b/tokens?networkName=ethereum-mainnet&pageSize=5" \
-u username:password \
-H 'Content-Type: application/json'