Get Collections by Name

This endpoint returns all NFT Collections that match a given name substring (supports pagination up to 1000 results). Supported chains: ethereum, polygon, optimism, scroll, arbitrum, base, avalanche.

Parameters

Parameter	Description	Type
chain_id	A keyword (i.e. "ethereum") or CAIP-2 identifier specifying the blockchain to query.	string
substring	required The substring to use in the collection name search (case-insensitive, max length 100 characters).	string
fuzzy	Whether to match text exactly or use fuzzy text matching.	boolean
limit	The maximum number of results to retrieve (default 100).	string

PythonNodecURL

import requests url = "https://api.transpose.io/nft/collections-by-name" headers = { 'Content-Type': 'application/json', 'X-API-KEY': 'BtRVYj7dgnYUcr1gSSfWhmrTShIb8RBG', } params = { "chain_id": "ethereum", "substring": "punks", } 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", substring: "punks", } var options = { hostname: 'api.transpose.io', path: '/nft/collections-by-name?' + 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/collections-by-name?chain_id=ethereum&substring=punks' \
    -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.