Add getHistoryPositions and getHistoryTrades endpoints to Futures API

change version to 1.2.2
change version to 1.2.1
2026-04-12 19:32:14 +02:00 · 2026-04-11 23:43:37 +02:00 · 2026-04-11 23:41:23 +02:00 · 2026-04-11 23:40:26 +02:00 · 2026-04-11 16:20:35 +02:00 · 2026-01-05 21:36:58 +00:00
8 changed files with 150 additions and 10 deletions
@@ -14,7 +14,7 @@ jobs:

      - name: Dependabot metadata
        id: metadata
-        uses: dependabot/fetch-metadata@v2.4.0
+        uses: dependabot/fetch-metadata@v2.5.0
        with:
          github-token: "${{ secrets.GITHUB_TOKEN }}"

@@ -23,6 +23,6 @@ jobs:
        uses: aglipanci/laravel-pint-action@2.6

      - name: Commit changes
-        uses: stefanzweifel/git-auto-commit-action@v6
+        uses: stefanzweifel/git-auto-commit-action@v7
        with:
          commit_message: Fix styling
@@ -2,6 +2,15 @@

 A Laravel package for interacting with the Bitunix cryptocurrency exchange API.

+---
+
+[![Latest Stable Version](https://poser.pugx.org/mahdimsr/laravel-bitunix-api/v/stable)](https://packagist.org/packages/msr/laravel-bitunix-api)
+[![Fix PHP code style issues](https://github.com/mahdimsr/laravel-bitunix-api/actions/workflows/fix-php-code-style-issues.yml/badge.svg)](https://github.com/mahdimsr/laravel-bitunix-api/actions/workflows/fix-php-code-style-issues.yml)
+[![PHPStan](https://github.com/mahdimsr/laravel-bitunix-api/actions/workflows/phpstan.yml/badge.svg)](https://github.com/mahdimsr/laravel-bitunix-api/actions/workflows/phpstan.yml)
+[![run-tests](https://github.com/mahdimsr/laravel-bitunix-api/actions/workflows/run-tests.yml/badge.svg)](https://github.com/mahdimsr/laravel-bitunix-api/actions/workflows/run-tests.yml)
+[![License](https://poser.pugx.org/mahdimsr/laravel-bitunix-api/license)](https://packagist.org/packages/msr/laravel-bitunix-api)
+
+
 ## Installation

 ```bash
@@ -1,5 +1,5 @@
 {
-    "name": "mahdimsr/laravel-bitunix-api",
+    "name": "moltox/laravel-bitunix-api",
    "description": "composer package for using bitunix api trading",
    "keywords": [
        "msr",
@@ -13,12 +13,17 @@
            "name": "mahdi mansouri",
            "email": "mahdi.msr4@gmail.com",
            "role": "Developer"
+        },
+        {
+            "name": "Maik Mueller   ",
+            "email": "mueller.maik1@gmail.com",
+            "role": "Developer"
        }
    ],
    "require": {
        "php": "^8.4",
        "spatie/laravel-package-tools": "^1.16",
-        "illuminate/contracts": "^11.0||^12.0||^10.0"
+        "illuminate/contracts": "^10.0||^11.0||^12.0||^13.0"
    },
    "require-dev": {
        "laravel/pint": "^1.14",
@@ -69,7 +74,7 @@
            }
        }
    },
-    "version": "1.1.0",
+    "version": "1.2.2",
    "minimum-stability": "stable",
    "prefer-stable": true
 }
@@ -3,10 +3,13 @@
 namespace Msr\LaravelBitunixApi;

 use GuzzleHttp\Client;
+use GuzzleHttp\Exception\GuzzleException;
 use Msr\LaravelBitunixApi\Requests\ChangeLeverageRequestContract;
 use Msr\LaravelBitunixApi\Requests\ChangeMarginModeRequestContract;
 use Msr\LaravelBitunixApi\Requests\FlashClosePositionRequestContract;
 use Msr\LaravelBitunixApi\Requests\FutureKLineRequestContract;
+use Msr\LaravelBitunixApi\Requests\GetHistoryPositionsRequestContract;
+use Msr\LaravelBitunixApi\Requests\GetHistoryTradesRequestContract;
 use Msr\LaravelBitunixApi\Requests\GetPendingPositionsRequestContract;
 use Msr\LaravelBitunixApi\Requests\GetSingleAccountRequestContract;
 use Msr\LaravelBitunixApi\Requests\GetTradingPairsRequestContract;
@@ -16,14 +19,19 @@ use Msr\LaravelBitunixApi\Requests\PlacePositionTpSlOrderRequestContract;
 use Msr\LaravelBitunixApi\Requests\PlaceTpSlOrderRequestContract;
 use Psr\Http\Message\ResponseInterface;

-class LaravelBitunixApi implements ChangeLeverageRequestContract, ChangeMarginModeRequestContract, FlashClosePositionRequestContract, FutureKLineRequestContract, GetPendingPositionsRequestContract, GetSingleAccountRequestContract, GetTradingPairsRequestContract, PlaceOrderRequestContract, PlacePositionTpSlOrderRequestContract, PlaceTpSlOrderRequestContract
+class LaravelBitunixApi implements ChangeLeverageRequestContract, ChangeMarginModeRequestContract,
+                                   FlashClosePositionRequestContract, FutureKLineRequestContract,
+                                   GetPendingPositionsRequestContract, GetSingleAccountRequestContract,
+                                   GetTradingPairsRequestContract, PlaceOrderRequestContract,
+                                   PlacePositionTpSlOrderRequestContract, PlaceTpSlOrderRequestContract,
+                                   GetHistoryPositionsRequestContract, GetHistoryTradesRequestContract
 {
    private Client $publicFutureClient;

    public function __construct()
    {
        $this->publicFutureClient = new Client([
-            'base_uri' => config('bitunix-api.future_base_uri').'/api/v1/futures/market/',
+            'base_uri' => config('bitunix-api.future_base_uri') . '/api/v1/futures/market/',
        ]);
    }

@@ -33,13 +41,19 @@ class LaravelBitunixApi implements ChangeLeverageRequestContract, ChangeMarginMo
        $headers = Header::generateHeaders($queryParams, $bodyString);

        return new Client([
-            'base_uri' => config('bitunix-api.future_base_uri').'/api/v1/futures/',
+            'base_uri' => config('bitunix-api.future_base_uri') . '/api/v1/futures/',
            'headers' => $headers,
        ]);
    }

-    public function getFutureKline(string $symbol, string $interval, int $limit = 100, ?int $startTime = null, ?int $endTime = null, string $type = 'LAST_PRICE'): ResponseInterface
-    {
+    public function getFutureKline(
+        string $symbol,
+        string $interval,
+        int $limit = 100,
+        ?int $startTime = null,
+        ?int $endTime = null,
+        string $type = 'LAST_PRICE'
+    ): ResponseInterface {
        $response = $this->publicFutureClient->get('kline', [
            'query' => [
                'symbol' => $symbol,
@@ -188,6 +202,48 @@ class LaravelBitunixApi implements ChangeLeverageRequestContract, ChangeMarginMo
        return $response;
    }

+    public function getHistoryTrades(
+        ?string $symbol = null,
+        ?string $orderId = null,
+        ?string $positionId = null,
+        ?int $startTime = null,
+        ?int $endTime = null,
+        int $skip = 0,
+        int $limit = 100
+    ): ResponseInterface {
+        $queryParams = [
+            'skip' => $skip,
+            'limit' => $limit,
+        ];
+
+        if ($symbol !== null) {
+            $queryParams['symbol'] = $symbol;
+        }
+
+        if ($orderId !== null) {
+            $queryParams['orderId'] = $orderId;
+        }
+
+        if ($positionId !== null) {
+            $queryParams['positionId'] = $positionId;
+        }
+
+        if ($startTime !== null) {
+            $queryParams['startTime'] = $startTime;
+        }
+
+        if ($endTime !== null) {
+            $queryParams['endTime'] = $endTime;
+        }
+
+        $response = $this->getPrivateFutureClient($queryParams, [])->get('trade/get_history_trades', [
+            'query' => $queryParams,
+        ]);
+
+        return $response;
+    }
+
+
    public function getPendingPositions(?string $symbol = null, ?string $positionId = null): ResponseInterface
    {
        $queryParams = [];
@@ -207,6 +263,38 @@ class LaravelBitunixApi implements ChangeLeverageRequestContract, ChangeMarginMo
        return $response;
    }

+    /**
+     * @throws GuzzleException
+     */
+    public function getHistoryPositions(
+        ?string $symbol = null,
+        ?int $startTime = null,
+        ?int $endTime = null,
+        int $skip = 0,
+        int $limit = 100
+    ): ResponseInterface {
+        $queryParams = [
+            'skip' => $skip,
+            'limit' => $limit,
+        ];
+
+        if ($symbol !== null) {
+            $queryParams['symbol'] = $symbol;
+        }
+
+        if ($startTime !== null) {
+            $queryParams['startTime'] = $startTime;
+        }
+
+        if ($endTime !== null) {
+            $queryParams['endTime'] = $endTime;
+        }
+
+        return $this->getPrivateFutureClient($queryParams, [])->get('position/get_history_positions', [
+            'query' => $queryParams,
+        ]);
+    }
+
    public function getSingleAccount(string $marginCoin): ResponseInterface
    {
        $queryParams = [
@@ -7,6 +7,8 @@ use Msr\LaravelBitunixApi\Requests\ChangeLeverageRequestContract;
 use Msr\LaravelBitunixApi\Requests\ChangeMarginModeRequestContract;
 use Msr\LaravelBitunixApi\Requests\FlashClosePositionRequestContract;
 use Msr\LaravelBitunixApi\Requests\FutureKLineRequestContract;
+use Msr\LaravelBitunixApi\Requests\GetHistoryPositionsRequestContract;
+use Msr\LaravelBitunixApi\Requests\GetHistoryTradesRequestContract;
 use Msr\LaravelBitunixApi\Requests\GetPendingPositionsRequestContract;
 use Msr\LaravelBitunixApi\Requests\GetSingleAccountRequestContract;
 use Msr\LaravelBitunixApi\Requests\GetTradingPairsRequestContract;
@@ -47,5 +49,7 @@ class LaravelBitunixApiServiceProvider extends PackageServiceProvider
        $this->app->bind(PlaceTpSlOrderRequestContract::class, LaravelBitunixApi::class);
        $this->app->bind(PlacePositionTpSlOrderRequestContract::class, LaravelBitunixApi::class);
        $this->app->bind(GetTradingPairsRequestContract::class, LaravelBitunixApi::class);
+        $this->app->bind(GetHistoryTradesRequestContract::class, LaravelBitunixApi::class);
+        $this->app->bind(GetHistoryPositionsRequestContract::class, LaravelBitunixApi::class);
    }
 }
@@ -0,0 +1,16 @@
+<?php
+
+namespace Msr\LaravelBitunixApi\Requests;
+
+use Psr\Http\Message\ResponseInterface;
+
+interface GetHistoryPositionsRequestContract
+{
+    public function getHistoryPositions(
+        ?string $symbol = null,
+        ?int $startTime = null,
+        ?int $endTime = null,
+        int $skip = 0,
+        int $limit = 100
+    ): ResponseInterface;
+}
@@ -0,0 +1,18 @@
+<?php
+
+namespace Msr\LaravelBitunixApi\Requests;
+
+use Psr\Http\Message\ResponseInterface;
+
+interface GetHistoryTradesRequestContract
+{
+    public function getHistoryTrades(
+        ?string $symbol = null,
+        ?string $orderId = null,
+        ?string $positionId = null,
+        ?int $startTime = null,
+        ?int $endTime = null,
+        int $skip = 0,
+        int $limit = 100
+    ): ResponseInterface;
+}
Author	SHA1	Message	Date
mis_mueller	6730ac8ada	Add getHistoryPositions and getHistoryTrades endpoints to Futures API	2026-04-12 19:32:14 +02:00
mis_mueller	289101215d	change version to 1.2.2	2026-04-11 23:43:37 +02:00
mis_mueller	a24caddba5	change version to 1.2.1	2026-04-11 23:41:23 +02:00
mis_mueller	96ee83d67a	change version to 1.2.0	2026-04-11 23:40:26 +02:00
mis_mueller	71c2d17fa3	Change structure.	2026-04-11 16:20:35 +02:00
github-actions[bot]	a4a5280bab	Merge pull request #13 from mahdimsr/dependabot/github_actions/dependabot/fetch-metadata-2.5.0 build(deps): bump dependabot/fetch-metadata from 2.4.0 to 2.5.0	2026-01-05 21:36:58 +00:00
dependabot[bot]	a1048d5f5c	build(deps): bump dependabot/fetch-metadata from 2.4.0 to 2.5.0 Bumps [dependabot/fetch-metadata](https://github.com/dependabot/fetch-metadata) from 2.4.0 to 2.5.0. - [Release notes](https://github.com/dependabot/fetch-metadata/releases) - [Commits](https://github.com/dependabot/fetch-metadata/compare/v2.4.0...v2.5.0) --- updated-dependencies: - dependency-name: dependabot/fetch-metadata dependency-version: 2.5.0 dependency-type: direct:production update-type: version-update:semver-minor ... Signed-off-by: dependabot[bot] <support@github.com>	2026-01-05 21:36:45 +00:00
mahdi mansouri	21e94df5ff	Merge pull request #11 from mahdimsr/dev dev: match composer version with release tag	2025-11-23 16:07:53 +03:30
mahdi mansouri	ad9acbd410	Merge pull request #8 from mahdimsr/dependabot/github_actions/stefanzweifel/git-auto-commit-action-7 build(deps): bump stefanzweifel/git-auto-commit-action from 6 to 7	2025-11-23 16:05:55 +03:30
mahdi msr	8e5b631dc7	main: match composer version with release tag	2025-11-23 16:03:04 +03:30
mahdi mansouri	4ce40bd4c8	Merge pull request #10 from mahdimsr/dev Add get trading pair request	2025-11-23 15:54:23 +03:30
dependabot[bot]	b40852117f	build(deps): bump stefanzweifel/git-auto-commit-action from 6 to 7 Bumps [stefanzweifel/git-auto-commit-action](https://github.com/stefanzweifel/git-auto-commit-action) from 6 to 7. - [Release notes](https://github.com/stefanzweifel/git-auto-commit-action/releases) - [Changelog](https://github.com/stefanzweifel/git-auto-commit-action/blob/master/CHANGELOG.md) - [Commits](https://github.com/stefanzweifel/git-auto-commit-action/compare/v6...v7) --- updated-dependencies: - dependency-name: stefanzweifel/git-auto-commit-action dependency-version: '7' dependency-type: direct:production update-type: version-update:semver-major ... Signed-off-by: dependabot[bot] <support@github.com>	2025-10-13 21:39:46 +00:00
mahdi mansouri	67a9344d14	Merge pull request #7 from mahdimsr/dev Update README.md	2025-09-30 10:36:47 +03:30
mahdi mansouri	1c69e169f3	Update README.md	2025-09-29 04:41:47 +03:30