Emblem Vault
  • 👋Introduction
  • Information
    • 💡Explainer
    • 📜History
    • 📈COVAL
    • 🦄Collections
    • 📲Apply
  • How it Works
    • ⏩Vault Creation
    • 🔄Vault Minting
    • ⏪Unvaulting
  • Features & Products
    • 📈Emblem Markets
    • 🔒Emblem Vision
    • 🛒Bulk Features
    • ⬆️Jump
    • 🐃Migration
    • 🥷Stealth Vaults
    • ⏰Time-locked Vaults
    • 🚀Vaultpad
  • Tools
    • 💿Emblem SDK
    • 📓API Documentation (Legacy)
      • 🤝Get Vaults by owner
      • 📬By Deposit Address
      • 📃Get Metadata
      • 💵Get Vault Balance
      • 📜Get Projects
      • 📜Get Chains
      • ✅Get Verified Vaults
      • ✅Get Vaults by type
      • 🛠️Create un-minted vault
      • 📜Get ERC1155 Data
      • Demonstrations
        • Demo: Token gate
        • Demo: ERC1155 holdings
        • Demo: Fraud Vaults
        • Deep Link Vaulting
    • 🖋️Inscription Tool
      • demo
    • 🗳️Wallet Partnerships
  • Use Cases
    • 🎨DeFi
    • 👾Gaming
    • 🖥️NFTs
  • Blockchains
    • 🟡Binance Smart Chain
    • 🔵Ethereum
    • 🟣Polygon
  • Supported Networks
    • 🎒Bellscoin
    • 🎒Bitcoin
    • 🎒Bitcoin Cash/SLP
    • 🎒Bitcoin Ordinals
    • 🎒Bitcoin Stamps
    • 🎒BRC20
    • 🎒Counterparty
    • 🎒Digibyte
    • 🎒Dogecoin
    • 🎒Dogeparty
    • 🎒Ethereum
    • 🎒Ethscriptions
    • 🎒Litecoin
    • 🎒Litecoin Ordinals
    • 🎒Namecoin
    • 🎒Monacoin
    • 🎒Monaparty
    • 🎒Solana
    • 🎒Stacks
    • 🎒Tezos
  • Tutorials
    • 🧠Bitcoin Ordinals
    • 🧠Bitcoin Stamps
    • 🧠Bellscoin
    • 🧠BRC20
    • 🧠Counterparty
    • 🧠Curated Collections
    • 🧠Cursed Ordinals
    • 🧠Dogeparty
    • 🧠Emblem Markets
    • 🧠Emblem Vision
    • 🧠Ethscriptions
    • 🧠Emblem Legacy [Migration]
    • 🧠Litecoin Ordinals
    • 🧠Monaparty
    • 🧠Namecoin
    • 🧠Polygon
    • 🧠Stacks
  • FAQs
    • 🎨Artists, Creators, and Collectors
    • ❓Common Questions
    • 🔷Namecoin Help
    • 😡Troubleshooting
    • 🔐Vaulting & Unvaulting
    • 🔦Verifying Assets (Emblem Open )
  • Deep Dive
    • Smart Contracts: Github
    • How its done
  • Terms of Service
Powered by GitBook
On this page
  • Base URL
  • API Endpoints
  1. Tools
  2. API Documentation (Legacy)

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"
PreviousAPI Documentation (Legacy)NextBy Deposit Address

Last updated 2 years ago

📓
🤝