commissionRate() added

Author: yzh-pelle

php-binance-api.php

@@ -3623,6 +3623,27 @@ public function allocations(string $symbol, ?int $startTime = null, ?int $endTim
         return $this->apiRequest("v3/myAllocations", 'GET', array_merge($request, $params), true);
     }
 
+    /**
+     * commissionRate - Get the commission rate for a symbol
+     *
+     * @link https://developers.binance.com/docs/binance-spot-api-docs/rest-api/account-endpoints#query-commission-rates-user_data
+     *
+     * @property int $weight 20
+     *
+     * @param string $symbol (mandatory) The symbol, e.g. BTCUSDT
+     * @param array  $params (optional) An array of additional parameters that the API endpoint allows
+     *
+     * @return array with error message or the rate limit details
+     * @throws \Exception
+     */
+    public function commissionRate(string $symbol, array $params = []) {
+        $request = [
+            'symbol' => $symbol,
+        ];
+
+        return $this->apiRequest("v3/account/commission", 'GET', array_merge($request, $params), true);
+    }
+
     /**
      * ocoOrder - Create a new OCO order
      *

tests/BinanceLiveTests.php

@@ -431,6 +431,48 @@ public function testPreventedMatchesSpot()
         $this->assertIsArray($res);
     }
 
+    public function testCommissionRateSpot()
+    {
+        $res = $this->spotBinance->commissionRate($this->symbol);
+        $this->assertIsArray($res);
+        $this->assertArrayHasKey('symbol', $res);
+        $this->assertEquals($this->symbol, $res['symbol']);
+        $this->assertArrayHasKey('standardCommission', $res);
+
+        $standardCommission = $res['standardCommission'];
+        $this->assertIsArray($standardCommission);
+        $this->assertArrayHasKey('maker', $standardCommission);
+        $this->assertIsNumeric($standardCommission['maker']);
+        $this->assertArrayHasKey('taker', $standardCommission);
+        $this->assertIsNumeric($standardCommission['taker']);
+        $this->assertArrayHasKey('buyer', $standardCommission);
+        $this->assertIsNumeric($standardCommission['buyer']);
+        $this->assertArrayHasKey('seller', $standardCommission);
+        $this->assertIsNumeric($standardCommission['seller']);
+
+        $this->assertArrayHasKey('taxCommission', $res);
+        $taxCommission = $res['taxCommission'];
+        $this->assertIsArray($taxCommission);
+        $this->assertArrayHasKey('maker', $taxCommission);
+        $this->assertIsNumeric($taxCommission['maker']);
+        $this->assertArrayHasKey('taker', $taxCommission);
+        $this->assertIsNumeric($taxCommission['taker']);
+        $this->assertArrayHasKey('buyer', $taxCommission);
+        $this->assertIsNumeric($taxCommission['buyer']);
+        $this->assertArrayHasKey('seller', $taxCommission);
+
+        $this->assertArrayHasKey('discount', $res);
+        $discount = $res['discount'];
+        $this->assertIsArray($discount);
+        $this->assertArrayHasKey('enabledForAccount', $discount);
+        $this->assertIsBool($discount['enabledForAccount']);
+        $this->assertArrayHasKey('enabledForSymbol', $discount);
+        $this->assertIsBool($discount['enabledForSymbol']);
+        $this->assertArrayHasKey('discountAsset', $discount);
+        $this->assertArrayHasKey('discount', $discount);
+        $this->assertIsNumeric($discount['discount']);
+    }
+
     public function testAllocationsSpot()
     {
         $res = $this->spotBinance->allocations($this->symbol);

tests/BinanceStaticTests.php

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