orderAmendments() added

Author: yzh-pelle

php-binance-api.php

@@ -3644,6 +3644,38 @@ public function commissionRate(string $symbol, array $params = []) {
         return $this->apiRequest("v3/account/commission", 'GET', array_merge($request, $params), true);
     }
 
+    /**
+     * orderAmendments - Get all amendments of a single order
+     *
+     * @link https://developers.binance.com/docs/binance-spot-api-docs/rest-api/account-endpoints#query-order-amendments-user_data
+     *
+     * @property int $weight 4
+     *
+     * @param string $symbol (mandatory) The symbol, e.g. BTCUSDT
+     * @param string $orderId (mandatory) The ID of the order
+     * @param string $fromExecutionId (optional) The ID of the execution to start from
+     * @param int    $limit (optional) The number of results to return (default is 500, max is 1000)
+     *
+     * @return array with error message or the rate limit details
+     * @throws \Exception
+     */
+    public function orderAmendments(string $symbol, string $orderId, ?string $fromExecutionId = null, ?int $limit = null, array $params = []) {
+        $request = [
+            'symbol' => $symbol,
+            'orderId' => $orderId,
+        ];
+
+        if ($fromExecutionId) {
+            $request['fromExecutionId'] = $fromExecutionId;
+        }
+
+        if (!is_null($limit)) {
+            $request['limit'] = $limit;
+        }
+
+        return $this->apiRequest("v3/order/amendments", 'GET', array_merge($request, $params), true);
+    }
+
     /**
      * ocoOrder - Create a new OCO order
      *

tests/BinanceStaticTests.php

@@ -1167,7 +1167,24 @@ public function testCommissionRate()
         parse_str($queryString, $params);
 
         $this->assertEquals($this->symbol, $params['symbol']);
+    }
+
+    public function testOrderAmendments()
+    {
+        try  {
+            $this->binance->orderAmendments($this->symbol, $this->orderId);
+
+        } catch (\Throwable $e) {
+
+        }
+        $endpoint = "https://api.binance.com/api/v3/order/amendments?";
+        $this->assertTrue(str_starts_with(self::$capturedUrl, $endpoint));
 
+        $queryString = substr(self::$capturedUrl, strlen($endpoint));
+        parse_str($queryString, $params);
+
+        $this->assertEquals($this->symbol, $params['symbol']);
+        $this->assertEquals($this->orderId, $params['orderId']);
     }
 
     public function testFuturesAccountSnapshot()