Get Vaults by type

Base URL

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

https://v2.emblemvault.io

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

Endpoint:

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"

Headers:

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

Responses:

  • 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"
    }

Examples

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 = 'https://v2.emblemvault.io';
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);
   console.log(parsedBody);
 } else {
   console.log('Error:', error);
   console.log('Status Code:', response.statusCode);
   console.log('Body:', body);
 }
});

CURL

curl -X GET \
 'https://v2.emblemvault.io/specific?project=Rare%20Pepe&chain=XCP&asset=RAREPEPE' \
 -H 'x-api-key: your_api_key_here'

Last updated