# Chain

Blockchain data and statistics

## Get chain statistics

> Retrieve current blockchain statistics including height, validators, etc.

```json
{"openapi":"3.0.3","info":{"title":"Amadeus Blockchain API","version":"1.5.0"},"tags":[{"name":"Chain","description":"Blockchain data and statistics"}],"servers":[{"url":"https://nodes.amadeus.bot","description":"Mainnet"},{"url":"https://testnet-rpc.ama.one","description":"Testnet"}],"paths":{"/api/chain/stats":{"get":{"tags":["Chain"],"summary":"Get chain statistics","description":"Retrieve current blockchain statistics including height, validators, etc.","responses":{"200":{"description":"Chain statistics","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"stats":{"type":"object","properties":{"height":{"type":"integer","description":"Current blockchain height"},"validators":{"type":"integer","description":"Number of active validators"},"epoch":{"type":"integer","description":"Current epoch number"}}}}}}}}}}}}}
```

## Get latest entry (tip)

> Retrieve the most recent blockchain entry

```json
{"openapi":"3.0.3","info":{"title":"Amadeus Blockchain API","version":"1.5.0"},"tags":[{"name":"Chain","description":"Blockchain data and statistics"}],"servers":[{"url":"https://nodes.amadeus.bot","description":"Mainnet"},{"url":"https://testnet-rpc.ama.one","description":"Testnet"}],"paths":{"/api/chain/tip":{"get":{"tags":["Chain"],"summary":"Get latest entry (tip)","description":"Retrieve the most recent blockchain entry","responses":{"200":{"description":"Latest entry","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}
```

## Get entry by hash

> Retrieve a blockchain entry by its hash

```json
{"openapi":"3.0.3","info":{"title":"Amadeus Blockchain API","version":"1.5.0"},"tags":[{"name":"Chain","description":"Blockchain data and statistics"}],"servers":[{"url":"https://nodes.amadeus.bot","description":"Mainnet"},{"url":"https://testnet-rpc.ama.one","description":"Testnet"}],"paths":{"/api/chain/hash/{hash}":{"get":{"tags":["Chain"],"summary":"Get entry by hash","description":"Retrieve a blockchain entry by its hash","parameters":[{"name":"hash","in":"path","required":true,"description":"Entry hash (Base58 encoded)","schema":{"type":"string"}},{"name":"filter_on_function","in":"query","required":false,"description":"Filter transactions by contract function name","schema":{"type":"string"}}],"responses":{"200":{"description":"Entry data","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}
```

## Get entry by height

> Retrieve a blockchain entry by its height

```json
{"openapi":"3.0.3","info":{"title":"Amadeus Blockchain API","version":"1.5.0"},"tags":[{"name":"Chain","description":"Blockchain data and statistics"}],"servers":[{"url":"https://nodes.amadeus.bot","description":"Mainnet"},{"url":"https://testnet-rpc.ama.one","description":"Testnet"}],"paths":{"/api/chain/height/{height}":{"get":{"tags":["Chain"],"summary":"Get entry by height","description":"Retrieve a blockchain entry by its height","parameters":[{"name":"height","in":"path","required":true,"description":"Block height","schema":{"type":"integer"}}],"responses":{"200":{"description":"Entry data","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}
```

## Get entry by height with full transactions

> Retrieve a blockchain entry by height including full transaction details

```json
{"openapi":"3.0.3","info":{"title":"Amadeus Blockchain API","version":"1.5.0"},"tags":[{"name":"Chain","description":"Blockchain data and statistics"}],"servers":[{"url":"https://nodes.amadeus.bot","description":"Mainnet"},{"url":"https://testnet-rpc.ama.one","description":"Testnet"}],"paths":{"/api/chain/height_with_txs/{height}":{"get":{"tags":["Chain"],"summary":"Get entry by height with full transactions","description":"Retrieve a blockchain entry by height including full transaction details","parameters":[{"name":"height","in":"path","required":true,"description":"Block height","schema":{"type":"integer"}}],"responses":{"200":{"description":"Entry data with transactions","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}
```

## Get transaction by ID

> Retrieve a transaction by its ID

```json
{"openapi":"3.0.3","info":{"title":"Amadeus Blockchain API","version":"1.5.0"},"tags":[{"name":"Chain","description":"Blockchain data and statistics"}],"servers":[{"url":"https://nodes.amadeus.bot","description":"Mainnet"},{"url":"https://testnet-rpc.ama.one","description":"Testnet"}],"paths":{"/api/chain/tx/{txid}":{"get":{"tags":["Chain"],"summary":"Get transaction by ID","description":"Retrieve a transaction by its ID","parameters":[{"name":"txid","in":"path","required":true,"description":"Transaction ID (Base58 encoded)","schema":{"type":"string"}}],"responses":{"200":{"description":"Transaction data","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}
```

## Get transaction events by account

> Retrieve transaction history for a specific account with pagination and filtering

```json
{"openapi":"3.0.3","info":{"title":"Amadeus Blockchain API","version":"1.5.0"},"tags":[{"name":"Chain","description":"Blockchain data and statistics"}],"servers":[{"url":"https://nodes.amadeus.bot","description":"Mainnet"},{"url":"https://testnet-rpc.ama.one","description":"Testnet"}],"paths":{"/api/chain/tx_events_by_account/{account}":{"get":{"tags":["Chain"],"summary":"Get transaction events by account","description":"Retrieve transaction history for a specific account with pagination and filtering","parameters":[{"name":"account","in":"path","required":true,"description":"Account address (Base58 encoded)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Maximum number of transactions to return","schema":{"type":"integer","default":100}},{"name":"offset","in":"query","required":false,"description":"Number of transactions to skip","schema":{"type":"integer","default":0}},{"name":"sort","in":"query","required":false,"description":"Sort order","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}},{"name":"type","in":"query","required":false,"description":"Filter by transaction type","schema":{"type":"string","enum":["sent","recv"]}},{"name":"cursor","in":"query","required":false,"description":"Pagination cursor (raw bytes)","schema":{"type":"string"}},{"name":"cursor_b58","in":"query","required":false,"description":"Pagination cursor (Base58 encoded)","schema":{"type":"string"}},{"name":"contract","in":"query","required":false,"description":"Filter by contract address (raw bytes)","schema":{"type":"string"}},{"name":"contract_b58","in":"query","required":false,"description":"Filter by contract address (Base58 encoded)","schema":{"type":"string"}},{"name":"function","in":"query","required":false,"description":"Filter by contract function name","schema":{"type":"string"}}],"responses":{"200":{"description":"Transaction events","content":{"application/json":{"schema":{"type":"object","properties":{"cursor":{"type":"string","description":"Cursor for next page"},"txs":{"type":"array","items":{"type":"object"}}}}}}}}}}}}
```

## Get transactions in entry

> Retrieve all transactions contained in a specific entry

```json
{"openapi":"3.0.3","info":{"title":"Amadeus Blockchain API","version":"1.5.0"},"tags":[{"name":"Chain","description":"Blockchain data and statistics"}],"servers":[{"url":"https://nodes.amadeus.bot","description":"Mainnet"},{"url":"https://testnet-rpc.ama.one","description":"Testnet"}],"paths":{"/api/chain/txs_in_entry/{entry_hash}":{"get":{"tags":["Chain"],"summary":"Get transactions in entry","description":"Retrieve all transactions contained in a specific entry","parameters":[{"name":"entry_hash","in":"path","required":true,"description":"Entry hash (Base58 encoded)","schema":{"type":"string"}}],"responses":{"200":{"description":"List of transactions","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"txs":{"type":"array","items":{"type":"object"}}}}}}}}}}}}
```


---

# 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://docs.ama.one/http-api/chain.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.