<?php

namespace ccxt;

// PLEASE DO NOT EDIT THIS FILE, IT IS GENERATED AND WILL BE OVERWRITTEN:

// https://github.com/ccxt/ccxt/blob/master/CONTRIBUTING.md#how-to-contribute-code

use Exception; // a common import

use ccxt\abstract\apex as Exchange;

class apex extends Exchange {

public function describe(): mixed {

return $this->deep_extend(parent::describe(), array(

'id' => 'apex',

'name' => 'Apex',

'countries' => array(),

'version' => 'v3',

'rateLimit' => 20, // 600 requests per minute, 10 request per second

'certified' => false,

'pro' => true,

'dex' => true,

'has' => array(

'CORS' => null,

'spot' => false,

'margin' => false,

'swap' => true,

'future' => false,

'option' => false,

'addMargin' => false,

'borrowCrossMargin' => false,

'borrowIsolatedMargin' => false,

'borrowMargin' => false,

'cancelAllOrders' => true,

'cancelAllOrdersAfter' => false,

'cancelOrder' => true,

'cancelOrders' => false,

'cancelOrdersForSymbols' => false,

'closeAllPositions' => false,

'closePosition' => false,

'createMarketBuyOrderWithCost' => false,

'createMarketOrderWithCost' => false,

'createMarketSellOrderWithCost' => false,

'createOrder' => true,

'createOrders' => false,

'createPostOnlyOrder' => true,

'createReduceOnlyOrder' => true,

'createStopOrder' => true,

'createTriggerOrder' => true,

'editOrder' => false,

'fetchAccounts' => false,

'fetchAllGreeks' => false,

'fetchBalance' => true,

'fetchBorrowInterest' => false,

'fetchBorrowRate' => false,

'fetchBorrowRateHistories' => false,

'fetchBorrowRateHistory' => false,

'fetchBorrowRates' => false,

'fetchBorrowRatesPerSymbol' => false,

'fetchCanceledAndClosedOrders' => false,

'fetchCanceledOrders' => false,

'fetchClosedOrders' => false,

'fetchCrossBorrowRate' => false,

'fetchCrossBorrowRates' => false,

'fetchCurrencies' => true,

'fetchDepositAddress' => false,

'fetchDepositAddresses' => false,

'fetchDeposits' => false,

'fetchDepositWithdrawFee' => false,

'fetchDepositWithdrawFees' => false,

'fetchFundingHistory' => true,

'fetchFundingRate' => false,

'fetchFundingRateHistory' => true,

'fetchFundingRates' => false,

'fetchGreeks' => false,

'fetchIndexOHLCV' => false,

'fetchIsolatedBorrowRate' => false,

'fetchIsolatedBorrowRates' => false,

'fetchLedger' => false,

'fetchLeverage' => false,

'fetchLeverageTiers' => false,

'fetchLiquidations' => false,

'fetchMarginMode' => false,

'fetchMarketLeverageTiers' => false,

'fetchMarkets' => true,

'fetchMarkOHLCV' => false,

'fetchMyLiquidations' => false,

'fetchMyTrades' => true,

'fetchOHLCV' => true,

'fetchOpenInterest' => true,

'fetchOpenInterestHistory' => false,

'fetchOpenInterests' => false,

'fetchOpenOrders' => true,

'fetchOption' => false,

'fetchOptionChain' => false,

'fetchOrder' => true,

'fetchOrderBook' => true,

'fetchOrders' => true,

'fetchOrderTrades' => true,

'fetchPosition' => false,

'fetchPositionMode' => false,

'fetchPositions' => true,

'fetchPositionsRisk' => false,

'fetchPremiumIndexOHLCV' => false,

'fetchTicker' => true,

'fetchTickers' => true,

'fetchTime' => true,

'fetchTrades' => true,

'fetchTradingFee' => false,

'fetchTradingFees' => false,

'fetchTransfer' => false,

'fetchTransfers' => false,

'fetchVolatilityHistory' => false,

'fetchWithdrawal' => false,

'fetchWithdrawals' => false,

'reduceMargin' => false,

'repayCrossMargin' => false,

'repayIsolatedMargin' => false,

'sandbox' => true,

'setLeverage' => true,

'setMarginMode' => false,

'setPositionMode' => false,

'transfer' => true,

'withdraw' => false,

),

'timeframes' => array(

'1m' => '1',

'5m' => '5',

'15m' => '15',

'30m' => '30',

'1h' => '60',

'2h' => '120',

'4h' => '240',

'6h' => '360',

'12h' => '720',

'1d' => 'D',

'1w' => 'W',

'1M' => 'M',

),

'hostname' => 'omni.apex.exchange',

'urls' => array(

'logo' => 'https://github.com/user-attachments/assets/8ba7fbfa-0dd0-4ab9-8b72-ff60abe08ac6',

'api' => array(

'public' => 'https://{hostname}/api',

'private' => 'https://{hostname}/api',

),

'test' => array(

'public' => 'https://testnet.omni.apex.exchange/api',

'private' => 'https://testnet.omni.apex.exchange/api',

),

'www' => 'https://apex.exchange/',

'doc' => 'https://api-docs.omni.apex.exchange',

'fees' => 'https://apex-pro.gitbook.io/apex-pro/apex-omni-live-now/trading-perpetual-contracts/trading-fees',

'referral' => 'https://omni.apex.exchange/trade',

),

'api' => array(

'public' => array(

'get' => array(

'v3/symbols' => array( 'cost' => 1 ),

'v3/history-funding' => array( 'cost' => 1 ),

'v3/ticker' => array( 'cost' => 1 ),

'v3/klines' => array( 'cost' => 1 ),

'v3/trades' => array( 'cost' => 1 ),

'v3/depth' => array( 'cost' => 1 ),

'v3/time' => array( 'cost' => 1 ),

'v3/data/all-ticker-info' => array( 'cost' => 1 ),

),

),

'private' => array(

'get' => array(

'v3/account' => array( 'cost' => 1 ),

'v3/account-balance' => array( 'cost' => 1 ),

'v3/fills' => array( 'cost' => 1 ),

'v3/order-fills' => array( 'cost' => 1 ),

'v3/order' => array( 'cost' => 1 ),

'v3/history-orders' => array( 'cost' => 1 ),

'v3/order-by-client-order-id' => array( 'cost' => 1 ),

'v3/funding' => array( 'cost' => 1 ),

'v3/historical-pnl' => array( 'cost' => 1 ),

'v3/open-orders' => array( 'cost' => 1 ),

'v3/transfers' => array( 'cost' => 1 ),

'v3/transfer' => array( 'cost' => 1 ),

'v3/stock/account' => array( 'cost' => 1 ),

),

'post' => array(

'v3/delete-open-orders' => array( 'cost' => 1 ),

'v3/delete-client-order-id' => array( 'cost' => 1 ),

'v3/delete-order' => array( 'cost' => 1 ),

'v3/order' => array( 'cost' => 1 ),

'v3/set-initial-margin-rate' => array( 'cost' => 1 ),

'v3/transfer-out' => array( 'cost' => 1 ),

'v3/contract-transfer-out' => array( 'cost' => 1 ),

'v3/contract-transfer-to' => array( 'cost' => 1 ),

'v3/submit-withdraw-claim' => array( 'cost' => 1 ),

'v3/stock/register-account' => array( 'cost' => 1 ),

'v3/stock/generate-api' => array( 'cost' => 1 ),

),

),

),

'httpExceptions' => array(

'403' => '\\ccxt\\RateLimitExceeded', // Forbidden -- You request too many times

),

'exceptions' => array(

// Uncodumented explanation of error strings:

// - oc_diff: order cost needed to place this order

// - new_oc: total order cost of open orders including the order you are trying to open

// - ob: order balance - the total cost of current open orders

// - ab: available balance

'exact' => array(

'20006' => 'apikey sign error', // apikey sign error

'20016' => 'request para error', // apikey sign error

'10001' => '\\ccxt\\BadRequest',

),

'broad' => array(

'ORDER_PRICE_MUST_GREETER_ZERO' => '\\ccxt\\InvalidOrder',

'ORDER_POSSIBLE_LEAD_TO_ACCOUNT_LIQUIDATED' => '\\ccxt\\InvalidOrder',

'ORDER_WITH_THIS_PRICE_CANNOT_REDUCE_POSITION_ONLY' => '\\ccxt\\InvalidOrder',

),

),

'fees' => array(

'swap' => array(

'taker' => $this->parse_number('0.0005'),

'maker' => $this->parse_number('0.0002'),

),

),

'requiredCredentials' => array(

'apiKey' => true,

'secret' => true,

'walletAddress' => false,

'privateKey' => false,

'password' => true,

),

'precisionMode' => TICK_SIZE,

'commonCurrencies' => array(),

'options' => array(

'defaultType' => 'swap',

'brokerId' => '6956',

),

'features' => array(

'default' => array(

'sandbox' => true,

'createOrder' => array(

'marginMode' => false,

'triggerPrice' => true,

'triggerPriceType' => null,

'triggerDirection' => false,

'stopLossPrice' => false, // todo

'takeProfitPrice' => false, // todo

'attachedStopLossTakeProfit' => null,

'timeInForce' => array(

'IOC' => true,

'FOK' => true,

'PO' => true,

'GTD' => true,

),

'hedged' => false,

'selfTradePrevention' => false,

'trailing' => true, // todo unify

'leverage' => false,

'marketBuyByCost' => false,

'marketBuyRequiresPrice' => false,

'iceberg' => false,

),

'createOrders' => null,

'fetchMyTrades' => array(

'marginMode' => false,

'limit' => 500,

'daysBack' => 100000,

'untilDays' => 100000,

'symbolRequired' => false,

),

'fetchOrder' => array(

'marginMode' => false,

'trigger' => false,

'trailing' => false,

'symbolRequired' => false,

),

'fetchOpenOrders' => array(

'marginMode' => false,

'limit' => null,

'trigger' => false,

'trailing' => false,

'symbolRequired' => false,

),

'fetchOrders' => array(

'marginMode' => false,

'limit' => 100,

'daysBack' => 100000,

'untilDays' => 100000,

'trigger' => false,

'trailing' => false,

'symbolRequired' => false,

),

'fetchClosedOrders' => null,

'fetchOHLCV' => array(

'limit' => 200,

),

),

'swap' => array(

'linear' => array(

'extends' => 'default',

),

'inverse' => null,

),

),

));

}

public function fetch_time($params = array()): ?int {

/**

* fetches the current integer timestamp in milliseconds from the exchange server

*

* @see https://api-docs.omni.apex.exchange/#publicapi-v3-for-omni-get-system-time-v3

*

* @param {array} [$params] extra parameters specific to the exchange API endpoint

* @return {int} the current integer timestamp in milliseconds from the exchange server

*/

$response = $this->publicGetV3Time($params);

$data = $this->safe_dict($response, 'data', array());

//

// {

// "data": {

// "time": 1738837534454

// }

// }

return $this->safe_integer($data, 'time');

}

public function parse_balance(mixed $response): array {

//

// {

// "totalEquityValue": "100.000000",

// "availableBalance": "100.000000",

// "initialMargin": "100.000000",

// "maintenanceMargin": "100.000000",

// "symbolToOraclePrice": {

// "BTC-USDC": {

// "oraclePrice": "20000",

// "createdTime": 124566

// }

// }

// }

//

$result = array(

'info' => $response,

'timestamp' => null,

'datetime' => null,

);

$code = 'USDT';

$account = $this->account();

$account['free'] = $this->safe_string($response, 'availableBalance');

$account['total'] = $this->safe_string($response, 'totalEquityValue');

$result[$code] = $account;

return $this->safe_balance($result);

}

public function fetch_balance($params = array()): array {

/**

* query for account info

*

* @see https://api-docs.omni.apex.exchange/#privateapi-v3-for-omni-get-retrieve-user-account-balance

*

* @param {array} [$params] extra parameters specific to the exchange API endpoint

* @return {array} a ~@link https://docs.ccxt.com/?id=balance-structure balance structure~

*/

if ($this->markets === null) {

$this->load_markets();

}

$response = $this->privateGetV3AccountBalance($params);

$data = $this->safe_dict($response, 'data', array());

return $this->parse_balance($data);

}

public function parse_account(array $account): array {

$accountId = $this->safe_string($account, 'id', '0');

return array(

'id' => $accountId,

'type' => null,

'code' => null,

'info' => $account,

);

}

public function fetch_account($params = array()): array {

/**

* query for balance and get the amount of funds available for trading or funds locked in orders

*

* @see https://api-docs.omni.apex.exchange/#privateapi-v3-for-omni-get-retrieve-user-account-$data

*

* @param {array} [$params] extra parameters specific to the exchange API endpoint

* @return {array} a ~@link https://docs.ccxt.com/?id=balance-structure balance structure~

*/

if ($this->markets === null) {

$this->load_markets();

}

$response = $this->privateGetV3Account($params);

$data = $this->safe_dict($response, 'data', array());

return $this->parse_account($data);

}

public function fetch_currencies($params = array()): array {

/**

* fetches all available currencies on an exchange

*

* @see https://api-docs.omni.apex.exchange/#publicapi-v3-for-omni-get-all-config-$data-v3

*

* @param {array} [$params] extra parameters specific to the exchange API endpoint

* @return {array} an associative dictionary of currencies

*/

$response = $this->publicGetV3Symbols($params);

$data = $this->safe_dict($response, 'data', array());

$spotConfig = $this->safe_dict($data, 'spotConfig', array());

$multiChain = $this->safe_dict($spotConfig, 'multiChain', array());

// "spotConfig": {

// "assets": [

// {

// "tokenId": "141",

// "token": "USDT",

// "displayName": "Tether USD Coin",

// "decimals": 18,

// "showStep": "0.01",

// "iconUrl": "https://static-omni.apex.exchange/chains/chain_tokens/Ethereum/Ethereum_USDT.svg",

// "l2WithdrawFee": "0",

// "enableCollateral": true,

// "enableCrossCollateral": false,

// "crossCollateralDiscountRate": null,

// "isGray": false

// }

// ],

// "multiChain": {

// "chains": [

// {

// "chain": "Arbitrum One",

// "chainId": "9",

// "chainType": "0",

// "l1ChainId": "42161",

// "chainIconUrl": "https://static-omni.apex.exchange/chains/chain_logos/Arbitrum.svg",

// "contractAddress": "0x3169844a120c0f517b4eb4a750c08d8518c8466a",

// "swapContractAddress": "0x9e07b6Aef1bbD9E513fc2Eb8873e311E80B4f855",

// "stopDeposit": false,

// "feeLess": false,

// "gasLess": false,

// "gasToken": "ETH",

// "dynamicFee": true,

// "gasTokenDecimals": 18,

// "feeGasLimit": 300000,

// "blockTimeSeconds": 2,

// "rpcUrl": "https://arb.omni.apex.exchange",

// "minSwapUsdtAmount": "",

// "maxSwapUsdtAmount": "",

// "webRpcUrl": "https://arb.omni.apex.exchange",

// "webTxUrl": "https://arbiscan.io/tx/",

// "backupRpcUrl": "https://arb-mainnet.g.alchemy.com/v2/rGlYUbRHtUav5mfeThCPtsV9GLPt2Xq5",

// "txConfirm": 20,

// "withdrawGasFeeLess": false,

// "tokens": [

// {

// "decimals": 6,

// "iconUrl": "https://static-omni.apex.exchange/chains/chain_tokens/Arbitrum/Arbitrum_USDT.svg",

// "token": "USDT",

// "tokenAddress": "0xFd086bC7CD5C481DCC9C85ebE478A1C0b69FCbb9",

// "pullOff": false,

// "withdrawEnable": true,

// "slippage": "",

// "isDefaultToken": false,

// "displayToken": "USDT",

// "needResetApproval": true,

// "minFee": "2",

// "maxFee": "40",

// "feeRate": "0.0001",

// "maxWithdraw": "",

// "minDeposit": "",

// "minWithdraw": "",

// "maxFastWithdrawAmount": "40000",

// "minFastWithdrawAmount": "1",

// "isGray": false

// },

// {

// "decimals": 6,

// "iconUrl": "https://static-omni.apex.exchange/chains/chain_tokens/Arbitrum/Arbitrum_USDC.svg",

// "token": "USDC",

// "tokenAddress": "0xaf88d065e77c8cc2239327c5edb3a432268e5831",

// "pullOff": false,

// "withdrawEnable": true,

// "slippage": "",

// "isDefaultToken": false,

// "displayToken": "USDC",

// "needResetApproval": true,

// "minFee": "2",

// "maxFee": "20",

// "feeRate": "0.0001",

// "maxWithdraw": "",

// "minDeposit": "",

// "minWithdraw": "",

// "maxFastWithdrawAmount": "1",

// "minFastWithdrawAmount": "1",

// "isGray": false

// }

// ]

// }

// ]

// }

$rows = $this->safe_list($spotConfig, 'assets', array());

$chains = $this->safe_list($multiChain, 'chains', array());

$this->options['_temp_currencies_chains'] = $chains;

$result = $this->parse_currencies($rows);

unset($this->options['_temp_currencies_chains']);

return $result;

}

public function parse_currency(array $currency): array {

$currencyId = $this->safe_string($currency, 'token');

$code = $this->safe_currency_code($currencyId);

$name = $this->safe_string($currency, 'displayName');

$networks = array();

$chains = $this->options['_temp_currencies_chains'];

for ($j = 0; $j < count($chains); $j++) {

$chain = $this->safe_dict($chains, $j);

$tokens = $this->safe_list($chain, 'tokens', array());

for ($f = 0; $f < count($tokens); $f++) {

$token = $this->safe_dict($tokens, $f);

$tokenName = $this->safe_string($token, 'token');

if ($tokenName === $currencyId) {

$networkId = $this->safe_string($chain, 'chainId');

$networkCode = $this->network_id_to_code($networkId, $code);

if ($networkCode !== null) {

$networks[$networkCode] = array(

'info' => $chain,

'id' => $networkId,

'network' => $networkCode,

'active' => null,

'deposit' => (!$this->safe_bool($chain, 'depositDisable', false)),

'withdraw' => $this->safe_bool($token, 'withdrawEnable'),

'fee' => $this->safe_number($token, 'minFee'),

'precision' => $this->parse_number($this->parse_precision($this->safe_string($token, 'decimals'))),

'limits' => array(

'withdraw' => array(

'min' => $this->safe_number($token, 'minWithdraw'),

'max' => null,

),

'deposit' => array(

'min' => $this->safe_number($chain, 'minDeposit'),

'max' => null,

),

),

);

}

}

}

}

$networkKeys = is_array($networks) ? array_keys($networks) : array();

$networksLength = count($networkKeys);

$emptyChains = $networksLength === 0; // non-functional coins

$valueForEmpty = $emptyChains ? false : null;

return $this->safe_currency_structure(array(

'info' => $currency,

'code' => $code,

'id' => $currencyId,

'type' => 'crypto',

'name' => $name,

'active' => null,

'deposit' => $valueForEmpty,

'withdraw' => $valueForEmpty,

'fee' => null,

'precision' => null,

'limits' => array(

'amount' => array(

'min' => null,

'max' => null,

),

'withdraw' => array(

'min' => null,

'max' => null,

),

'deposit' => array(

'min' => null,

'max' => null,

),

),

'networks' => $networks,

));

}

public function fetch_markets($params = array()): array {

/**

* retrieves $data on all markets for apex

*

* @see https://api-docs.omni.apex.exchange/#publicapi-v3-for-omni-get-all-config-$data-v3

*

* @param {array} [$params] extra parameters specific to the exchange API endpoint

* @return {array[]} an array of objects representing market $data

*/

$response = $this->publicGetV3Symbols($params);

$data = $this->safe_dict($response, 'data', array());

$contractConfig = $this->safe_dict($data, 'contractConfig', array());

$perpetualContract = $this->safe_list($contractConfig, 'perpetualContract', array());

// {

// "perpetualContract":[

// {

// "baselinePositionValue": "50000.0000",

// "crossId": 30002,

// "crossSymbolId": 10,

// "crossSymbolName": "BTCUSDT",

// "digitMerge": "0.1,0.2,0.4,1,2",

// "displayMaxLeverage": "100",

// "displayMinLeverage": "1",

// "enableDisplay": true,

// "enableOpenPosition": true,

// "enableTrade": true,

// "fundingImpactMarginNotional": "6",

// "fundingInterestRate": "0.0003",

// "incrementalInitialMarginRate": "0.00250",

// "incrementalMaintenanceMarginRate": "0.00100",

// "incrementalPositionValue": "50000.0000",

// "initialMarginRate": "0.01",

// "maintenanceMarginRate": "0.005",

// "maxOrderSize": "50",

// "maxPositionSize": "100",

// "minOrderSize": "0.0010",

// "maxMarketPriceRange": "0.025",

// "settleAssetId": "USDT",

// "baseTokenId": "BTC",

// "stepSize": "0.001",

// "symbol": "BTC-USDT",

// "symbolDisplayName": "BTCUSDT",

// "tickSize": "0.1",

// "maxMaintenanceMarginRate": "0.5000",

// "maxPositionValue": "5000000.0000",

// "tagIconUrl": "https://static-omni.apex.exchange/icon/LABLE_HOT.svg",

// "tag": "HOT",

// "riskTip": false,

// "defaultInitialMarginRate": "0.05",

// "klineStartTime": 0,

// "maxMarketSizeBuffer": "0.98",

// "enableFundingSettlement": true,

// "indexPriceDecimals": 2,

// "indexPriceVarRate": "0.001",

// "openPositionOiLimitRate": "0.05",

// "fundingMaxRate": "0.000234",

// "fundingMinRate": "-0.000234",

// "fundingMaxValue": "",

// "enableFundingMxValue": true,

// "l2PairId": "50001",

// "settleTimeStamp": 0,

// "isPrelaunch": false,

// "riskLimitConfig": {},

// "category": "L1"

// }

// ]

// }

return $this->parse_markets($perpetualContract);

}

public function parse_market(array $market): array {

$id = $this->safe_string($market, 'symbol');

$id2 = $this->safe_string($market, 'crossSymbolName');

$quoteId = $this->safe_string($market, 'l2PairId');

$baseId = $this->safe_string($market, 'baseTokenId');

$quote = $this->safe_string($market, 'settleAssetId');

$base = $this->safe_currency_code($baseId);

$settleId = $this->safe_string($market, 'settleAssetId');

$settle = $this->safe_currency_code($settleId);

if (($baseId === null) || ($quote === null) || ($settle === null)) {

return null;

}

$symbol = $baseId . '/' . $quote . ':' . $settle;

$expiry = 0;

$takerFee = $this->parse_number('0.0002');

$makerFee = $this->parse_number('0.0005');

return $this->safe_market_structure(array(

'id' => $id,

'id2' => $id2,

'symbol' => $symbol,

'base' => $base,

'quote' => $quote,

'settle' => $settle,

'baseId' => $baseId,

'quoteId' => $quoteId,

'settleId' => $settleId,

'type' => 'swap',

'spot' => false,

'margin' => null,

'swap' => true,

'future' => false,

'option' => false,

'active' => $this->safe_bool($market, 'enableTrade'),

'contract' => true,

'linear' => true,

'inverse' => false,

'taker' => $takerFee,

'maker' => $makerFee,

'contractSize' => $this->safe_number($market, 'minOrderSize'),

'expiry' => ($expiry === 0) ? null : $expiry,

'expiryDatetime' => ($expiry === 0) ? null : $this->iso8601($expiry),

'strike' => null,

'optionType' => null,

'precision' => array(

'amount' => $this->safe_number($market, 'stepSize'),

'price' => $this->safe_number($market, 'tickSize'),

),

'limits' => array(

'leverage' => array(

'min' => $this->safe_number($market, 'displayMinLeverage'),

'max' => $this->safe_number($market, 'displayMaxLeverage'),

),

'amount' => array(

'min' => $this->safe_number($market, 'minOrderSize'),

'max' => $this->safe_number($market, 'maxOrderSize'),

),

'price' => array(

'min' => null,

'max' => null,

),

'cost' => array(

'min' => null,

'max' => null,

),

),

'created' => null,

'info' => $market,

));

}

public function parse_ticker(array $ticker, ?array $market = null): array {

//

// {

// "symbol": "BTCUSDT",

// "price24hPcnt": "0.450141",

// "lastPrice": "43511.50",

// "highPrice24h": "43513.50",

// "lowPrice24h": "29996.00",

// "markPrice": "43513.50",

// "indexPrice": "40828.94",

// "openInterest": "2036854775808",

// "turnover24h": "5626085.23749999",

// "volume24h": "169.317",

// "fundingRate": "0",

// "predictedFundingRate": "0",

// "nextFundingTime": "10:00:00",

// "tradeCount": 100

// }

//

$marketId = $this->safe_string($ticker, 'symbol');

$marketResolved = $this->safe_market($marketId, $market);

$symbol = $this->safe_symbol($marketId, $marketResolved);

$last = $this->safe_string($ticker, 'lastPrice');

$percentage = $this->safe_string($ticker, 'price24hPcnt');

$quoteVolume = $this->safe_string($ticker, 'turnover24h');

$baseVolume = $this->safe_string($ticker, 'volume24h');

$high = $this->safe_string($ticker, 'highPrice24h');

$low = $this->safe_string($ticker, 'lowPrice24h');

return $this->safe_ticker(array(

'symbol' => $symbol,

'timestamp' => null,

'datetime' => null,

'high' => $high,

'low' => $low,

'bid' => null,

'bidVolume' => null,

'ask' => null,

'askVolume' => null,

'vwap' => null,

'open' => null,

'close' => $last,

'last' => $last,

'previousClose' => null,

'change' => null,

'percentage' => $percentage,

'average' => null,

'baseVolume' => $baseVolume,

'quoteVolume' => $quoteVolume,

'markPrice' => $this->safe_string($ticker, 'markPrice'),

'indexPrice' => $this->safe_string($ticker, 'indexPrice'),

'info' => $ticker,

), $marketResolved);

}

public function fetch_ticker(string $symbol, $params = array()): array {

/**

* fetches a price ticker, a statistical calculation with the information calculated over the past 24 hours for a specific $market

*

* @see https://api-docs.omni.apex.exchange/#publicapi-v3-for-omni-get-ticker-data-v3

*

* @param {string} $symbol unified $symbol of the $market to fetch the ticker for

* @param {array} [$params] extra parameters specific to the exchange API endpoint

* @return {array} a ~@link https://docs.ccxt.com/?id=ticker-structure ticker structure~

*/

if ($this->markets === null) {

$this->load_markets();

}

$market = $this->market($symbol);

$request = array(

'symbol' => $this->safe_string($market, 'id2'),

);

$response = $this->publicGetV3Ticker($this->extend($request, $params));

$tickers = $this->safe_list($response, 'data', array());

$rawTicker = $this->safe_dict($tickers, 0, array());

return $this->parse_ticker($rawTicker, $market);

}

public function fetch_tickers(?array $symbols = null, $params = array()): array {

/**

* fetches a price ticker, a statistical calculation with the information calculated over the past 24 hours for a specific market

*

* @see https://api-docs.omni.apex.exchange/#publicapi-v3-for-omni-get-ticker-data-v3

*

* @param {string} $symbols unified symbol of the market to fetch the ticker for

* @param {array} [$params] extra parameters specific to the exchange API endpoint

* @return {array} a ~@link https://docs.ccxt.com/?id=ticker-structure ticker structure~

*/

if ($this->markets === null) {

$this->load_markets();

}

$response = $this->publicGetV3DataAllTickerInfo($params);

$tickers = $this->safe_list($response, 'data', array());

return $this->parse_tickers($tickers, $symbols);

}

public function fetch_ohlcv(string $symbol, string $timeframe = '1m', ?int $since = null, ?int $limit = null, $params = array()): array {

/**

* fetches historical candlestick $data containing the open, high, low, and close price, and the volume of a $market

*

* @see https://api-docs.omni.apex.exchange/#publicapi-v3-for-omni-get-candlestick-chart-$data-v3

*

* @param {string} $symbol unified $symbol of the $market to fetch OHLCV $data for

* @param {string} $timeframe the length of time each candle represents

* @param {int} [$since] timestamp in ms of the earliest candle to fetch

* @param {int} [$limit] the maximum amount of candles to fetch

* @param {array} [$params] extra parameters specific to the exchange API endpoint

* @param {int} [$params->until] timestamp in ms of the latest candle to fetch

* @return {int[][]} A list of candles ordered as timestamp, open, high, low, close, volume

*/

if ($this->markets === null) {

$this->load_markets();

}

$market = $this->market($symbol);

$request = array(

'interval' => $this->safe_string($this->timeframes, $timeframe, $timeframe),

'symbol' => $this->safe_string($market, 'id2'),

);

// default is 200 when requested with `since`, max 200

$limitResolved = ($limit === null || $limit > 200) ? 200 : $limit;

$request['limit'] = $limitResolved;

list($requestUntil, $paramsUntil) = $this->handle_until_option('end', $request, $params, 0.001);

if ($since !== null) {

$requestUntil['start'] = (int) floor($since / 1000);

}

$response = $this->publicGetV3Klines($this->extend($requestUntil, $paramsUntil));

$data = $this->safe_dict($response, 'data', array());

$OHLCVs = $this->safe_list($data, $this->safe_string($market, 'id2'), array());

return $this->parse_ohlcvs($OHLCVs, $market, $timeframe, $since, $limitResolved);

}

public function parse_ohlcv(mixed $ohlcv, ?array $market = null): array {

//

// {

// "start": 1647511440000,

// "symbol": "BTC-USD",

// "interval": "1",

// "low": "40000",

// "high": "45000",

// "open": "45000",

// "close": "40000",

// "volume": "1.002",

// "turnover": "3"

// } {"s":"BTCUSDT","i":"1","t":1741265880000,"c":"90235","h":"90235","l":"90156","o":"90156","v":"0.052","tr":"4690.4466"}

//

return array(

$this->safe_integer_2($ohlcv, 'start', 't'),

$this->safe_number_2($ohlcv, 'open', 'o'),

$this->safe_number_2($ohlcv, 'high', 'h'),

$this->safe_number_2($ohlcv, 'low', 'l'),

$this->safe_number_2($ohlcv, 'close', 'c'),

$this->safe_number_2($ohlcv, 'volume', 'v'),

);

}

public function fetch_order_book(string $symbol, ?int $limit = null, $params = array()): array {

/**

* fetches information on open orders with bid (buy) and ask (sell) prices, volumes and other $data

*

* @see https://api-docs.omni.apex.exchange/#publicapi-v3-for-omni-get-$market-depth-v3

*

* @param {string} $symbol unified $symbol of the $market to fetch the order book for

* @param {int} [$limit] the maximum amount of order book entries to return

* @param {array} [$params] extra parameters specific to the exchange API endpoint

* @return {array} an ~@link https://docs.ccxt.com/?id=order-book-structure order book structure~

*/

if ($this->markets === null) {

$this->load_markets();

}

$market = $this->market($symbol);

$request = array(

'symbol' => $this->safe_string($market, 'id2'),

);

$request['limit'] = ($limit === null) ? 100 : $limit; // max 100, default 100

$response = $this->publicGetV3Depth($this->extend($request, $params));

//

// {

// "a": [

// [

// "96576.3",

// "0.399"

// ],

// [

// "96577.6",

// "0.106"

// ]

// ],

// "b": [

// [

// "96565.2",

// "0.131"

// ],

// [

// "96565.1",

// "0.038"

// ]

// ],

// "s": "BTCUSDT",

// "u": 18665465

// }

//

$data = $this->safe_dict($response, 'data', array());

$timestamp = $this->milliseconds();

$orderbook = $this->parse_order_book($data, $market['symbol'], $timestamp, 'b', 'a');

$orderbook['nonce'] = $this->safe_integer($data, 'u');

return $orderbook;

}

public function fetch_trades(string $symbol, ?int $since = null, ?int $limit = null, $params = array()): array {

/**

* get the list of most recent $trades for a particular $symbol

*

* @see https://api-docs.omni.apex.exchange/#publicapi-v3-for-omni-get-newest-trading-data-v3

*

* @param {string} $symbol unified $symbol of the $market to fetch $trades for

* @param {int} [$since] timestamp in ms of the earliest trade to fetch

* @param {int} [$limit] the maximum amount of $trades to fetch

* @param {array} [$params] extra parameters specific to the exchange API endpoint

* @param {int} [$params->until] the latest time in ms to fetch $trades for

* @param {boolean} [$params->paginate] default false, when true will automatically paginate by calling this endpoint multiple times

* @return {Trade[]} a list of ~@link https://docs.ccxt.com/?id=public-$trades trade structures~

*/

if ($this->markets === null) {

$this->load_markets();

}

$market = $this->market($symbol);

$request = array(

'symbol' => $this->safe_string($market, 'id2'),

);

$limitResolved = ($limit === null) ? 500 : $limit; // default is 50

$request['limit'] = $limitResolved;

$response = $this->publicGetV3Trades($this->extend($request, $params));

//

// [

// {

// "i": "993f7f85-9215-5723-9078-2186ae140847",

// "p": "96534.3",

// "S": "Sell",

// "v": "0.261",

// "s": "BTCUSDT",

// "T": 1739118072710

// },

// {

// "i": "c947c9cf-8c18-5784-89c3-91bdf86ddde8",

// "p": "96513.5",

// "S": "Sell",

// "v": "0.042",

// "s": "BTCUSDT",

// "T": 1739118075944

// }

// ]

//

$trades = $this->safe_list($response, 'data', array());

return $this->parse_trades($trades, $market, $since, $limitResolved);

}

public function parse_trade(array $trade, ?array $market = null): array {

//

// [

// {

// "i": "993f7f85-9215-5723-9078-2186ae140847",

// "p": "96534.3",

// "S": "Sell",

// "v": "0.261",

// "s": "BTCUSDT",

// "T": 1739118072710

// }

// ]

//

$marketId = $this->safe_string_2($trade, 's', 'symbol');

$marketResolved = $this->safe_market($marketId, $market);

$id = $this->safe_string_2($trade, 'i', 'id');

$timestamp = $this->safe_integer_n($trade, array( 't', 'T', 'createdAt' ));

$priceString = $this->safe_string_2($trade, 'p', 'price');

$amountString = $this->safe_string_2($trade, 'v', 'size');

$side = $this->safe_string_lower_2($trade, 'S', 'side');

$type = $this->safe_string($trade, 'type');

$fee = $this->safe_string($trade, 'fee');

return $this->safe_trade(array(