🤝Get Vaults by owner

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 assets for the provided owner of the specified category.

Endpoint:

GET {baseURL}/myvaults/:ownerAddress?start=0&size=20

Path Parameters:

• ownerAddress (required): Address that owns the vaults

Query string Parameters:

• size(optional): number of results requesting

• start (optional): cursor, or index to start receiving results for

Headers:

• chainId (required): the numerical chainID for the blockchain (1 = mainnet)

• VaultType (required): the state or type of vault (uinclaimed, curated, claimed, unminted)

Responses:

• 200 OK - The request was successful, and the list of vaults and their metadata are returned.

  Example successful response:

  [
    {
      "name": "10000 KEVIN Overmint SRC-20 tokens",
      "version": 8,
      "basePath": "m/44'",
      "pubkey": "",
      "addresses": [
        {
          "path": "m/44'/0'/0'/0",
          "address": "1wqXoU949d6kc9ijwNMH45gbU5h1GZz8z",
          "coin": "BTC"
        },
        {
          "path": "m/44'/5757'0'/0/0",
          "address": "SP2ZP3EAP8M9QW3XBHVZBS4Z3569E052RE0P5FEDM",
          "coin": "STX"
        },
        {
          "address": "bc1phu8zmt4stjaatvutamdaz3y2xgln9plla33w89yd0ra77nfxn0rs6ej599",
          "path": "m/86'/0'/0'/0/0",
          "coin": "TAP"
        },
        {
          "path": "m/44'/60'/0'/0",
          "address": "0x9054A710ef883EF47416D05E5A1CdE4aba14524d",
          "coin": "ETH"
        },
        {
          "path": "m/44'/2'/0'/0",
          "address": "LS5W4tcmyWnMYH98yNz63JL6NYUHMSJcKD",
          "coin": "LTC"
        },
        {
          "path": "m/44'/7'/0'/0",
          "address": "NJCKfwofwyZ7oQe2BpYWVKp2mRmdhmHBxx",
          "coin": "NMC"
        },
        {
          "path": "m/44'/20'/0'/0",
          "address": "D6pgoTsipR2EXAhDb6AEk5YKbHVNFQiYoi",
          "coin": "DGB"
        },
        {
          "path": "m/44'/3'/0'/0",
          "address": "DJUXqZXraiKSRSpJQtxutdWkkLQkXrqina",
          "coin": "DOGE"
        },
        {
          "path": "m/44'/145'/0'/0",
          "address": "bitcoincash:qpk3empq42rq2rxq7fggfl3yc5yem24g9ulsjut0z0",
          "coin": "BCH"
        },
        {
          "path": "m/44'/22'/0'/0",
          "address": "MX4cZ68ALpeG4VjxjGCkSQCrqsuokkdbg8",
          "coin": "MONA"
        },
        {
          "derivationPath": "m/44'/1729'/0'/0'",
          "address": "tz1U8Ghjctbrp4wRA1NzaUoQNnsSUED9SHbp",
          "coin": "TEZOS"
        }
      ],
      "ciphertextV2": "U2FsdGVkX1+dfmZn/mO6dlLxAsaiq1tyY4CAqi9uIuJZsim8TITttuvc7wfTNlAFXacza8yKNjYN2MZ0DVlUXzGL5BJK0NJWaztN3DsYvJv6RRButHE0Kul4svdSkg9PYQ4lQQDm0P27+LJZe18XXiAQvvnbyrGvmiWxRSf3ccCWQ8YqX1H2D2cjxbBEjtcJyU6m4tauMcHNHJRuG1XZS04Cc+G09yCKJl+Yytgm41G1PgmdooCgK4/KN56TbiXE7pj+8lLyhFfWk5novFM8+O960t/MwE9Wl62EuwnBKYM9Nq9Y3Ke8bEl3cWh1UwLMmdVpxT2ulfznTdUCzmDDldxED3B6nlkMvKSrOcu/n7rZWfzV+9O3IST5QEzRgviyb7QR+Tf5SB6ei0AL8G2d1reqAJzv5CKJMatFK9Oo2on8P5OY0jyoYS8jb70OpxCYuFa+scKNNpEGsjmbdjYvz65M9jQvDRk7fITtfO9utgL5+2cLEIuxH+rQWh1tYyCC9+swuMhRFXwSEZRcg8xqSjlAZy+MZUykkDg9kdCx58ARnaL2q4uFipavCpNwfRAuzjRqtseII+kfl66i5b9jgl1cVyoSyOzWfbje8RtAM80=",
      "cipherTextHash": "0x9054A710ef883EF47416D05E5A1CdE4aba14524d",
      "vaultName": "EMBLEM-1959368600465772-3331418916026647",
      "description": "Kevin is a features not a bug! This is an authentic overmint of a the Kevin SRC-20 Kevin Token. We are ALL Kevin. ALL Kevins Matter! ",
      "attributes": [],
      "tokenId": "72960534738590221",
      "to": "0x08c1fF6430320C8A7157c265DF21662d7c551546",
      "network": "mainnet",
      "live": false,
      "image_ipfs": "QmagtYwaiP6t5MWuzEPoaXGP9UtNNVVoFwcBDF7S3jd6Px",
      "ipfs": "QmWTAfSdGfT7LKzwngYBPBLfDBj7QmDkS2WqUYdkWy6yTH",
      "image": "ipfs://QmagtYwaiP6t5MWuzEPoaXGP9UtNNVVoFwcBDF7S3jd6Px"
    },
    ...
  ]

• 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 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://metadata.emblemvault.io';
const ownerAddress = 'address_of_interest'; 
const chainId = 1;
const vaultType = 'unminted';
const size = 20;
const start = 0;

const options = {
    url: `${baseUrl}/myvaults/${ownerAddress}?start=${start}&size=${size}`,
    headers: {
        'chainId': chainId,
        'VaultType': vaultType
    }
};

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/myvaults/ADDRESS_HERE?start=0&size=20" \
     -H "chainId: 1" \
     -H "VaultType: unminted"