For the complete documentation index, see llms.txt. This page is also available as Markdown.

big_map_value - Tezos

Example code for the /context/big_maps/{big_map_id}/{script_expr} REST method. Complete guide on how to use the /context/big_maps/{big_map_id}/{script_expr} REST method in GetBlock Web3 documentation

Returns a single value from a big map by its packed-key hash (script expression). Big maps hold large key-value stores such as token ledgers.

Endpoint

GET /chains/main/blocks/{block}/context/big_maps/{big_map_id}/{script_expr}

Path Parameters

Parameter
Type
Description

block

string

Block identifier: head, a level, or a block hash

big_map_id

string

Numeric big map identifier

script_expr

string

Script expression hash of the packed key (expr…)

Example

export TEZOS_REST=https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/

curl "${TEZOS_REST}chains/main/blocks/head/context/big_maps/5696/exprvValue..."
example.js
const axios = require('axios');

const response = await axios.get('https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/chains/main/blocks/head/context/big_maps/5696/exprvValue...', {
    headers: { 'Content-Type': 'application/json' }
});

console.log(response.data);
example.py
import requests

response = requests.get(
    'https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/chains/main/blocks/head/context/big_maps/5696/exprvValue...',
    headers={'Content-Type': 'application/json'}
)

print(response.json())
example.rs
use reqwest::Client;
use serde_json::Value;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();

    let response = client
        .get("https://shared.eu-central-1.getblock.io/<ACCESS-TOKEN>/chains/main/blocks/head/context/big_maps/5696/exprvValue...")
        .header("Content-Type", "application/json")
        .send()
        .await?
        .json::<Value>()
        .await?;

    println!("Result: {}", response);
    Ok(())
}

Response

{
    "prim": "Pair",
    "args": [
        {
            "int": "1000000"
        },
        []
    ]
}

Response Fields

Field
Type
Description

(root)

object

Big map value as a Micheline expression

Use Cases

  • Token Balances: Read an FA1.2/FA2 ledger entry

  • dApp State: Look up a specific big-map key

Error Handling

Error
Message
Description

400 / Bad request

Bad request

A path or body parameter was invalid

404 / Not found

Not found

The block, contract, or resource does not exist

403 / RBAC: access denied

Access denied

The GetBlock access token is missing or incorrect

Was this helpful?