feedex/coinex

Coinex PHP API wrapper - based on the Coinex official documents.

v1.0.0 2026-03-28 13:18 UTC

Requires

• php: ^8.4
• feedex/feedex: ^1.0
• guzzlehttp/guzzle: ^7.9

Requires (Dev)

• phpstan/phpstan: ^2.0
• phpunit/phpunit: ^11.0

MIT

• coinex
• Coinex PHP API

README

CoinEx adapter package for the Feedex ecosystem.

This package implements CoinEx API v2 modules and plugs into feedex/feedex via factory registration.

Installation

composer require feedex/feedex feedex/coinex

Compatibility

• feedex/coinex ^1.0 requires feedex/feedex ^1.0

Usage (recommended via Feedex core)

use Feedex\Feedex;
use Feedex\Coinex\v2\CoinexFactory;

$feedex = (new Feedex())
    ->register(new CoinexFactory());

$coinex = $feedex->exchange('coinex', [
    'access_id' => getenv('COINEX_ACCESS_ID'),
    'secret_key' => getenv('COINEX_SECRET_KEY'),
    // optional:
    // 'base_url' => 'https://api.coinex.com',
    // 'timeout' => 60,
]);

$markets = $coinex->spotMarket()->listMarkets();
$balance = $coinex->asset()->getSpotBalance();

Direct usage (without registry)

use Feedex\Coinex\v2\Coinex;

$coinex = new Coinex(
    accessId: getenv('COINEX_ACCESS_ID'),
    secretKey: getenv('COINEX_SECRET_KEY')
);

$tickers = $coinex->spotMarket()->listMarketTicker();

Examples

See runnable scripts in examples/:

• examples/balances.php
• examples/spot_order.php
• examples/futures_order.php

Endpoint coverage table

Domain	Visibility	Endpoints	Status
Common	Public	3	✅ Implemented
Account	Private	2	✅ Implemented
Asset	Private	4	✅ Implemented
Account Sub	Private	14	✅ Implemented
Asset Transfer	Private	2	✅ Implemented
Asset Deposit/Withdrawal	Private	9	✅ Implemented
Asset Loan	Private	4	✅ Implemented
Spot Market	Public	6	✅ Implemented
Spot Order	Private	20	✅ Implemented
Spot Deal	Private	2	✅ Implemented
Futures Market	Public	12	✅ Implemented
Futures Order	Private	20	✅ Implemented
Futures Deal	Private	2	✅ Implemented
Futures Position	Private	15	✅ Implemented
Total		115	✅

Coverage reflects the adapter’s currently exposed CoinEx v2 modules/methods.

Implemented modules (detailed)

Common (public)

• ping()
• time()
• maintainInfo()

Account (private)

• getAccountInfo()
• getTradeFeeRate()

Asset (private)

• getSpotBalance()
• getFuturesBalance()
• getMarginBalance()
• getFinancialBalance()

Account Sub (private)

• createSub()
• listSub()
• getSubInfo()
• frozenSub()
• cancelFrozenSub()
• createSubApi()
• listSubApi()
• getSubApi()
• editSubApi()
• deleteSubApi()
• getSubBalance()
• getSubSpotBalance()
• subTransfer()
• listSubTransferHistory()

Asset Transfer (private)

• transfer()
• listTransferHistory()

Asset Deposit/Withdrawal (private)

• listAssetsInfo()
• getDepositAddress()
• updateDepositAddress()
• getDepositWithdrawalConfig()
• listAllDepositWithdrawalConfig()
• listDepositHistory()
• listWithdrawalHistory()
• withdrawal()
• cancelWithdrawal()

Asset Loan (private)

• marginBorrow()
• marginRepay()
• listMarginBorrowHistory()
• listMarginInterestLimit()

Spot Market (public)

• listMarkets()
• listMarketTicker()
• listMarketDepth()
• listMarketDeals()
• listMarketKline()
• listMarketIndex()

Spot Order (private)

• putOrder()
• putBatchOrder()
• putStopOrder()
• putBatchStopOrder()
• editOrder()
• editBatchOrder()
• editStopOrder()
• cancelOrder()
• cancelOrderByClientId()
• cancelBatchOrder()
• cancelAllOrder()
• cancelStopOrder()
• cancelStopOrderByClientId()
• cancelBatchStopOrder()
• getOrderStatus()
• getBatchOrderStatus()
• listPendingOrder()
• listFinishedOrder()
• listPendingStopOrder()
• listFinishedStopOrder()

Spot Deal (private)

• listUserDeals()
• listUserOrderDeals()

Futures Market (public)

• listMarkets()
• listMarketTicker()
• listMarketDepth()
• listMarketDeals()
• listMarketKline()
• listMarketIndex()
• listMarketFundingRate()
• listMarketFundingRateHistory()
• listMarketBasisHistory()
• listMarketLiquidationHistory()
• listMarketPositionLevel()
• listMarketPremiumHistory()

Futures Order (private)

• putOrder()
• putBatchOrder()
• putStopOrder()
• putBatchStopOrder()
• editOrder()
• editBatchOrder()
• editStopOrder()
• cancelOrder()
• cancelOrderByClientId()
• cancelBatchOrder()
• cancelAllOrder()
• cancelStopOrder()
• cancelStopOrderByClientId()
• cancelBatchStopOrder()
• getOrderStatus()
• getBatchOrderStatus()
• listPendingOrder()
• listFinishedOrder()
• listPendingStopOrder()
• listFinishedStopOrder()

Futures Deal (private)

• listUserDeals()
• listUserOrderDeals()

Futures Position (private)

• closePosition()
• adjustPositionMargin()
• adjustPositionLeverage()
• setPositionStopLoss()
• setPositionTakeProfit()
• modifyPositionStopLoss()
• modifyPositionTakeProfit()
• cancelPositionStopLoss()
• cancelPositionTakeProfit()
• listPendingPosition()
• listFinishedPosition()
• listPositionMarginHistory()
• listPositionFundingHistory()
• listPositionAdlHistory()
• listPositionSettleHistory()

Authentication notes

CoinEx v2 signature format used by this adapter:

METHOD + request_path(+query_string) + body + timestamp

Request headers:

• X-COINEX-KEY
• X-COINEX-SIGN
• X-COINEX-TIMESTAMP

Quality architecture additions

Lightweight payload builders/validators

Available for complex order calls:

• Feedex\Coinex\v2\Payload\SpotOrderPayload
• Feedex\Coinex\v2\Payload\FuturesOrderPayload

These provide reusable payload construction and basic required-key validation without heavy abstraction.

Typed error model

The HTTP layer maps failures into typed exceptions:

• CoinexAuthenticationException
• CoinexRateLimitException
• CoinexValidationException
• CoinexTransientException
• fallback: CoinexRequestException

Optional retry/backoff (disabled by default)

You can configure retries through factory config:

• max_retries (default 0)
• retry_delay_ms (default 100)
• retry_backoff_multiplier (default 2.0)

Example:

$coinex = $feedex->exchange('coinex', [
    'access_id' => 'xxx',
    'secret_key' => 'yyy',
    'max_retries' => 2,
    'retry_delay_ms' => 150,
    'retry_backoff_multiplier' => 2.0,
]);

Core architecture integration

This adapter provides:

• Feedex\Coinex\v2\Coinex implementing Feedex exchange/capability contracts
• Feedex\Coinex\v2\CoinexFactory implementing ExchangeFactoryInterface

v1.0.0 scope freeze (coinex)

For the first stable adapter release, the v1 scope is frozen to:

• current implemented CoinEx v2 module surface documented in this README
• current typed error model and optional retry/backoff behavior
• current payload builder helpers for spot/futures order flows

Out of scope for coinex v1.0.0:

• websocket/streaming APIs
• breaking renames of public module methods
• exchange-wide DTO normalization layer

Changelog

See CHANGELOG.md for clear per-release evolution of this plugin.

License

MIT