diff --git a/docs/developers/developer-reference/sc-api-functions.md b/docs/developers/developer-reference/sc-api-functions.md
index 7be2f486a..c83cb7c3d 100644
--- a/docs/developers/developer-reference/sc-api-functions.md
+++ b/docs/developers/developer-reference/sc-api-functions.md
@@ -146,6 +146,8 @@ A smart contract call that runs out of gas will revert all operations, so this f
 get_block_timestamp() -> u64
 ```
 
+Returns the timestamp of the current block, in seconds (UNIX timestamp).
+
 [comment]: # (mx-context-auto)
 
 ### get_block_nonce
@@ -154,6 +156,8 @@ get_block_timestamp() -> u64
 get_block_nonce() -> u64
 ```
 
+Returns the unique nonce of the block that includes the current transaction.
+
 [comment]: # (mx-context-auto)
 
 ### get_block_round
@@ -162,6 +166,8 @@ get_block_nonce() -> u64
 get_block_round() -> u64
 ```
 
+Returns the round number of the current block. Each epoch consists of a fixed number of rounds. The round number resets to 1 at the start of every new epoch.
+
 [comment]: # (mx-context-auto)
 
 ### get_block_epoch
@@ -170,6 +176,8 @@ get_block_round() -> u64
 get_block_epoch() -> u64
 ```
 
+Returns the epoch of the current block. 
+
 These functions are mostly used for setting up deadlines, so they've been grouped together.
 
 [comment]: # (mx-context-auto)