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 ERC1155 Data

Given an ERC1155 tokenId, get every internal tokenId, along with metadata and internal deposit address.

Base URL

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

https://v2.emblemvault.io

API Endpoints

Get All Backing IDs for a Token ID

Fetches metadata information related to the given token ID.

Endpoint:

GET {baseURL}/allBackingIdsForTokenId/:tokenId

Path Parameters:

  • tokenId (required): The token ID for which metadata is being requested.

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:

    {
        "balanceOnChain": 1,
        "claimed": [],
        "claimedIds": [],
        "serialNumber": "36119496532326007048069238652025686750025823909618387553508980281319231399864",
        "unclaimedSerial": true,
        "serialNumberUsed": false,
        "liveIds": [
            "37830934938218361",
            "35488643536529821"
        ],
        "liveSerialNumbers": [
            "36119496532326007048069238652025686750025823909618387553508980281319231399864",
            "114533740490565763637382110465543346260974421492875504473265002857271541240463"
        ],
        "liveAddresses": [
            "17zmXzDCdqGxZ15Jgem3jRQphsffK6nV5W",
            "1EpQsrft1Dmv9k8EEhS3xUabxKNMixyDDi"
        ],
        "errors": [],
        "errorsIds": [],
        "mintables": [],
        "mintablesIds": [],
        "mintablesAddresses": [],
        "allGroupingLengthsMatch": true,
        "currentMetadataFoundInMintableList": false,
        "loaded": false
    }

  • 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": "Not curated tokenId"
    }

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 tokenId = '14348293833920273912990111611620811208434744638373632813897914200493984998646';
const baseUrl = 'https://v2.emblemvault.io';
const apiKey = 'your_api_key_here'; // Replace with your actual API key

const options = {
 url: `${baseUrl}/allBackingIdsForTokenId/${tokenId}`,
 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/allBackingIdsForTokenId/14348293833920273912990111611620811208434744638373632813897914200493984998646' \
 -H 'x-api-key: your_api_key_here'
PreviousCreate un-minted vaultNextDemonstrations

Last updated 1 year ago

📓
📜