This endpoint allows batch retrieval of multiple tokens in a single query with the ability to customise the query

🚧

This endpoint is still in the Beta stage.

Parameters

  • tokens- a list of token hashes to query for

Results

Valid Response

<object>- a JSON key-value mapping object containing the following fields:

Example of a valid response:

{
  "BaconSBRjNckjeQCi6E2Ndg8wSmAwPgmfmZnF6ZmyFhz": {
    "mint": "BaconSBRjNckjeQCi6E2Ndg8wSmAwPgmfmZnF6ZmyFhz",
    "decimals": 6,
    "freezeAuthority": "7vxDmRAWmK16x8szwtkQQXSV7hvvwm6jVsuHqceFv4JE",
    "mintAuthority": "7vxDmRAWmK16x8szwtkQQXSV7hvvwm6jVsuHqceFv4JE",
    "tokenType": "Legacy",
    "tokenList": {
      "name": "Bacon SBR (sunSBR Token of Appreciation)",
      "symbol": "baconSBR",
      "image": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/BaconSBRjNckjeQCi6E2Ndg8wSmAwPgmfmZnF6ZmyFhz/logo.svg",
      "extensions": null,
      "chainId": 101
    }
  },
  "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v": {
    "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "decimals": 6,
    "freezeAuthority": "3sNBr7kMccME5D55xNgsmYpZnzPgP2g12CixAajXypn6",
    "mintAuthority": "2wmVCSfPxGPjrnMMn7rchp4uaeoTqN39mXFC2zhPdri9",
    "tokenType": "Legacy",
    "tokenList": {
      "name": "USD Coin",
      "symbol": "USDC",
      "image": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v/logo.png",
      "extensions": {
        "coingeckoId": "usd-coin"
      },
      "chainId": 101
    },
    "tokenMetadata": {
      "onChainInfo": {
        "name": "USD Coin",
        "symbol": "USDC",
        "metadata": "5x38Kp4hvdomTCnCrAny4UtMUt5rQBdB6px2K1Ui45Wq",
        "updateAuthority": "2wmVCSfPxGPjrnMMn7rchp4uaeoTqN39mXFC2zhPdri9",
        "isMasterEdition": null,
        "edition": null,
        "uri": "",
        "sellerFeeBasisPoints": 0,
        "primarySaleHappened": false,
        "isMutable": true,
        "creators": [],
        "ruleSet": null,
        "collection": null,
        "collectionDetails": null,
        "uses": null
      },
      "offChainInfo": null
    }
  }
}

Invalid Response

<object> - a JSON object containing the following fields if the requested account doesn't exist

  • code:<integer>, The error code
  • message:<String>, An error message to indicate which part of the query went wrong
  • status:<String>, The response status following the error code
    • 400 = Bad Request (client side)
    • 500 = Internal Server Error (server side)
Language
Click Try It! to start a request and see the response here!