Get Collections by Symbol

This endpoint returns all NFT Collections that match a given symbol 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 symbol 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-symbol"
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))

Run

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-symbol?' + 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();

Run

curl -X GET \
    'https://api.transpose.io/nft/collections-by-symbol?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.