diff --git a/README.md b/README.md
index 09016fc..12b9a4b 100644
--- a/README.md
+++ b/README.md
@@ -659,3 +659,96 @@ Reassociate records (switch bond):
 ```bash
 laconic registry bond records reassociate --old-bond-id 5c40abd336ae1561f2a1b55be73b12f5a083080bf879b4c9288d182d238badb0 --new-bond-id 3e11c61f179897e4b12e9b63de35d36f88ac146755e7a28ce0bcdd07cf3a03ae
 ```
+
+Create `provider` auction:
+
+```bash
+$ laconic registry auction create --kind provider --commits-duration 60 --reveals-duration 60 --commit-fee 1000 --reveal-fee 1000 --max-price 100000 --num-providers 3
+
+{"auctionId":"73c5fa4b91bb973641ccbb6901a8404745fb8793c95485b00d5a791e6b6c1630"}
+```
+
+Commit an auction bid:
+
+```bash
+$ laconic registry auction bid commit 73c5fa4b91bb973641ccbb6901a8404745fb8793c95485b00d5a791e6b6c1630 25000000 alnt
+
+{"reveal_file":"/home/isha/office/laconic-registry-cli/out/bafyreiai5upey4562ont54pe7m3buiphtd6n3q2vr5lxdcj3gpyklbbgvy.json"}
+```
+
+Reveal an auction bid:
+
+```bash
+$ laconic registry auction bid reveal b66b74048fc360de6a926123b760e6485276d90ad2274b5386c02664cd04bace ./out/bafyreifjkhiakayvvaasnsw7ufaax54ncow4xuycqnox7hxay34c6yod7a.json
+
+{"success": true}
+```
+
+Check the auction state on completion:
+
+```bash
+laconic registry auction get b66b74048fc360de6a926123b760e6485276d90ad2274b5386c02664cd04bace
+
+[
+  {
+    "id": "b66b74048fc360de6a926123b760e6485276d90ad2274b5386c02664cd04bace",
+    "kind": "vickrey",
+    "status": "completed",
+    "ownerAddress": "laconic13qrlfkgl02wgwpw0n4j8kswygwnukphy92249r",
+    "createTime": "2024-09-17T09:51:48.605610628",
+    "commitsEndTime": "2024-09-17T09:52:48.605610628",
+    "revealsEndTime": "2024-09-17T09:53:48.605610628",
+    "commitFee": {
+      "type": "alnt",
+      "quantity": 1000
+    },
+    "revealFee": {
+      "type": "alnt",
+      "quantity": 1000
+    },
+    "minimumBid": {
+      "type": "alnt",
+      "quantity": 1000000
+    },
+    "winnerAddresses": [
+      "laconic13qrlfkgl02wgwpw0n4j8kswygwnukphy92249r"
+    ],
+    "winnerBids": [
+      {
+        "type": "alnt",
+        "quantity": 25000000
+      }
+    ],
+    "winnerPrice": {
+      "type": "alnt",
+      "quantity": 25000000
+    },
+    "maxPrice": {
+      "type": "",
+      "quantity": 0
+    },
+    "numProviders": 0,
+    "bids": [
+      {
+        "bidderAddress": "laconic13qrlfkgl02wgwpw0n4j8kswygwnukphy92249r",
+        "status": "reveal",
+        "commitHash": "bafyreifjkhiakayvvaasnsw7ufaax54ncow4xuycqnox7hxay34c6yod7a",
+        "commitTime": "2024-09-17T09:52:03.665761945",
+        "revealTime": "2024-09-17T09:53:00.904061323",
+        "commitFee": {
+          "type": "alnt",
+          "quantity": 1000
+        },
+        "revealFee": {
+          "type": "alnt",
+          "quantity": 1000
+        },
+        "bidAmount": {
+          "type": "alnt",
+          "quantity": 25000000
+        }
+      }
+    ]
+  }
+]
+```