📃Get Metadata

Base URL

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

https://metadata.emblemvault.io

API Endpoints

Get All Known Projects

Fetches all known asset chains (for use in the verified vaults call).

Endpoint:

GET {baseURL}/meta/:tokenId

Path Parameters:

  • tokenId (required): The tokenId to get metadata for.

Responses:

  • 200 OK - The request was successful, and the list of asset chains is returned.

    Example successful response:

    {
        "name": "Emblem Vault on Bitcoin",
        "tokenId": "709923891251641011",
        "description": "This is the first Emblem Vault on Bitcoin\n\n\n\nView contents of NFT by expanding Properties Below and at Emblem.Finance 👇\n\n[View this NFT on Emblem.Finance](https://emblem.finance/nft?id=709923891251641011)\n\nETH Explorer: [0x0dBa3F1Cd958255B42068fB6c4d9C37bC4F17554](https://etherscan.io/address/0x0dBa3F1Cd958255B42068fB6c4d9C37bC4F17554)\n\nXCP Explorer: [12uNzw4zH68JBm8EjyDHdq1YfPe1pyr53u](https://xchain.io/address/12uNzw4zH68JBm8EjyDHdq1YfPe1pyr53u)\n\nXTZ Explorer: [tz1UQJBSQamuA82rPM2DMjEEUesroSE15yXV](https://tzkt.io/tz1UQJBSQamuA82rPM2DMjEEUesroSE15yXV)\n\n\n\n",
        "image": "ipfs://QmWimVJ5RL4sFsmzyW8QWKbF8qyMmhTMQhEBuzfUtH6ZWi",
        "ownedImage": null,
        "addresses": [
            {
                "path": "m/44'/0'/0'/0",
                "address": "12uNzw4zH68JBm8EjyDHdq1YfPe1pyr53u",
                "coin": "BTC"
            },
            {
                "path": "m/44'/60'/0'/0",
                "address": "0x0dBa3F1Cd958255B42068fB6c4d9C37bC4F17554",
                "coin": "ETH"
            },
            {
                "path": "m/44'/2'/0'/0",
                "address": "Li9R5cE617LCwWrNdN65bFgjhpgZSfH26Z",
                "coin": "LTC"
            },
            {
                "path": "m/44'/7'/0'/0",
                "address": "N9XDZNJYHCXABg3BN6K3UDegJfGagaYXBS",
                "coin": "NMC"
            },
            {
                "path": "m/44'/20'/0'/0",
                "address": "DKtCA1VAkdAezLk5uZ7YRs4DQtHKjswdHk",
                "coin": "DGB"
            },
            {
                "path": "m/44'/3'/0'/0",
                "address": "DTeMLdKMQRNxMvTsCGB8zG1dQ2UgXFd8FQ",
                "coin": "DOGE"
            },
            {
                "path": "m/44'/145'/0'/0",
                "address": "bitcoincash:qzgl4usn5836n70fmvhwzkv2vzsdplk4gqsapvlf3c",
                "coin": "BCH"
            },
            {
                "path": "m/44'/22'/0'/0",
                "address": "MKXr9TD2t3hpnigPePwC5DHKVfDhPUVWth",
                "coin": "MONA"
            },
            {
                "derivationPath": "m/44'/1729'/0'/0'",
                "address": "tz1UQJBSQamuA82rPM2DMjEEUesroSE15yXV",
                "coin": "TEZOS"
            }
        ],
        "network": "bitcoin",
        "attributes": [
            {
                "trait_type": "Generative Dynamic v0:Balance",
                "value": "1"
            },
            {
                "trait_type": "ETH",
                "value": "All ETH"
            },
            {
                "trait_type": "ETH",
                "value": "Generative Dynamic v0"
            },
            {
                "trait_type": "PEPECASH:Balance",
                "value": "1"
            },
            {
                "trait_type": "version",
                "value": 2
            },
            {
                "trait_type": "Rare Pepe",
                "value": "All Rare Pepe"
            },
            {
                "trait_type": "Rare Pepe",
                "value": "PEPECASH"
            },
            {
                "trait_type": "Series #",
                "value": 1
            },
            {
                "trait_type": "Series # 1 Card #",
                "value": 11
            },
            {
                "trait_type": "Total Supply",
                "value": "696299320.93433"
            },
            {
                "trait_type": "Supply Range",
                "value": "> 500"
            },
            {
                "trait_type": "Year",
                "value": "2016"
            },
            {
                "trait_type": "Ethereum:Balance",
                "value": "0.002613887059167948"
            },
            {
                "trait_type": "ETH",
                "value": "Ethereum"
            },
            {
                "trait_type": "Tezos:Balance",
                "value": "1"
            },
            {
                "trait_type": "XTZ",
                "value": "All XTZ"
            },
            {
                "trait_type": "Status",
                "value": "Unclaimed"
            }
        ],
        "values": [
            {
                "coin": "ETH",
                "name": "Generative Dynamic v0",
                "balance": 1,
                "symbol": "",
                "address": "0xa5d2b92091df326007cb5b856dccd702aefaf361",
                "tokenType": "ERC721",
                "tokenId": "0",
                "image": "https://emblem.finance/generative.dynamic.png",
                "project": null,
                "projectLogo": null,
                "projectSite": null,
                "traits": [],
                "price": 0,
                "percentage": 0
            },
            {
                "coin": "XCP",
                "name": "PEPECASH",
                "balance": 1,
                "type": "nft",
                "external_url": "https://xchain.io/asset/PEPECASH",
                "image": "https://xchain.io/img/cards/PEPECASH.jpg",
                "project": "Rare Pepe",
                "projectLogo": "rare-pepe.jpg",
                "projectSite": "http://rarepepedirectory.com/",
                "series": 1,
                "order": 11,
                "issued": 1000000000,
                "burned": 303700679.06567,
                "circulating": 696299320.93433,
                "traits": [
                    {
                        "trait_type": "Series #",
                        "value": 1
                    },
                    {
                        "trait_type": "Series # 1 Card #",
                        "value": 11
                    },
                    {
                        "trait_type": "Total Supply",
                        "value": "696299320.93433"
                    },
                    {
                        "trait_type": "Supply Range",
                        "value": "> 500"
                    },
                    {
                        "trait_type": "Year",
                        "value": "2016"
                    }
                ],
                "price": 0,
                "percentage": 0
            },
            {
                "coin": "ETH",
                "name": "Ethereum",
                "balance": 0.002613887059167948,
                "price": 4,
                "project": null,
                "projectLogo": null,
                "projectSite": null,
                "traits": [],
                "percentage": 0
            },
            {
                "coin": "XTZ",
                "name": "Tezos",
                "type": "native",
                "image": "data:image/png;base64,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",
                "balance": 1,
                "project": null,
                "projectLogo": null,
                "projectSite": null,
                "traits": [],
                "price": 0,
                "percentage": 0
            }
        ],
        "totalValue": null,
        "private": false,
        "youtube_url": null,
        "animation_url": null,
        "ciphertextV2": "U2FsdGVkX1889dt5m/bXG6vsP4PPV1ZbikPmnsGSsFM=",
        "live": true,
        "nonce": "2507694559390110",
        "signature": "0x552fc4dffc2879f6b4f5fdc23b07552a6c4d794cc5e3ad23639d7720b280256721d23d8cac9458e7316347817f2c1253fc874921fe357c78b16f8d447ea7008b1c",
        "to": "0x3B31925EeC78dA3CF15c4503604c13b0eEBC57e5",
        "is_dynamic": true,
        "platform": "Counterparty",
        "sealed": false,
        "collectionAddress": null,
        "targetContract": null,
        "targetAsset": null,
        "mintLocked": false,
        "mintLockBlock": null,
        "image_ipfs": "QmWimVJ5RL4sFsmzyW8QWKbF8qyMmhTMQhEBuzfUtH6ZWi",
        "ipfs": "QmVMgd7WaJRzVMTjdwNXVZxcjjP4F8VvZ1ZiPngmpt551c",
        "external_url": "https://emblem.finance/nft?id=709923891251641011",
        "collection_name": "Rare Pepe [Emblem Vault]",
        "curation_status": "curated",
        "origDescription": "This is the first Emblem Vault on Bitcoin"
    }

  • 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 empty set:

    {
        "success": false,
        "error": "No metadata 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://metadata.emblemvault.io';
const tokenId = 'your_tokenId_here'; // Replace with your actual API key

const options = {
 url: `${baseUrl}/meta/${tokenId}`
};

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://metadata.emblemvault.io/meta/TOKENID"

Last updated