# Block Module

Block module for accessing blockchain block data.

To learn more about how to use the AI Agent SDK to interact with the wallet module, please visit [AI Agent SDK Block Information](/crypto.com-ai-agent-sdk/core-concepts-overview/blockchain-functions/block-information.md).

#### 4.1 Get Current Block

Get the current latest block.

{% tabs %}
{% tab title="Python" %}
Function Name

```python
get_current
```

{% tabs %}
{% tab title="Query" %}

* Example Code

  ```python
  from crypto_com_developer_platform_client import Block

  block = Block.get_current()
  print(block)
  ```

{% endtab %}

{% tab title="Response" %}

* Returns

  ```python
  The latest block data.
  ```
* Errors

  ```python
  ValueError: If the Block class is not initialized with a Client instance.
  ```
* Example Return

  ```python
  {'status': 'Success', 'data': {'blockNumber': example-block-number}}
  ```

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="TypeScript" %}
Function Name

```typescript
getCurrentBlock
```

{% tabs %}
{% tab title="Query" %}

* Example Code

  ```typescript
  import { Block } from '@crypto.com/developer-platform-client';

  const block = await Block.getCurrentBlock();
  console.log(block);
  ```

{% endtab %}

{% tab title="Response" %}

* Returns

  ```typescript
  Promise<ApiResponse<BlockNumber>>: A promise that resolves to the current block data.
  ```
* Example Return

  ```typescript
  { status: 'Success', data: { blockNumber: example-number } }
  ```

{% endtab %}
{% endtabs %}
{% endtab %}
{% endtabs %}

#### 4.2 Get Block By Tag

Get a block by tag or block number.

{% tabs %}
{% tab title="Python" %}
Function Name

```python
get_by_tag
```

{% tabs %}
{% tab title="Query" %}

* Arguments

  ```python
  tag (str): Integer of a block number in hex, or the string "earliest", "latest" or "pending", as in https://ethereum.org/en/developers/docs/apis/json-rpc/#default-block
  tx_detail (str): If true it returns the full transaction objects, if false only the hashes of the transactions.
  ```
* Example Code

  ```python
  from crypto_com_developer_platform_client import Block

  block = Block.get_by_tag("latest", "true")
  print(block)
  ```

{% endtab %}

{% tab title="Response" %}

* Returns

  ```python
  The block data.
  ```
* Errors

  ```python
  ValueError: If the Block class is not initialized with a Client instance.
  ```
* Example Return

  ```python
  {'status': 'Success', 'data': {'block': {'_type': 'Block', 'baseFeePerGas': 'example-fee', 'difficulty': 'example-difficulty', 'extraData': 'example-data', 'gasLimit': 'example-gas-limit', 'gasUsed': 'example-gas-used', 'blobGasUsed': 'example-blob-gas-used', 'excessBlobGas': 'example-gas', 'hash': 'example-hash', 'miner': 'example-address', 'prevRandao': 'example-randao', 'nonce': 'example-nonce', 'number': example-number, 'parentHash': 'example-hash', 'timestamp': example-timestamp, 'parentBeaconBlockRoot': 'example-hash', 'stateRoot': 'example-hash', 'receiptsRoot': 'example-hash', 'transactions': ['example-transactions']}}}
  ```

{% endtab %}
{% endtabs %}
{% endtab %}

{% tab title="TypeScript" %}
Function Name

```typescript
getBlockByTag
```

{% tabs %}
{% tab title="Query" %}

* Arguments

  ```typescript
  (string} blockTag: Block identifier ('latest', 'pending', or block number in hex).
  {string} txDetail: Whether to include transaction details ('true' or 'false').
  ```
* Example Code

  ```typescript
  import { Block } from '@crypto.com/developer-platform-client';

  const block = await Block.getBlockByTag('latest', 'true');
  console.log(block);
  ```

{% endtab %}

{% tab title="Response" %}

* Returns

  ```typescript
  Promise<ApiResponse<BlockData>>: A promise that resolves to the block data.
  ```
* Example Return

  ```typescript
  {
    status: 'Success',
    data: {
      block: {
        _type: 'Block',
        baseFeePerGas: 'example-fee',
        difficulty: 'example-difficulty',
        extraData: 'example-data',
        gasLimit: 'example-gas-limit',
        gasUsed: 'example-gas-used',
        blobGasUsed: example-gas,
        excessBlobGas: example-gas,
        hash: 'example-hash',
        miner: 'example-hash',
        prevRandao: 'example-hash',
        nonce: 'example-nonce',
        number: example-number,
        parentHash: 'example-hash',
        timestamp: example-timestamp,
        parentBeaconBlockRoot: example-block-root,
        stateRoot: 'example-hash',
        receiptsRoot: 'example-hash',
        transactions: [example-transaction-array]
      }
    }
  }



  ```

{% endtab %}
{% endtabs %}
{% endtab %}
{% endtabs %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ai-agent-sdk-docs.crypto.com/crypto.com-developer-platform/on-chain-developer-platform-client-sdk/block-module.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.