Merge pull request #440 from blockfrost/feat/accounts/time

feat: add tx_slot and block_time/height to /accounts/:sa/* and treasury_donation to /txs/:tx_hash

Author: slowbackspace

CHANGELOG.md

@@ -9,6 +9,13 @@ Unreleased changes are in the `master` branch.
 
 ## [Unreleased]
 
+## [0.1.86] - 2026-03-02
+
+### Added
+
+- New `tx_slot`, `block_time`, and `block_height` fields in `/accounts/:stake_address/delegations`, `/accounts/:stake_address/registrations`, `/accounts/:stake_address/withdrawals`, and `/accounts/:stake_address/mirs` responses
+- New `treasury_donation` field in `/txs/:tx_hash` response
+
 ## [0.1.85] - 2026-02-11
 
 ### Added

blockfrost-openapi.yaml

@@ -1,6 +1,6 @@
 openapi: 3.0.0
 info:
-  version: 0.1.85
+  version: 0.1.86
   title: Blockfrost.io ~ API Documentation
   x-logo:
     url: https://staging.blockfrost.io/images/logo.svg
@@ -8266,6 +8266,10 @@ components:
           type: boolean
           example: true
           description: True if contract script passed validation
+        treasury_donation:
+          type: string
+          example: '0'
+          description: Treasury donation in Lovelaces
       required:
         - hash
         - block
@@ -8289,6 +8293,7 @@ components:
         - asset_mint_or_burn_count
         - redeemer_count
         - valid_contract
+        - treasury_donation
     tx_content_utxo:
       type: object
       properties:
@@ -8974,20 +8979,38 @@ components:
           pool_id:
             type: string
             description: Bech32 ID of pool being delegated to
+          tx_slot:
+            type: integer
+            description: Slot of the transaction containing the delegation
+          block_time:
+            type: integer
+            description: Block creation time in UNIX time of the transaction containing the delegation
+          block_height:
+            type: integer
+            description: Block height of the transaction containing the delegation
         required:
           - active_epoch
           - tx_hash
           - amount
           - pool_id
+          - tx_slot
+          - block_time
+          - block_height
       example:
         - active_epoch: 210
           tx_hash: 2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531
           amount: '12695385'
           pool_id: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy
+          tx_slot: 45093580
+          block_time: 1646437200
+          block_height: 6745358
         - active_epoch: 242
           tx_hash: 1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dde628516157f0
           amount: '12691385'
           pool_id: pool1kchver88u3kygsak8wgll7htr8uxn5v35lfrsyy842nkscrzyvj
+          tx_slot: 48093580
+          block_time: 1649033600
+          block_height: 7126896
     account_registration_content:
       type: array
       items:
@@ -9002,14 +9025,32 @@ components:
               - registered
               - deregistered
             description: Action in the certificate
+          tx_slot:
+            type: integer
+            description: Slot of the transaction containing the (de)registration certificate
+          block_time:
+            type: integer
+            description: Block creation time in UNIX time of the transaction containing the (de)registration certificate
+          block_height:
+            type: integer
+            description: Block height of the transaction containing the (de)registration certificate
         required:
           - tx_hash
           - action
+          - tx_slot
+          - block_time
+          - block_height
       example:
         - tx_hash: 2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531
           action: registered
+          tx_slot: 45093580
+          block_time: 1646437200
+          block_height: 6745358
         - tx_hash: 1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dde628516157f0
           action: deregistered
+          tx_slot: 48093580
+          block_time: 1649033600
+          block_height: 7126896
     account_withdrawal_content:
       type: array
       items:
@@ -9021,14 +9062,32 @@ components:
           amount:
             type: string
             description: Withdrawal amount in Lovelaces
+          tx_slot:
+            type: integer
+            description: Slot of the transaction containing the withdrawal
+          block_time:
+            type: integer
+            description: Block creation time in UNIX time of the transaction containing the withdrawal
+          block_height:
+            type: integer
+            description: Block height of the transaction containing the withdrawal
         required:
           - tx_hash
           - amount
+          - tx_slot
+          - block_time
+          - block_height
       example:
         - tx_hash: 48a9625c841eea0dd2bb6cf551eabe6523b7290c9ce34be74eedef2dd8f7ecc5
           amount: '454541212442'
+          tx_slot: 45093580
+          block_time: 1646437200
+          block_height: 6745358
         - tx_hash: 4230b0cbccf6f449f0847d8ad1d634a7a49df60d8c142bb8cc2dbc8ca03d9e34
           amount: '97846969'
+          tx_slot: 48093580
+          block_time: 1649033600
+          block_height: 7126896
     account_mir_content:
       type: array
       items:
@@ -9040,14 +9099,32 @@ components:
           amount:
             type: string
             description: MIR amount in Lovelaces
+          tx_slot:
+            type: integer
+            description: Slot of the transaction containing the MIR
+          block_time:
+            type: integer
+            description: Block creation time in UNIX time of the transaction containing the MIR
+          block_height:
+            type: integer
+            description: Block height of the transaction containing the MIR
         required:
           - tx_hash
           - amount
+          - tx_slot
+          - block_time
+          - block_height
       example:
         - tx_hash: 69705bba1d687a816ff5a04ec0c358a1f1ef075ab7f9c6cc2763e792581cec6d
           amount: '2193707473'
+          tx_slot: 45093580
+          block_time: 1646437200
+          block_height: 6745358
         - tx_hash: baaa77b63d4d7d2bb3ab02c9b85978c2092c336dede7f59e31ad65452d510c13
           amount: '14520198574'
+          tx_slot: 48093580
+          block_time: 1649033600
+          block_height: 7126896
     account_addresses_content:
       type: array
       items:

docs/blockfrost-openapi.yaml

@@ -1,6 +1,6 @@
 openapi: 3.0.3
 info:
-  version: 0.1.85
+  version: 0.1.86
   title: Blockfrost.io ~ API Documentation
   x-logo:
     url: 'https://staging.blockfrost.io/images/logo.svg'
@@ -8724,6 +8724,10 @@ components:
           type: boolean
           example: true
           description: True if contract script passed validation
+        treasury_donation:
+          type: string
+          example: '0'
+          description: Treasury donation in Lovelaces
       required:
         - hash
         - block
@@ -8747,6 +8751,7 @@ components:
         - asset_mint_or_burn_count
         - redeemer_count
         - valid_contract
+        - treasury_donation
     tx_content_utxo:
       type: object
       properties:
@@ -9454,20 +9459,40 @@ components:
           pool_id:
             type: string
             description: Bech32 ID of pool being delegated to
+          tx_slot:
+            type: integer
+            description: Slot of the transaction containing the delegation
+          block_time:
+            type: integer
+            description: >-
+              Block creation time in UNIX time of the transaction containing the
+              delegation
+          block_height:
+            type: integer
+            description: Block height of the transaction containing the delegation
         required:
           - active_epoch
           - tx_hash
           - amount
           - pool_id
+          - tx_slot
+          - block_time
+          - block_height
       example:
         - active_epoch: 210
           tx_hash: 2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531
           amount: '12695385'
           pool_id: pool1pu5jlj4q9w9jlxeu370a3c9myx47md5j5m2str0naunn2q3lkdy
+          tx_slot: 45093580
+          block_time: 1646437200
+          block_height: 6745358
         - active_epoch: 242
           tx_hash: 1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dde628516157f0
           amount: '12691385'
           pool_id: pool1kchver88u3kygsak8wgll7htr8uxn5v35lfrsyy842nkscrzyvj
+          tx_slot: 48093580
+          block_time: 1649033600
+          block_height: 7126896
     account_registration_content:
       type: array
       items:
@@ -9484,14 +9509,38 @@ components:
               - registered
               - deregistered
             description: Action in the certificate
+          tx_slot:
+            type: integer
+            description: >-
+              Slot of the transaction containing the (de)registration
+              certificate
+          block_time:
+            type: integer
+            description: >-
+              Block creation time in UNIX time of the transaction containing the
+              (de)registration certificate
+          block_height:
+            type: integer
+            description: >-
+              Block height of the transaction containing the (de)registration
+              certificate
         required:
           - tx_hash
           - action
+          - tx_slot
+          - block_time
+          - block_height
       example:
         - tx_hash: 2dd15e0ef6e6a17841cb9541c27724072ce4d4b79b91e58432fbaa32d9572531
           action: registered
+          tx_slot: 45093580
+          block_time: 1646437200
+          block_height: 6745358
         - tx_hash: 1a0570af966fb355a7160e4f82d5a80b8681b7955f5d44bec0dde628516157f0
           action: deregistered
+          tx_slot: 48093580
+          block_time: 1649033600
+          block_height: 7126896
     account_withdrawal_content:
       type: array
       items:
@@ -9503,14 +9552,34 @@ components:
           amount:
             type: string
             description: Withdrawal amount in Lovelaces
+          tx_slot:
+            type: integer
+            description: Slot of the transaction containing the withdrawal
+          block_time:
+            type: integer
+            description: >-
+              Block creation time in UNIX time of the transaction containing the
+              withdrawal
+          block_height:
+            type: integer
+            description: Block height of the transaction containing the withdrawal
         required:
           - tx_hash
           - amount
+          - tx_slot
+          - block_time
+          - block_height
       example:
         - tx_hash: 48a9625c841eea0dd2bb6cf551eabe6523b7290c9ce34be74eedef2dd8f7ecc5
           amount: '454541212442'
+          tx_slot: 45093580
+          block_time: 1646437200
+          block_height: 6745358
         - tx_hash: 4230b0cbccf6f449f0847d8ad1d634a7a49df60d8c142bb8cc2dbc8ca03d9e34
           amount: '97846969'
+          tx_slot: 48093580
+          block_time: 1649033600
+          block_height: 7126896
     account_mir_content:
       type: array
       items:
@@ -9522,14 +9591,34 @@ components:
           amount:
             type: string
             description: MIR amount in Lovelaces
+          tx_slot:
+            type: integer
+            description: Slot of the transaction containing the MIR
+          block_time:
+            type: integer
+            description: >-
+              Block creation time in UNIX time of the transaction containing the
+              MIR
+          block_height:
+            type: integer
+            description: Block height of the transaction containing the MIR
         required:
           - tx_hash
           - amount
+          - tx_slot
+          - block_time
+          - block_height
       example:
         - tx_hash: 69705bba1d687a816ff5a04ec0c358a1f1ef075ab7f9c6cc2763e792581cec6d
           amount: '2193707473'
+          tx_slot: 45093580
+          block_time: 1646437200
+          block_height: 6745358
         - tx_hash: baaa77b63d4d7d2bb3ab02c9b85978c2092c336dede7f59e31ad65452d510c13
           amount: '14520198574'
+          tx_slot: 48093580
+          block_time: 1649033600
+          block_height: 7126896
     account_addresses_content:
       type: array
       items: