Get Vaults by type

Base URL

All API requests should be made to the following base URL:

API Endpoints

Get a list of verified vaults for the provided project and chain

Fetches all the verified vault Id's for a given project and chain


GET {baseURL}/specific

Query string Parameters:

  • project (optional): The project name you are looking for

  • chain (optional): The asset chain name you are looking for

  • asset (optional): The asset name you are looking for (friendly name from collection or assetName)

  • assetName (optional): The unformatted asset name if one exists. For example "XCP numerics - A9273811471789100000"


  • x-api-key (required): Your API key. It should be sent in the request header.


  • 200 OK - The request was successful, and the metadata is returned.

    Example successful response:

            "asset_chain": "XCP",
            "asset_name": "RAREPEPE",
            "project": "Rare Pepe",
            "tokenid": "49966397840103291"
            "asset_chain": "XCP",
            "asset_name": "RAREPEPE",
            "project": "Rare Pepe",
            "tokenid": "76921939146412821"

  • 401 Unauthorized - The request was made with an incorrect or missing API key.

    Example response when no API key is provided:

        "error": "No API key detected"

    Example response when the API key is incorrect:

        "error": "Unauthorized"

  • 400 Bad Request - The request was unsuccessful due to incorrect input or an error in processing. Check the response body for more information.

    Example response for not curated token ID:

        "success": false,
        "error": "No items found"


Here's an example using the request library in Node.js to make a request to the API with the provided tokenId:

const request = require('request');

const baseUrl = '';
const apiKey = 'your_api_key_here'; // Replace with your actual API key

const options = {
 url: `${baseUrl}/specific?project=Rare%20Pepe&chain=XCP&asset=RAREPEPE`,
 headers: {
   'x-api-key': apiKey,

request(options, (error, response, body) => {
 if (!error && response.statusCode === 200) {
   const parsedBody = JSON.parse(body);
 } else {
   console.log('Error:', error);
   console.log('Status Code:', response.statusCode);
   console.log('Body:', body);


curl -X GET \
 '' \
 -H 'x-api-key: your_api_key_here'

Last updated