📃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