Get NFT Sales by Contract Address

This endpoint returns all NFT Sales for an NFT collection, identified by a contract address (supports pagination). Supported chains: ethereum, polygon, optimism, arbitrum.

Parameters

Parameter	Description	Type
chain_id	A keyword (i.e. "ethereum") or CAIP-2 identifier specifying the blockchain to query.	string
account_address	required The account address to retrieve NFT sales for (supports ENS names).	string
sold_after	The earlier sale date, inclusive (in seconds since the Unix epoch or ISO-8601 format).	date-time
sold_before	The later sale date, inclusive (in seconds since the Unix epoch or ISO-8601 format).	date-time
role	The role of the account in the sale (one of buyer, seller, or all).	string
order	The order in which to retrieve the results (either asc or desc).	string
limit	The maximum number of results to retrieve (default 100).	string

PythonNodecURL

import requests url = "https://api.transpose.io/nft/sales-by-contract-address" headers = { 'Content-Type': 'application/json', 'X-API-KEY': 'BtRVYj7dgnYUcr1gSSfWhmrTShIb8RBG', } params = { "chain_id": "ethereum", "contract_address": "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB", } response = requests.get(url, headers=headers, params=params) print(response.text) print('Credits charged:', response.headers.get('X-Credits-Charged', None))

const https = require('https'); const querystring = require('querystring'); const params = { chain_id: "ethereum", contract_address: "0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB", } var options = { hostname: 'api.transpose.io', path: '/nft/sales-by-contract-address?' + querystring.stringify(params), method: 'GET', headers: { 'X-API-KEY': 'BtRVYj7dgnYUcr1gSSfWhmrTShIb8RBG' } }; var req = https.request(options, (res) => { console.log('Credits charged:', res.headers['x-credits-charged']); res.on('data', (d) => { process.stdout.write(d); }); }); req.on('error', (e) => { console.error(e); }); req.end();

curl -X GET \
    'https://api.transpose.io/nft/sales-by-contract-address?chain_id=ethereum&contract_address=0xb47e3cd837dDF8e4c57F05d70Ab865de6e193BBB' \
    -H 'X-API-KEY: BtRVYj7dgnYUcr1gSSfWhmrTShIb8RBG' \

Got questions? Join our Discord

Discord is the primary home of the Transpose developer community. Join us to ask questions, share your work, and get help.