public function describe() {

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

'id' => 'coinbaseinternational',

'name' => 'Coinbase International',

'countries' => array( 'US' ),

'certified' => true,

'pro' => true,

'rateLimit' => 100, // 10 requests per second

'version' => 'v1',

'userAgent' => $this->userAgents['chrome'],

'headers' => array(

'CB-VERSION' => '2018-05-30',

),

'has' => array(

'CORS' => true,

'spot' => true,

'margin' => true,

'swap' => true,

'future' => true,

'option' => false,

'addMargin' => false,

'cancelAllOrders' => true,

'cancelOrder' => true,

'cancelOrders' => false,

'closeAllPositions' => false,

'closePosition' => false,

'createDepositAddress' => true,

'createLimitBuyOrder' => true,

'createLimitSellOrder' => true,

'createMarketBuyOrder' => true,

'createMarketBuyOrderWithCost' => false,

'createMarketOrderWithCost' => false,

'createMarketSellOrder' => true,

'createMarketSellOrderWithCost' => false,

'createOrder' => true,

'createPostOnlyOrder' => true,

'createReduceOnlyOrder' => false,

'createStopLimitOrder' => true,

'createStopMarketOrder' => true,

'createStopOrder' => true,

'editOrder' => true,

'fetchAccounts' => true,

'fetchBalance' => true,

'fetchBidsAsks' => false,

'fetchBorrowRateHistories' => false,

'fetchBorrowRateHistory' => false,

'fetchCanceledOrders' => false,

'fetchClosedOrders' => false,

'fetchCrossBorrowRate' => false,

'fetchCrossBorrowRates' => false,

'fetchCurrencies' => true,

'fetchDeposits' => true,

'fetchFundingHistory' => true,

'fetchFundingRate' => false,

'fetchFundingRateHistory' => true,

'fetchFundingRates' => false,

'fetchIndexOHLCV' => false,

'fetchIsolatedBorrowRate' => false,

'fetchIsolatedBorrowRates' => false,

'fetchL2OrderBook' => false,

'fetchLedger' => false,

'fetchLeverage' => false,

'fetchLeverageTiers' => false,

'fetchMarginAdjustmentHistory' => false,

'fetchMarginMode' => false,

'fetchMarkets' => true,

'fetchMarkOHLCV' => false,

'fetchMyBuys' => true,

'fetchMySells' => true,

'fetchMyTrades' => true,

'fetchOHLCV' => true,

'fetchOpenInterestHistory' => false,

'fetchOpenOrders' => true,

'fetchOrder' => true,

'fetchOrderBook' => false,

'fetchOrders' => false,

'fetchPosition' => true,

'fetchPositionHistory' => false,

'fetchPositionMode' => false,

'fetchPositions' => true,

'fetchPositionsHistory' => false,

'fetchPositionsRisk' => false,

'fetchPremiumIndexOHLCV' => false,

'fetchTicker' => true,

'fetchTickers' => true,

'fetchTime' => false,

'fetchTrades' => false,

'fetchTradingFee' => false,

'fetchTradingFees' => false,

'fetchTransfers' => true,

'fetchWithdrawals' => true,

'reduceMargin' => false,

'sandbox' => true,

'setLeverage' => false,

'setMargin' => true,

'setMarginMode' => false,

'setPositionMode' => false,

'withdraw' => true,

),

'urls' => array(

'logo' => 'https://github.com/ccxt/ccxt/assets/43336371/866ae638-6ab5-4ebf-ab2c-cdcce9545625',

'api' => array(

'rest' => 'https://api.international.coinbase.com/api',

),

'test' => array(

'rest' => 'https://api-n5e1.coinbase.com/api',

),

'www' => 'https://international.coinbase.com',

'doc' => array(

'https://docs.cloud.coinbase.com/intx/docs',

),

'fees' => array(

'https://help.coinbase.com/en/international-exchange/trading-deposits-withdrawals/international-exchange-fees',

),

'referral' => '',

),

'requiredCredentials' => array(

'apiKey' => true,

'secret' => true,

'password' => true,

),

'api' => array(

'v1' => array(

'public' => array(

'get' => array(

'assets',

'assets/{assets}',

'assets/{asset}/networks',

'instruments',

'instruments/{instrument}',

'instruments/{instrument}/quote',

'instruments/{instrument}/funding',

'instruments/{instrument}/candles',

),

),

'private' => array(

'get' => array(

'orders',

'orders/{id}',

'portfolios',

'portfolios/{portfolio}',

'portfolios/{portfolio}/detail',

'portfolios/{portfolio}/summary',

'portfolios/{portfolio}/balances',

'portfolios/{portfolio}/balances/{asset}',

'portfolios/{portfolio}/positions',

'portfolios/{portfolio}/positions/{instrument}',

'portfolios/fills',

'portfolios/{portfolio}/fills',

'transfers',

'transfers/{transfer_uuid}',

),

'post' => array(

'orders',

'portfolios',

'portfolios/margin',

'portfolios/transfer',

'transfers/withdraw',

'transfers/address',

'transfers/create-counterparty-id',

'transfers/validate-counterparty-id',

'transfers/withdraw/counterparty',

),

'put' => array(

'orders/{id}',

'portfolios/{portfolio}',

),

'delete' => array(

'orders',

'orders/{id}',

),

),

),

),

'fees' => array(

'trading' => array(

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

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

'tierBased' => true,

'percentage' => true,

'tiers' => array(

'taker' => array(

array( $this->parse_number('0'), $this->parse_number('0.004') ),

array( $this->parse_number('1000000'), $this->parse_number('0.004') ),

array( $this->parse_number('5000000'), $this->parse_number('0.0035') ),

array( $this->parse_number('10000000'), $this->parse_number('0.0035') ),

array( $this->parse_number('50000000'), $this->parse_number('0.003') ),

array( $this->parse_number('250000000'), $this->parse_number('0.0025') ),

),

'maker' => array(

array( $this->parse_number('0'), $this->parse_number('0.002') ),

array( $this->parse_number('1000000'), $this->parse_number('0.0016') ),

array( $this->parse_number('5000000'), $this->parse_number('0.001') ),

array( $this->parse_number('10000000'), $this->parse_number('0.0008') ),

array( $this->parse_number('50000000'), $this->parse_number('0.0005') ),

array( $this->parse_number('250000000'), $this->parse_number('0') ),

),

),

),

),

'precisionMode' => TICK_SIZE,

'exceptions' => array(

'exact' => array(),

'broad' => array(

'DUPLICATE_CLIENT_ORDER_ID' => '\\ccxt\\DuplicateOrderId',

'Order rejected' => '\\ccxt\\InvalidOrder',

'market orders must be IoC' => '\\ccxt\\InvalidOrder',

'tif is required' => '\\ccxt\\InvalidOrder',

'Invalid replace order request' => '\\ccxt\\InvalidOrder',

'Unauthorized' => '\\ccxt\\PermissionDenied',

'invalid result_limit' => '\\ccxt\\BadRequest',

'is a required field' => '\\ccxt\\BadRequest',

'Not Found' => '\\ccxt\\BadRequest',

'ip not allowed' => '\\ccxt\\AuthenticationError',

),

),

'timeframes' => array(

'1m' => 'ONE_MINUTE',

'5m' => 'FIVE_MINUTE',

'15m' => 'FIFTEEN_MINUTE',

'30m' => 'THIRTY_MINUTE',

'1h' => 'ONE_HOUR',

'2h' => 'TWO_HOUR',

'6h' => 'SIX_HOUR',

'1d' => 'ONE_DAY',

),

'options' => array(

'brokerId' => 'nfqkvdjp',

'portfolio' => '', // default portfolio id

'withdraw' => array(

'method' => 'v1PrivatePostTransfersWithdraw', // use v1PrivatePostTransfersWithdrawCounterparty for counterparty withdrawals

),

'networksById' => array(

'ethereum' => 'ETH',

'arbitrum' => 'ARBITRUM',

'avacchain' => 'AVAX',

'optimism' => 'OPTIMISM',

'polygon' => 'MATIC',

'solana' => 'SOL',

'bitcoin' => 'BTC',

),

),

));

}

public function handle_portfolio_and_params(string $methodName, $params = array ()) {

$portfolio = null;

list($portfolio, $params) = $this->handle_option_and_params($params, $methodName, 'portfolio');

if (($portfolio !== null) && ($portfolio !== '')) {

return array( $portfolio, $params );

}

$defaultPortfolio = $this->safe_string($this->options, 'portfolio');

if (($defaultPortfolio !== null) && ($defaultPortfolio !== '')) {

return array( $defaultPortfolio, $params );

}

$accounts = $this->fetch_accounts();

for ($i = 0; $i < count($accounts); $i++) {

$account = $accounts[$i];

$info = $this->safe_dict($account, 'info', array());

if ($this->safe_bool($info, 'is_default')) {

$portfolioId = $this->safe_string($info, 'portfolio_id');

$this->options['portfolio'] = $portfolioId;

return array( $portfolioId, $params );

}

}

throw new ArgumentsRequired($this->id . ' ' . $methodName . '() requires a $portfolio parameter or set the default $portfolio with $this->options["portfolio"]');

}

public function handle_network_id_and_params(string $currencyCode, string $methodName, $params) {

$networkId = null;

list($networkId, $params) = $this->handle_option_and_params($params, $methodName, 'network_arn_id');

if ($networkId === null) {

$this->load_currency_networks($currencyCode);

$networks = $this->currencies[$currencyCode]['networks'];

$network = $this->safe_string_2($params, 'networkCode', 'network');

if ($network === null) {

// find default $network

if ($this->is_empty($networks)) {

throw new BadRequest($this->id . ' createDepositAddress $network not found for currency ' . $currencyCode . ' please specify $networkId in params');

}

$defaultNetwork = $this->find_default_network($networks);

$networkId = $defaultNetwork['id'];

} else {

$networkId = $this->network_code_to_id($network, $currencyCode);

}

}

return array( $networkId, $params );

}

public function fetch_accounts($params = array ()) {

/**

* fetch all the accounts associated with a profile

* @see https://docs.cloud.coinbase.com/intx/reference/getportfolios

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

* @return {array} a dictionary of ~@link https://docs.ccxt.com/#/?id=account-structure account structures~ indexed by the account type

*/

$this->load_markets();

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

//

// array(

// {

// "portfolio_id":"1ap32qsc-1-0",

// "portfolio_uuid":"028d7f6c-b92c-7361-8b7e-2932711e5a22",

// "name":"CCXT Portfolio 030624-17:16",

// "user_uuid":"e6cf46b6-a32f-5fa7-addb-3324d4526fbd",

// "maker_fee_rate":"0",

// "taker_fee_rate":"0.0002",

// "trading_lock":false,

// "borrow_disabled":false,

// "is_lsp":false,

// "is_default":true,

// "cross_collateral_enabled":false

// }

// )

//

return $this->parse_accounts($response, $params);

}

public function parse_account($account) {

//

// {

// "portfolio_id":"1ap32qsc-1-0",

// "portfolio_uuid":"028d7f6c-b92c-7361-8b7e-2932711e5a22",

// "name":"CCXT Portfolio 030624-17:16",

// "user_uuid":"e6cf46b6-a32f-5fa7-addb-3324d4526fbd",

// "maker_fee_rate":"0",

// "taker_fee_rate":"0.0002",

// "trading_lock":false,

// "borrow_disabled":false,

// "is_lsp":false,

// "is_default":true,

// "cross_collateral_enabled":false

// }

//

return array(

'id' => $this->safe_string_2($account, 'portfolio_id', 'portfolio_uuid'),

'type' => null,

'code' => null,

'info' => $account,

);

}

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

/**

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

* @see https://docs.cdp.coinbase.com/intx/reference/getinstrumentcandles

* @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, default 100 max 10000

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

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

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

* @param {boolean} [$params->paginate] default false, when true will automatically $paginate by calling this endpoint multiple times. See in the docs all the [available parameters](https://github.com/ccxt/ccxt/wiki/Manual#pagination-$params)

*/

$this->load_markets();

$paginate = false;

list($paginate, $params) = $this->handle_option_and_params($params, 'fetchOHLCV', 'paginate');

if ($paginate) {

return $this->fetch_paginated_call_deterministic('fetchOHLCV', $symbol, $since, $limit, $timeframe, $params, 10000);

}

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

$request = array(

'instrument' => $market['id'],

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

);

if ($since !== null) {

$request['start'] = $this->iso8601($since);

} else {

throw new ArgumentsRequired($this->id . ' fetchOHLCV() requires a $since argument');

}

$unitl = $this->safe_integer($params, 'until');

if ($unitl !== null) {

$params = $this->omit($params, 'until');

$request['end'] = $this->iso8601($unitl);

}

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

//

// {

// "aggregations" => array(

// {

// "start" => "2024-04-23T00:00:00Z",

// "open" => "62884.4",

// "high" => "64710.6",

// "low" => "62884.4",

// "close" => "63508.4",

// "volume" => "3253.9983"

// }

// )

// }

//

$candles = $this->safe_list($response, 'aggregations', array());

return $this->parse_ohlcvs($candles, $market, $timeframe, $since, $limit);

}

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

//

// {

// "start" => "2024-04-23T00:00:00Z",

// "open" => "62884.4",

// "high" => "64710.6",

// "low" => "62884.4",

// "close" => "63508.4",

// "volume" => "3253.9983"

// }

//

return array(

$this->parse8601($this->safe_string_2($ohlcv, 'start', 'time')),

$this->safe_number($ohlcv, 'open'),

$this->safe_number($ohlcv, 'high'),

$this->safe_number($ohlcv, 'low'),

$this->safe_number($ohlcv, 'close'),

$this->safe_number($ohlcv, 'volume'),

);

}

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

/**

* fetches historical funding rate prices

* @see https://docs.cloud.coinbase.com/intx/reference/getinstrumentfunding

* @param {string} $symbol unified $symbol of the $market to fetch the funding rate history for

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

* @param {int} [$limit] the maximum amount of ~@link https://docs.ccxt.com/#/?id=funding-rate-history-structure funding rate structures~ to fetch

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

* @param {boolean} [$params->paginate] default false, when true will automatically $paginate by calling this endpoint multiple times. See in the docs all the [availble parameters](https://github.com/ccxt/ccxt/wiki/Manual#pagination-$params)

*/

if ($symbol === null) {

throw new ArgumentsRequired($this->id . ' fetchFundingRateHistory() requires a $symbol argument');

}

$this->load_markets();

$paginate = false;

list($paginate, $params) = $this->handle_option_and_params($params, 'fetchFundingRateHistory', 'paginate');

$maxEntriesPerRequest = null;

list($maxEntriesPerRequest, $params) = $this->handle_option_and_params($params, 'fetchFundingRateHistory', 'maxEntriesPerRequest', 100);

$pageKey = 'ccxtPageKey';

if ($paginate) {

return $this->fetch_paginated_call_incremental('fetchFundingRateHistory', $symbol, $since, $limit, $params, $pageKey, $maxEntriesPerRequest);

}

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

$page = $this->safe_integer($params, $pageKey, 1) - 1;

$request = array(

'instrument' => $market['id'],

'result_offset' => $this->safe_integer_2($params, 'offset', 'result_offset', $page * $maxEntriesPerRequest),

);

if ($limit !== null) {

$request['result_limit'] = $limit;

}

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

//

// {

// "pagination":array(

// "result_limit":"25",

// "result_offset":"0"

// ),

// "results":array(

// array(

// "instrument_id":"149264167780483072",

// "funding_rate":"0.000011",

// "mark_price":"47388.1",

// "event_time":"2024-02-10T16:00:00Z"

// ),

// ...

// )

// }

//

$rawRates = $this->safe_list($response, 'results', array());

return $this->parse_funding_rate_histories($rawRates, $market, $since, $limit);

}

public function parse_funding_rate_history($info, ?array $market = null) {

return $this->parse_funding_rate($info, $market);

}

public function parse_funding_rate($contract, ?array $market = null) {

//

// {

// "instrument_id":"149264167780483072",

// "funding_rate":"0.000011",

// "mark_price":"47388.1",

// "event_time":"2024-02-10T16:00:00Z"

// }

//

$fundingDatetime = $this->safe_string_2($contract, 'event_time', 'time');

return array(

'info' => $contract,

'symbol' => $this->safe_symbol(null, $market),

'markPrice' => $this->safe_number($contract, 'mark_price'),

'indexPrice' => null,

'interestRate' => null,

'estimatedSettlePrice' => null,

'timestamp' => $this->parse8601($fundingDatetime),

'datetime' => $fundingDatetime,

'fundingRate' => $this->safe_number($contract, 'funding_rate'),

'fundingTimestamp' => $this->parse8601($fundingDatetime),

'fundingDatetime' => $fundingDatetime,

'nextFundingRate' => null,

'nextFundingTimestamp' => null,

'nextFundingDatetime' => null,

'previousFundingRate' => null,

'previousFundingTimestamp' => null,

'previousFundingDatetime' => null,

);

}

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

/**

* fetch the history of funding payments paid and received on this account

* @see https://docs.cdp.coinbase.com/intx/reference/gettransfers

* @param {string} [$symbol] unified $market $symbol

* @param {int} [$since] the earliest time in ms to fetch funding history for

* @param {int} [$limit] the maximum number of funding history structures to retrieve

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

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

*/

$this->load_markets();

$request = array(

'type' => 'FUNDING',

);

$market = null;

if ($symbol !== null) {

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

}

$portfolios = null;

list($portfolios, $params) = $this->handle_option_and_params($params, 'fetchFundingHistory', 'portfolios');

if ($portfolios !== null) {

$request['portfolios'] = $portfolios;

}

if ($since !== null) {

$request['time_from'] = $this->iso8601($since);

}

if ($limit !== null) {

$request['result_limit'] = $limit;

} else {

$request['result_limit'] = 100;

}

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

$fundings = $this->safe_list($response, 'results', array());

return $this->parse_incomes($fundings, $market, $since, $limit);

}

public function parse_income($income, ?array $market = null) {

//

// {

// "amount":"0.0008",

// "asset":"USDC",

// "created_at":"2024-02-22T16:00:00Z",

// "from_portfolio":array(

// "id":"13yuk1fs-1-0",

// "name":"Eng Test Portfolio - 2",

// "uuid":"018712f2-5ff9-7de3-9010-xxxxxxxxx"

// ),

// "instrument_id":"149264164756389888",

// "instrument_symbol":"ETH-PERP",

// "position_id":"1xy4v51m-1-2",

// "status":"PROCESSED",

// "to_portfolio":array(

// "name":"CB_FUND"

// ),

// "transfer_type":"FUNDING",

// "transfer_uuid":"a6b708df-2c44-32c5-bb98-xxxxxxxxxx",

// "updated_at":"2024-02-22T16:00:00Z"

// }

//

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

$market = $this->safe_market($marketId, $market, null, 'contract');

$datetime = $this->safe_integer($income, 'created_at');

$timestamp = $this->parse8601($datetime);

$currencyId = $this->safe_string($income, 'asset');

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

return array(

'info' => $income,

'symbol' => $market['symbol'],

'code' => $code,

'timestamp' => $timestamp,

'datetime' => $this->iso8601($timestamp),

'id' => $this->safe_string($income, 'transfer_uuid'),

'amount' => $this->safe_number($income, 'amount'),

'rate' => null,

);

}

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

/**

* fetch a history of internal $transfers made on an account

* @see https://docs.cdp.coinbase.com/intx/reference/gettransfers

* @param {string} $code unified $currency $code of the $currency transferred

* @param {int} [$since] the earliest time in ms to fetch $transfers for

* @param {int} [$limit] the maximum number of $transfers structures to retrieve

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

* @return {array[]} a list of ~@link https://docs.ccxt.com/#/?id=transfer-structure transfer structures~

*/

$this->load_markets();

$request = array(

'type' => 'INTERNAL',

);

$currency = null;

if ($code !== null) {

$currency = $this->currency($code);

}

$portfolios = null;

list($portfolios, $params) = $this->handle_option_and_params($params, 'fetchTransfers', 'portfolios');

if ($portfolios !== null) {

$request['portfolios'] = $portfolios;

}

if ($since !== null) {

$request['time_from'] = $this->iso8601($since);

}

if ($limit !== null) {

$request['result_limit'] = $limit;

} else {

$request['result_limit'] = 100;

}

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

$transfers = $this->safe_list($response, 'results', array());

return $this->parse_transfers($transfers, $currency, $since, $limit);

}

public function parse_transfer(array $transfer, ?array $currency = null): array {

//

// {

// "amount":"0.0008",

// "asset":"USDC",

// "created_at":"2024-02-22T16:00:00Z",

// "from_portfolio":array(

// "id":"13yuk1fs-1-0",

// "name":"Eng Test Portfolio - 2",

// "uuid":"018712f2-5ff9-7de3-9010-xxxxxxxxx"

// ),

// "instrument_id":"149264164756389888",

// "instrument_symbol":"ETH-PERP",

// "position_id":"1xy4v51m-1-2",

// "status":"PROCESSED",

// "to_portfolio":array(

// "name":"CB_FUND"

// ),

// "transfer_type":"FUNDING",

// "transfer_uuid":"a6b708df-2c44-32c5-bb98-xxxxxxxxxx",

// "updated_at":"2024-02-22T16:00:00Z"

// }

//

$datetime = $this->safe_integer($transfer, 'created_at');

$timestamp = $this->parse8601($datetime);

$currencyId = $this->safe_string($transfer, 'asset');

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

$fromPorfolio = $this->safe_dict($transfer, 'from_portfolio', array());

$fromId = $this->safe_string($fromPorfolio, 'id');

$toPorfolio = $this->safe_dict($transfer, 'to_portfolio', array());

$toId = $this->safe_string($toPorfolio, 'id');

return array(

'info' => $transfer,

'id' => $this->safe_string($transfer, 'transfer_uuid'),

'timestamp' => $timestamp,

'datetime' => $this->iso8601($timestamp),

'currency' => $code,

'amount' => $this->safe_number($transfer, 'amount'),

'fromAccount' => $fromId,

'toAccount' => $toId,

'status' => $this->parse_transfer_status($this->safe_string($transfer, 'status')),

);

}

public function parse_transfer_status(?string $status): ?string {

$statuses = array(

'FAILED' => 'failed',

'PROCESSED' => 'ok',

'NEW' => 'pending',

'STARTED' => 'pending',

);

return $this->safe_string($statuses, $status, $status);

}

public function create_deposit_address(string $code, $params = array ()) {

/**

* create a $currency deposit $address

* @see https://docs.cloud.coinbase.com/intx/reference/createaddress

* @see https://docs.cloud.coinbase.com/intx/reference/createcounterpartyid

* @param {string} $code unified $currency $code of the $currency for the deposit $address

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

* @param {string} [$params->network_arn_id] Identifies the blockchain network (e.g., networks/ethereum-mainnet/assets/313ef8a9-ae5a-5f2f-8a56-572c0e2a4d5a) if not provided will pick default

* @param {string} [$params->network] unified network $code to identify the blockchain network

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

*/

$this->load_markets();

$method = null;

list($method, $params) = $this->handle_option_and_params($params, 'createDepositAddress', 'method', 'v1PrivatePostTransfersAddress');

$portfolio = null;

list($portfolio, $params) = $this->handle_portfolio_and_params('createDepositAddress', $params);

$request = array(

'portfolio' => $portfolio,

);

if ($method === 'v1PrivatePostTransfersAddress') {

$currency = $this->currency($code);

$request['asset'] = $currency['id'];

$networkId = null;

list($networkId, $params) = $this->handle_network_id_and_params($code, 'createDepositAddress', $params);

$request['network_arn_id'] = $networkId;

}

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

//

// v1PrivatePostTransfersAddress

// {

// $address => "3LkwYscRyh6tUR1XTqXSJQoJnK7ucC1F4n",

// network_arn_id => "networks/bitcoin-mainnet/assets/6ecc0dcc-10a2-500e-b315-a3b9abae19ce",

// destination_tag => "",

// }

// v1PrivatePostTransfersCreateCounterpartyId

// {

// "portfolio_uuid":"018e0a8b-6b6b-70e0-9689-1e7926c2c8bc",

// "counterparty_id":"CB2ZPUCZBE"

// }

//

$tag = $this->safe_string($response, 'destination_tag');

$address = $this->safe_string_2($response, 'address', 'counterparty_id');

return array(

'currency' => $code,

'tag' => $tag,

'address' => $address,

'info' => $response,

);

}

public function find_default_network($networks) {

$networksArray = $this->to_array($networks);

for ($i = 0; $i < count($networksArray); $i++) {

$info = $networksArray[$i]['info'];

$is_default = $this->safe_bool($info, 'is_default', false);

if ($is_default === true) {

return $networksArray[$i];

}

}

return $networksArray[0];

}

public function load_currency_networks($code, $params = array ()) {

$currency = $this->currency($code);

$networks = $this->safe_dict($currency, 'networks');

if ($networks !== null) {

return;

}

$request = array(

'asset' => $currency['id'],

);

$rawNetworks = $this->v1PublicGetAssetsAssetNetworks ($request);

//

// [

// {

// "asset_id" = $this->parse_networks($rawNetworks);

}

public function parse_networks($networks, $params = array ()) {

$result = array();

for ($i = 0; $i < count($networks); $i++) {

$network = $this->extend($this->parse_network($networks[$i]), $params);

$result[$network['network']] = $network;

}

return $result;

}

public function parse_network($network, $params = array ()) {

//

// {

// "asset_id":"1",

// "asset_uuid":"2b92315d-eab7-5bef-84fa-089a131333f5",

// "asset_name":"USDC",

// "network_arn_id":"networks/ethereum-mainnet/assets/9bc140b4-69c3-5fc9-bd0d-b041bcf40039",

// "min_withdrawal_amt":"1",

// "max_withdrawal_amt":"100000000",

// "network_confirms":35,

// "processing_time":485,

// "is_default":true,

// "network_name":"ethereum",

// "display_name":"Ethereum"

// }

//

$currencyId = $this->safe_string($network, 'asset_name');

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

$networkId = $this->safe_string($network, 'network_arn_id');

$networkIdForCode = $this->safe_string_n($network, array( 'network_name', 'display_name', 'network_arn_id' ), '');

return $this->safe_network(array(

'info' => $network,

'id' => $networkId,

'name' => $this->safe_string($network, 'display_name'),

'network' => $this->network_id_to_code($networkIdForCode, $currencyCode),

'active' => null,

'deposit' => null,

'withdraw' => null,

'precision' => null,

'fee' => null,

'limits' => array(

'withdraw' => array(

'min' => $this->safe_number($network, 'min_withdrawal_amt'),

'max' => $this->safe_number($network, 'max_withdrawal_amt'),

),

'deposit' => array(

'min' => null,

'max' => null,

),

),

));

}

public function set_margin(string $symbol, float $amount, $params = array ()): mixed {

/**

* Either adds or reduces margin in order to set the margin to a specific value

* @see https://docs.cloud.coinbase.com/intx/reference/setportfoliomarginoverride

* @param {string} $symbol unified market $symbol of the market to set margin in

* @param {float} $amount the $amount to set the margin to

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

* @return {array} A {@link https://github.com/ccxt/ccxt/wiki/Manual#add-margin-structure margin structure}

*/

$portfolio = null;

list($portfolio, $params) = $this->handle_portfolio_and_params('setMargin', $params);

if ($symbol !== null) {

throw new BadRequest($this->id . ' setMargin() only allows setting margin to full portfolio');

}

$request = array(

'portfolio' => $portfolio,

'margin_override' => $amount,

);

return $this->v1PrivatePostPortfoliosMargin ($this->extend($request, $params));

}

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

/**

* fetch history of deposits and withdrawals

* @see https://docs.cloud.coinbase.com/intx/reference/gettransfers

* @param {string} [$code] unified currency $code for the currency of the deposit/withdrawals, default is null

* @param {int} [$since] timestamp in ms of the earliest deposit/withdrawal, default is null

* @param {int} [$limit] max number of deposit/withdrawals to return, default is null

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

* @param {string} [$params->portfolios] Identifies the $portfolios by UUID (e.g., 892e8c7c-e979-4cad-b61b-55a197932cf1) or portfolio ID (e.g., 5189861793641175). Can provide single or multiple $portfolios to filter by or fetches transfers for all $portfolios if none are provided.

* @param {int} [$params->until] Only find transfers updated before this time. Use timestamp format

* @param {string} [$params->status] The current status of transfer. Possible values => [PROCESSED, NEW, FAILED, STARTED]

* @param {string} [$params->type] The type of transfer Possible values => [DEPOSIT, WITHDRAW, REBATE, STIPEND, INTERNAL, FUNDING]

* @param {boolean} [$params->paginate] default false, when true will automatically $paginate by calling this endpoint multiple times. See in the docs all the [availble parameters](https://github.com/ccxt/ccxt/wiki/Manual#pagination-$params)

* @return {array} a list of ~@link https://docs.ccxt.com/#/?id=transaction-structure transaction structures~

*/

$this->load_markets();

$paginate = null;

list($paginate, $params) = $this->handle_option_and_params($params, 'fetchDepositsWithdrawals', 'paginate');

$maxEntriesPerRequest = null;

list($maxEntriesPerRequest, $params) = $this->handle_option_and_params($params, 'fetchDepositsWithdrawals', 'maxEntriesPerRequest', 100);

$pageKey = 'ccxtPageKey';

if ($paginate) {

return $this->fetch_paginated_call_incremental('fetchDepositsWithdrawals', $code, $since, $limit, $params, $pageKey, $maxEntriesPerRequest);

}

$page = $this->safe_integer($params, $pageKey, 1) - 1;

$request = array(

'result_offset' => $this->safe_integer_2($params, 'offset', 'result_offset', $page * $maxEntriesPerRequest),

);

if ($since !== null) {

$request['time_from'] = $this->iso8601($since);

}

if ($limit !== null) {

$newLimit = min ($limit, 100);

$request['result_limit'] = $newLimit;

}

$portfolios = null;

list($portfolios, $params) = $this->handle_option_and_params($params, 'fetchDepositsWithdrawals', 'portfolios');

if ($portfolios !== null) {

$request['portfolios'] = $portfolios;

}

$until = null;

list($until, $params) = $this->handle_option_and_params($params, 'fetchDepositsWithdrawals', 'until');

if ($until !== null) {

$request['time_to'] = $this->iso8601($until);

}

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

//

// {

// "pagination":array(

// "result_limit":25,

// "result_offset":0

// ),

// "results":array(

// {

// "transfer_uuid":"8e471d77-4208-45a8-9e5b-f3bd8a2c1fc3",

// "transfer_type":"WITHDRAW",

// "amount":"1.000000",

// "asset":"USDC",

// "status":"PROCESSED",

// "network_name":"ethereum",

// "created_at":"2024-03-14T02:32:18.497795Z",

// "updated_at":"2024-03-14T02:35:38.514588Z",

// "from_portfolio":array(

// "id":"1yun54bb-1-6",

// "uuid":"018e0a8b-6b6b-70e0-9689-1e7926c2c8bc",

// "name":"fungus technology o?Portfolio"

// ),

// "to_address":"0xcdcE79F820BE9d6C5033db5c31d1AE3A8c2399bB"

// }

// )

// }

//

$rawTransactions = $this->safe_list($response, 'results', array());

return $this->parse_transactions($rawTransactions);

}

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

/**

* @see https://docs.cloud.coinbase.com/intx/reference/getportfolioposition

* fetch data on an open $position

* @param {string} $symbol unified market $symbol of the market the $position is held in

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

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

*/

$this->load_markets();

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

$portfolio = null;

list($portfolio, $params) = $this->handle_portfolio_and_params('fetchPosition', $params);

$request = array(

'portfolio' => $portfolio,

'instrument' => $this->market_id($symbol),

);

$position = $this->v1PrivateGetPortfoliosPortfolioPositionsInstrument ($this->extend($request, $params));

//

// {

// "symbol":"BTC-PERP",

// "instrument_id":"114jqr89-0-0",

// "instrument_uuid":"b3469e0b-222c-4f8a-9f68-1f9e44d7e5e0",

// "vwap":"52482.3",

// "net_size":"0",

// "buy_order_size":"0.001",

// "sell_order_size":"0",

// "im_contribution":"0.2",

// "unrealized_pnl":"0",

// "mark_price":"52406.8",

// "entry_vwap":"52472.9"

// }

//

return $this->parse_position($position);

}

public function parse_position(array $position, ?array $market = null) {

//

// {

// "symbol":"BTC-PERP",

// "instrument_id":"114jqr89-0-0",

// "instrument_uuid":"b3469e0b-222c-4f8a-9f68-1f9e44d7e5e0",

// "vwap":"52482.3",

// "net_size":"0",

// "buy_order_size":"0.001",

// "sell_order_size":"0",

// "im_contribution":"0.2",

// "unrealized_pnl":"0",

// "mark_price":"52406.8",

// "entry_vwap":"52472.9"

// }

//

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

$quantity = $this->safe_string($position, 'net_size');

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

$side = 'long';

if (Precise::string_le($quantity, '0')) {

$side = 'short';

$quantity = Precise::string_mul('-1', $quantity);

}

return $this->safe_position(array(

'info' => $position,

'id' => $this->safe_string($position, 'id'),

'symbol' => $market['symbol'],

'entryPrice' => null,

'markPrice' => $this->safe_number($position, 'mark_price'),

'notional' => null,

'collateral' => null,

'unrealizedPnl' => $this->safe_number($position, 'unrealized_pnl'),

'side' => $side,

'contracts' => $this->parse_number($quantity),

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

'timestamp' => null,

'datetime' => null,

'hedged' => null,

'maintenanceMargin' => null,

'maintenanceMarginPercentage' => null,

'initialMargin' => $this->safe_number($position, 'im_contribution'),

'initialMarginPercentage' => null,

'leverage' => null,

'liquidationPrice' => null,

'marginRatio' => null,

'marginMode' => null,

'percentage' => null,

));

}

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

/**

* @see https://docs.cloud.coinbase.com/intx/reference/getportfoliopositions

* fetch all open $positions