Skip to main content

Chain

Blockchain data and statistics

Get chain statistics​

Retrieve current blockchain statistics including height, validators, etc.

{"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

{"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

{"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

{"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

{"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

{"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

{"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

{"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"}}}}}}}}}}}}