Gains Network

https://docs.gains.trade
Admin
Gains Network is a decentralized finance (DeFi) platform that offers leveraged trading through its...
Tokens:213,045
Snippets:2,244
Trust Score:9
Update:3 months ago
Show doc for...
Tokens:
Raw
### Get Referrals Start Referrer Fee Percentage

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnsreferrals

Returns the initial referrer fee percentage applied when zero volume has been referred.

```solidity
function getReferralsStartReferrerFeeP() external view returns (uint256)
```

--------------------------------

### Get OTC Configuration

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnsotc

Retrieves the current OTC configuration.

```solidity
function getOtcConfig() external view returns (struct IOtc.OtcConfig)
```

--------------------------------

### Get Collaterals Overview

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnstradingstorage

Retrieves general information about the supported collaterals.

```solidity
function getCollateralsCount() external view returns (uint8)
```

```solidity
function getCollaterals() external view returns (struct ITradingStorage.Collateral[])
```

--------------------------------

### GetLiquidationPriceContext Example

Source: https://docs.gains.trade/developer/integrators/guides/calculating-liquidation-price

Example of a fully populated GetLiquidationPriceContext object.

```typescript
{
    "currentBlock": 72867071,
    "groups": [...],
    "pairs": [...],
    "liquidationParams": {
        "maxLiqSpreadP": 0.0005,
        "startLiqThresholdP": 0.9,
        "endLiqThresholdP": 0.65,
        "startLeverage": 25,
        "endLeverage": 60
    },
    "pairSpreadP": 0,
    "collateralPriceUsd": 1.0000328,
    "contractsVersion": 1
}
```

--------------------------------

### Get Group Details

Source: https://docs.gains.trade/images/hJFnQOm8d3mjVbW14zgc-gnsmulticollatdiamond.json

Retrieves group configuration details by index.

```json
{
      "inputs": [
        {
          "internalType": "uint256",
          "name": "_index",
          "type": "uint256"
        }
      ],
      "name": "groups",
      "outputs": [
        {
          "components": [
            {
              "internalType": "string",
              "name": "name",
              "type": "string"
            },
            {
              "internalType": "bytes32",
              "name": "job",
              "type": "bytes32"
            },
            {
              "internalType": "uint256",
```

--------------------------------

### Get OI Windows Settings

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnspriceimpact

Retrieves the current configuration settings for price impact windows.

```solidity
function getOiWindowsSettings() external view returns (struct IPriceImpact.OiWindowsSettings)
```

--------------------------------

### Get Referrer Details

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnsreferrals

Retrieves the details for a specific referrer address.

```solidity
function getReferrerDetails(address _referrer) external view returns (struct IReferrals.ReferrerDetails)
```

--------------------------------

### Get Open Interest Windows Settings

Source: https://docs.gains.trade/developer/technical-reference/contracts/libraries/priceimpactutils

Retrieves the global settings for open interest windows.

```solidity
function getOiWindowsSettings() internal view returns (struct IPriceImpact.OiWindowsSettings)
```

--------------------------------

### Get Pair Details

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnspairsstorage

Retrieves the full configuration details for a specific pair by its index.

```solidity
function pairs(uint256 _index) external view returns (struct IPairsStorage.Pair)
```

--------------------------------

### Initialize Referral Parameters

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnsreferrals

Sets the initial fee percentages and target volume for the referral system.

```solidity
function initializeReferrals(uint256 _allyFeeP, uint256 _startReferrerFeeP, uint256 _targetVolumeUsd) external
```

--------------------------------

### initializeReferrals

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnsreferrals

Initializes the referral system parameters including ally fees, starting referrer fees, and target volume.

```APIDOC
## function initializeReferrals(uint256 _allyFeeP, uint256 _startReferrerFeeP, uint256 _targetVolumeUsd)

### Description
Initializes the referral system with specific fee percentages and volume targets.

### Parameters
- **_allyFeeP** (uint256) - % of total referral fee going to ally
- **_startReferrerFeeP** (uint256) - initial % of total referral fee earned when zero volume referred
- **_targetVolumeUsd** (uint256) - usd opening volume to refer to reach 100% of referral fee
```

--------------------------------

### Administrative Functions

Source: https://docs.gains.trade/developer/technical-reference/contracts/misc/epochbasedtokenclaim

Functions for managing contract configuration and reward distribution setup.

```solidity
function setManager(address _manager) external
```

```solidity
function setRoot(uint256 _epoch, bytes32 _root, uint256 _totalRewards, string _cid) external
```

```solidity
function withdrawTokens() external
```

--------------------------------

### Constructor

Source: https://docs.gains.trade/developer/technical-reference/contracts/tokens/gtokenlockeddepositnft

Initializes the contract with name, symbol, gToken address, design contract, and decimals.

```solidity
constructor(string name, string symbol, address _gToken, contract IGTokenLockedDepositNftDesign _design, uint8 _designDecimals) public
```

--------------------------------

### GET /contest

Source: https://docs.gains.trade/developer/api-reference/endpoint/legacy-contest

Retrieves metadata for legacy contests.

```APIDOC
## GET /contest

### Description
Returns legacy contest metadata.

### Method
GET

### Endpoint
/contest

### Response
#### Success Response (200)
- **object** (object) - Successful response containing legacy contest metadata.
```

--------------------------------

### Initialize Trading Storage

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnstradingstorage

Sets up the initial addresses for GNS, staking, and supported collaterals.

```solidity
function initializeTradingStorage(address _gns, address _gnsStaking, address[] _collaterals, address[] _gTokens) external
```

--------------------------------

### GET /api/contests

Source: https://docs.gains.trade/developer/api-reference/endpoint/contests

Lists all available trading contests.

```APIDOC
## GET /api/contests

### Description
Lists trading contests.

### Method
GET

### Endpoint
/api/contests

### Response
#### Success Response (200)
- **object** (object) - Successful response

#### Error Responses
- **404** - Not found
- **500** - Internal server error
- **503** - Service initializing

### Response Example
{
  "success": true,
  "data": []
}
```

--------------------------------

### Validate Leverage Constraints

Source: https://docs.gains.trade/developer/integrators/guides/v10-migration

Example logic for validating effective leverage against pair-specific maximums.

```typescript
// Example validation
const maxLeverage = isCounterTrade
  ? tradingVariables.pairs[pairIndex].maxLeverageCounterTrade
  : tradingVariables.pairs[pairIndex].maxLeverage;

const isValid = effectiveLeverage <= maxLeverage;
const MIN_LEVERAGE = 0.1; // 0.1x minimum
```

--------------------------------

### Get Collateralization Percentage

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/gtoken

Returns the current collateralization percentage.

```solidity
function collateralizationP() public view returns (uint256)
```

--------------------------------

### Constructor

Source: https://docs.gains.trade/developer/technical-reference/contracts/misc/gnscompensationhandler

Initializes the contract with GNS, staking, and NFT contract references.

```solidity
constructor(contract IERC20 _gns, contract IGNSStaking _staking, contract IERC721[5] _nfts) public
```

--------------------------------

### Initialize contract

Source: https://docs.gains.trade/developer/technical-reference/contracts/tokens/gainsnetworktoken

Constructor setting the initial admin address.

```solidity
constructor(address admin) public
```

--------------------------------

### Get Contract Owner

Source: https://docs.gains.trade/developer/technical-reference/contracts/interfaces/ichainlinkoracle

Returns the address of the contract owner.

```solidity
function owner() external view returns (address)
```

--------------------------------

### GET /rewards/root/{configId}/{epoch}

Source: https://docs.gains.trade/developer/api-reference/endpoint/rewards-root

Returns the rewards Merkle root for a config and epoch.

```APIDOC
## GET /rewards/root/{configId}/{epoch}

### Description
Returns the rewards Merkle root for a config and epoch.

### Method
GET

### Endpoint
/rewards/root/{configId}/{epoch}

### Parameters
#### Path Parameters
- **configId** (string) - Required - Reward config ID.
- **epoch** (string) - Required - Epoch ID.

### Response
#### Success Response (200)
- **object** (object) - Successful response containing the Merkle root data.
```

--------------------------------

### Initialize Function

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/gnsstaking

Initializes the contract with owner and token addresses.

```solidity
function initialize(address _owner, contract IERC20 _gns, contract IERC20 _dai) external
```

--------------------------------

### GET /contests

Source: https://docs.gains.trade/developer/integrators/contests

Retrieves a list of all available trading contests.

```APIDOC
## GET /contests

### Description
Retrieves a list of all available trading contests.

### Method
GET

### Endpoint
/contests

### Response
#### Success Response (200)
- **id** (string) - Contest identifier
- **start** (number) - Start timestamp in Unix milliseconds
- **end** (number) - End timestamp in Unix milliseconds
- **chains** (array) - Supported blockchain networks
- **isActive** (boolean) - Whether the contest is currently active

#### Response Example
[
  {
    "id": "trickortrade",
    "start": 1729608000000,
    "end": 1732026000000,
    "chains": ["arbitrum"],
    "isActive": true
  }
]
```

--------------------------------

### OiWindowsSettingsInitialized event

Source: https://docs.gains.trade/developer/technical-reference/contracts/interfaces/libraries/ipriceimpactutils

Emitted once when the Open Interest windows settings are initialized.

```solidity
event OiWindowsSettingsInitialized(uint48 windowsDuration, uint48 windowsCount)
```

--------------------------------

### Get Ally and Referrer Details

Source: https://docs.gains.trade/developer/technical-reference/contracts/libraries/referralsutils

Functions to fetch specific details for allies and referrers.

```solidity
function getAllyDetails(address _ally) internal view returns (struct IReferrals.AllyDetails)
```

```solidity
function getReferrerDetails(address _referrer) internal view returns (struct IReferrals.ReferrerDetails)
```

--------------------------------

### GET /health

Source: https://docs.gains.trade/developer/api-reference/endpoint/health

Checks the health status of the backend service.

```APIDOC
## GET /health

### Description
Check backend service health.

### Method
GET

### Endpoint
/health

### Response
#### Success Response (200)
- **status** (object) - Successful response indicating the service is healthy.
```

--------------------------------

### initialize

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/gtoken

Initializes the GToken contract with meta information, contract addresses, and various operational parameters.

```APIDOC
## initialize

### Description
Initializes the GToken contract with the provided configuration parameters.

### Signature
`function initialize(struct IGToken.Meta _meta, struct IGToken.ContractAddresses _contractAddresses, uint256 _MIN_LOCK_DURATION, uint256 _maxAccOpenPnlDelta, uint256 _maxDailyAccPnlDelta, uint256[2] _withdrawLockThresholdsP, uint256 _maxSupplyIncreaseDailyP, uint256 _lossesBurnP, uint256 _maxGnsSupplyMintDailyP, uint256 _maxDiscountP, uint256 _maxDiscountThresholdP) external`
```

--------------------------------

### GET /contest/final-open-pnl

Source: https://docs.gains.trade/developer/api-reference/endpoint/legacy-contest-final-open-pnl

Retrieves the final open PnL snapshots for legacy contests.

```APIDOC
## GET /contest/final-open-pnl

### Description
Returns final open PnL snapshots for legacy contests.

### Method
GET

### Endpoint
/contest/final-open-pnl

### Response
#### Success Response (200)
- **object** (JSON) - Successful response containing the PnL snapshots.
```

--------------------------------

### Fetch Leaderboard via cURL

Source: https://docs.gains.trade/developer/api-reference/endpoint/leaderboard

Example request to retrieve the 7-day leaderboard for the Arbitrum network.

```bash
curl -X GET "https://backend-global.gains.trade/api/leaderboard/7?chainId=42161"
```

--------------------------------

### initializeV3

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/gtoken

Performs version 3 initialization for the GToken contract.

```APIDOC
## initializeV3

### Description
Initializes the contract to version 3.

### Signature
`function initializeV3() external`
```

--------------------------------

### Get LINK Fee

Source: https://docs.gains.trade/developer/technical-reference/contracts/libraries/priceaggregatorutils

Retrieves the LINK fee for a specific position.

```solidity
function getLinkFee(uint8 _collateralIndex, address _trader, uint16 _pairIndex, uint256 _positionSizeCollateral) public view returns (uint256)
```

--------------------------------

### Get TWAP Interval

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnspriceaggregator

Returns the configured TWAP interval in seconds.

```solidity
function getTwapInterval() external view returns (uint24)
```

--------------------------------

### Define OiWindowsSettings struct

Source: https://docs.gains.trade/developer/technical-reference/contracts/interfaces/types/ipriceimpact

Defines the configuration settings for open interest windows.

```solidity
struct OiWindowsSettings {
  uint48 startTs;
  uint48 windowsDuration;
  uint48 windowsCount;
}
```

--------------------------------

### getOiWindowsSettings

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnspriceimpact

Retrieves the current configuration settings for price impact windows.

```APIDOC
## getOiWindowsSettings

### Description
Returns current price impact windows settings.

### Signature
`function getOiWindowsSettings() external view returns (struct IPriceImpact.OiWindowsSettings)`
```

--------------------------------

### getOiWindowsSettings

Source: https://docs.gains.trade/images/hJFnQOm8d3mjVbW14zgc-gnsmulticollatdiamond.json

Retrieves the configuration settings for open interest windows.

```APIDOC
## getOiWindowsSettings

### Description
Returns the start timestamp, window duration, and total window count settings.
```

--------------------------------

### Prepare Callback Values

Source: https://docs.gains.trade/developer/technical-reference/contracts/libraries/updateleverage/updateleveragelifecycles

Calculates the necessary values for the leverage update callback process.

```solidity
function _prepareCallbackValues(struct ITradingStorage.Trade _existingTrade, struct ITradingStorage.Trade _pendingTrade, bool _isIncrease) internal view returns (struct IUpdateLeverage.UpdateLeverageValues values)
```

--------------------------------

### Get Ally Details

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnsreferrals

Retrieves the details for a specific ally address.

```solidity
function getAllyDetails(address _ally) external view returns (struct IReferrals.AllyDetails)
```

--------------------------------

### Get Authorization Status

Source: https://docs.gains.trade/developer/technical-reference/contracts/interfaces/ichainlinkoracle

Retrieves the authorization status for a given address.

```solidity
function getAuthorizationStatus(address) external view returns (bool)
```

--------------------------------

### Initialize OTC Configuration

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnsotc

Sets the initial OTC configuration using the provided IOtc.OtcConfig struct.

```solidity
function initializeOtc(struct IOtc.OtcConfig _config) external
```

--------------------------------

### GET /api/trading-history/24h

Source: https://docs.gains.trade/developer/integrators/guides/history-endpoints-migration

Fetches the 24-hour trading history for a specific chain.

```APIDOC
## GET /api/trading-history/24h

### Description
Retrieves the 24-hour trading history data.

### Method
GET

### Endpoint
/api/trading-history/24h

### Parameters
#### Query Parameters
- **chainId** (integer) - Required - The ID of the chain to fetch data for.
```

--------------------------------

### GET /rewards/root/all/{configId}/{epoch}

Source: https://docs.gains.trade/developer/api-reference/endpoint/rewards-root-all

Returns all rewards Merkle roots matching a config and epoch.

```APIDOC
## GET /rewards/root/all/{configId}/{epoch}

### Description
Returns all rewards Merkle roots matching a config and epoch.

### Method
GET

### Endpoint
/rewards/root/all/{configId}/{epoch}

### Parameters
#### Path Parameters
- **configId** (string) - Required - Reward config ID.
- **epoch** (string) - Required - Epoch ID.

### Request Example
curl -X GET "https://backend-arbitrum.gains.trade/rewards/root/all/config-id/1"

### Response
#### Success Response (200)
- **object** (object) - Successful response containing rewards Merkle roots.
```

--------------------------------

### GET /api/referrals/links/{link}/address

Source: https://docs.gains.trade/developer/api-reference/endpoint/referral-link-address

Resolves a referral slug to an address.

```APIDOC
## GET /api/referrals/links/{link}/address

### Description
Resolves a referral slug to an address.

### Method
GET

### Endpoint
/api/referrals/links/{link}/address

### Parameters
#### Path Parameters
- **link** (string) - Required - Referral slug.

### Request Example
curl -X GET "https://backend-global.gains.trade/api/referrals/links/referral-code/address"

### Response
#### Success Response (200)
- **object** - Successful response

#### Error Responses (404, 500)
- **error** (string) - Error description
- **message** (string) - Error message
- **success** (boolean) - Success status
```

--------------------------------

### Initialize Callbacks

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnstradingcallbacks

Sets the initial vault closing fee percentage.

```solidity
function initializeCallbacks(uint8 _vaultClosingFeeP) external
```

--------------------------------

### Initialize Group Liquidation Parameters

Source: https://docs.gains.trade/developer/technical-reference/contracts/libraries/pairsstorageutils

Initializes the liquidation parameters for trading groups.

```solidity
function initializeGroupLiquidationParams(struct IPairsStorage.GroupLiquidationParams[] _groupLiquidationParams) internal
```

--------------------------------

### GET /api/referrals/addresses/{address}/link

Source: https://docs.gains.trade/developer/api-reference/endpoint/referral-address-link

Resolves a referral address to a slug.

```APIDOC
## GET /api/referrals/addresses/{address}/link

### Description
Resolves a referral address to a slug.

### Method
GET

### Endpoint
/api/referrals/addresses/{address}/link

### Parameters
#### Path Parameters
- **address** (string) - Required - Referrer address.

### Response
#### Success Response (200)
- **object** - Successful response

#### Error Responses
- **404** - Not found
- **500** - Internal server error
```

--------------------------------

### Initialize Virtual Order Book

Source: https://docs.gains.trade/developer/integrators/guides/building-the-virtual-order-book

Example of initializing the virtual order book for a specific trading pair and collateral type.

```typescript
const btcUsdcVob = await buildVirtualOrderBook(
  "https://backend-arbitrum.gains.trade",
  0, // BTC/USD
  3  // USDC collateral on Arbitrum; verify the index from collaterals for your chain
);

console.log(btcUsdcVob);
```

--------------------------------

### GET /contest/pnl

Source: https://docs.gains.trade/developer/api-reference/endpoint/legacy-contest-pnl

Retrieves the legacy contest PnL history cache.

```APIDOC
## GET /contest/pnl

### Description
Returns legacy contest PnL history cache.

### Method
GET

### Endpoint
/contest/pnl

### Response
#### Success Response (200)
- **data** (object) - Successful response containing the PnL history cache.
```

--------------------------------

### GET /open-trades-info

Source: https://docs.gains.trade/developer/api-reference/endpoint/core-open-trades-info

Retrieves metadata and indexes for known open trades.

```APIDOC
## GET /open-trades-info

### Description
Returns metadata and indexes for known open trades.

### Method
GET

### Endpoint
/open-trades-info

### Response
#### Success Response (200)
- **object** (json) - Successful response containing metadata and indexes for known open trades.
```

--------------------------------

### Associate Wallet cURL Request

Source: https://docs.gains.trade/developer/api-reference/endpoint/associate-wallet

Example of how to trigger the wallet association endpoint using cURL.

```bash
curl -X POST "https://backend-global.gains.trade/api/dapp/wallet/associate"
```

--------------------------------

### GET /pending-events

Source: https://docs.gains.trade/developer/api-reference/endpoint/core-pending-events

Retrieves the pending backend event queue data.

```APIDOC
## GET /pending-events

### Description
Returns pending backend event queue data.

### Method
GET

### Endpoint
/pending-events

### Response
#### Success Response (200)
- **data** (object) - The pending backend event queue data.
```

--------------------------------

### initialize

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/abstract/gnsaddressstore

Initializes the address store facet with the specified roles manager address.

```APIDOC
## initialize

### Description
Initializes the address store facet.

### Parameters
- **_rolesManager** (address) - Required - The address of the roles manager.
```

--------------------------------

### GET /api/dapp/latest

Source: https://docs.gains.trade/developer/api-reference/endpoint/latest-dapp

Retrieves the latest frontend version metadata for a specified dapp mode.

```APIDOC
## GET /api/dapp/latest

### Description
Returns latest frontend version metadata for a dapp mode.

### Method
GET

### Endpoint
/api/dapp/latest

### Parameters
#### Query Parameters
- **dapp** (string) - Optional - Dapp mode.

### Request Example
curl -X GET "https://backend-global.gains.trade/api/dapp/latest?dapp=evm"

### Response
#### Success Response (200)
- **object** (object) - Returns the latest frontend version metadata.

#### Error Response (500)
- **error** (string) - Error description.
- **message** (string) - Error message.
- **success** (boolean) - Status of the request.
```

--------------------------------

### GET /trading-variables/all

Source: https://docs.gains.trade/developer/api-reference/endpoint/core-trading-variables-all

Retrieves all cached trading variables from the trading backend.

```APIDOC
## GET /trading-variables/all

### Description
Returns all cached trading variables from the trading backend.

### Method
GET

### Endpoint
/trading-variables/all

### Response
#### Success Response (200)
- **body** (object) - A JSON object containing all cached trading variables.
```

--------------------------------

### Get Referral Fee Percentages and Volume

Source: https://docs.gains.trade/developer/technical-reference/contracts/libraries/referralsutils

Functions to retrieve configuration values for referral fees and target volume.

```solidity
function getReferralsAllyFeeP() internal view returns (uint256)
```

```solidity
function getReferralsStartReferrerFeeP() internal view returns (uint256)
```

```solidity
function getReferralsTargetVolumeUsd() internal view returns (uint256)
```

--------------------------------

### initialize

Source: https://docs.gains.trade/images/hJFnQOm8d3mjVbW14zgc-gnsmulticollatdiamond.json

Initializes the contract with the governance timelock address.

```APIDOC
## initialize

### Description
Sets the initial governance timelock address for the contract.

### Parameters
- **_govTimelock** (address) - Required - The address of the governance timelock.
```

--------------------------------

### UpdatedStartReferrerFeeP Event

Source: https://docs.gains.trade/developer/technical-reference/contracts/interfaces/libraries/ireferralsutils

Emitted when the start referrer fee percentage is updated.

```solidity
event UpdatedStartReferrerFeeP(uint256 value)
```

--------------------------------

### Get GToken Address

Source: https://docs.gains.trade/developer/technical-reference/contracts/libraries/tradingstorageutils

Retrieves the address of the GToken for a given collateral index.

```solidity
function getGToken(uint8 _collateralIndex) external view returns (address)
```

--------------------------------

### Get Token URI

Source: https://docs.gains.trade/developer/technical-reference/contracts/tokens/gtokenlockeddepositnft

Returns the metadata URI for a given token ID.

```solidity
function tokenURI(uint256 tokenId) public view returns (string)
```

--------------------------------

### getReferralsStartReferrerFeeP

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnsreferrals

Retrieves the starting referrer fee percentage applied when zero volume has been referred.

```APIDOC
## getReferralsStartReferrerFeeP

### Description
Returns the start referrer fee percentage of the total referral fee when zero volume was referred.
```

--------------------------------

### Get USD Normalized Value

Source: https://docs.gains.trade/developer/technical-reference/contracts/libraries/priceaggregatorutils

Normalizes a collateral value to its USD equivalent.

```solidity
function getUsdNormalizedValue(uint8 _collateralIndex, uint256 _collateralValue) public view returns (uint256)
```

--------------------------------

### Define OiWindowsSettings

Source: https://docs.gains.trade/developer/technical-reference/sdk/client-types

Configuration settings for Open Interest windows.

```typescript
type OiWindowsSettings = {
    startTs: number;
    windowsDuration: number;
    windowsCount: number;
};
```

--------------------------------

### GET /api/dapp/latest/{mode}

Source: https://docs.gains.trade/developer/api-reference/endpoint/latest-dapp-by-mode

Returns the latest frontend version metadata for a given Dapp mode.

```APIDOC
## GET /api/dapp/latest/{mode}

### Description
Returns latest frontend version metadata for a mode path parameter.

### Method
GET

### Endpoint
/api/dapp/latest/{mode}

### Parameters
#### Path Parameters
- **mode** (string) - Required - Dapp mode.

### Request Example
curl -X GET "https://backend-global.gains.trade/api/dapp/latest/evm"

### Response
#### Success Response (200)
- **response** (object) - Returns the latest frontend version metadata.

#### Error Response (500)
- **error** (string) - Error description
- **message** (string) - Detailed error message
- **success** (boolean) - Status of the request
```

--------------------------------

### Valuation and Configuration View Functions

Source: https://docs.gains.trade/developer/technical-reference/contracts/interfaces/igtoken

Read-only functions to retrieve token metrics and configuration parameters.

```solidity
function tvl() external view returns (uint256)
```

```solidity
function marketCap() external view returns (uint256)
```

```solidity
function shareToAssetsPrice() external view returns (uint256)
```

```solidity
function collateralConfig() external view returns (uint128, uint128)
```

--------------------------------

### Get Wrapped Native Token

Source: https://docs.gains.trade/developer/technical-reference/contracts/libraries/tradinginteractionsutils

Retrieves the address of the wrapped native token.

```solidity
function getWrappedNativeToken() internal view returns (address)
```

--------------------------------

### Get Pair Depth

Source: https://docs.gains.trade/developer/technical-reference/contracts/libraries/priceimpactutils

Retrieves the depth configuration for a specific pair index.

```solidity
function getPairDepth(uint256 _pairIndex) internal view returns (struct IPriceImpact.PairDepth)
```

--------------------------------

### Initialize GNSAddressStore

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/abstract/gnsaddressstore

Initializes the address store facet with the specified roles manager address.

```solidity
function initialize(address _rolesManager) external
```

--------------------------------

### Get Current Contracts Version

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnstradingstorage

Returns the current version of the trading contracts.

```solidity
function getCurrentContractsVersion() external pure returns (enum ITradingStorage.ContractsVersion)
```

--------------------------------

### getOiWindows

Source: https://docs.gains.trade/images/hJFnQOm8d3mjVbW14zgc-gnsmulticollatdiamond.json

Retrieves open interest data for multiple windows.

```APIDOC
## getOiWindows

### Description
Returns an array of long and short open interest data for a list of window IDs.

### Parameters
- **_windowsDuration** (uint48) - Duration of the windows.
- **_pairIndex** (uint256) - Index of the pair.
- **_windowIds** (uint256[]) - List of window IDs.
```

--------------------------------

### initializeCallbacks

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnstradingcallbacks

Initializes the vault closing fee percentage.

```APIDOC
## initializeCallbacks

### Description
Initializes the vault closing fee percentage.

### Signature
`function initializeCallbacks(uint8 _vaultClosingFeeP) external`

### Parameters
- **_vaultClosingFeeP** (uint8) - The % of closing fee going to vault
```

--------------------------------

### Get Limit Job ID

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnspriceaggregator

Returns the bytes32 identifier for the limit job.

```solidity
function getLimitJobId() external view returns (bytes32)
```

--------------------------------

### Fetch Rewards Roots via cURL

Source: https://docs.gains.trade/developer/api-reference/endpoint/rewards-root-all

Example request to retrieve rewards roots for a specific configuration and epoch.

```bash
curl -X GET "https://backend-arbitrum.gains.trade/rewards/root/all/config-id/1"
```

--------------------------------

### Get Market Job ID

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnspriceaggregator

Returns the bytes32 identifier for the market job.

```solidity
function getMarketJobId() external view returns (bytes32)
```

--------------------------------

### Get Traders Count

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnstradingstorage

Returns the total number of traders currently stored.

```solidity
function getTradersCount() external view returns (uint256)
```

--------------------------------

### Initialize Price Aggregator

Source: https://docs.gains.trade/developer/technical-reference/contracts/libraries/priceaggregatorutils

Initializes the price aggregator with necessary feeds, oracles, and liquidity pool configurations.

```solidity
function initializePriceAggregator(address _linkErc677, contract IChainlinkFeed _linkUsdPriceFeed, uint24 _twapInterval, uint8 _minAnswers, address[] _oracles, bytes32[2] _jobIds, uint8[] _collateralIndices, struct IPriceAggregator.LiquidityPoolInput[] _gnsCollateralLiquidityPools, contract IChainlinkFeed[] _collateralUsdPriceFeeds) external
```

--------------------------------

### Initialize GTokenRateProvider

Source: https://docs.gains.trade/developer/technical-reference/contracts/misc/gtokenrateprovider

Constructor for initializing the provider with a specific gToken instance.

```solidity
constructor(contract IGToken _gToken) public
```

--------------------------------

### Get Trading Activated State

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnstradingstorage

Returns the current trading activated state.

```solidity
function getTradingActivated() external view returns (enum ITradingStorage.TradingActivated)
```

--------------------------------

### Get Collateral Index

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnstradingstorage

Returns the index associated with a specific collateral address.

```solidity
function getCollateralIndex(address _collateral) external view returns (uint8)
```

--------------------------------

### Initialize Group Liquidation Parameters

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnspairsstorage

Sets liquidation parameters for all existing groups based on the provided array.

```solidity
function initializeGroupLiquidationParams(struct IPairsStorage.GroupLiquidationParams[] _groupLiquidationParams) external
```

--------------------------------

### Get Locked Deposit

Source: https://docs.gains.trade/developer/technical-reference/contracts/interfaces/igtoken

Retrieves the details of a specific locked deposit by its ID.

```solidity
function getLockedDeposit(uint256 depositId) external view returns (struct IGToken.LockedDeposit)
```

--------------------------------

### Fetch current pair prices

Source: https://docs.gains.trade/developer/integrators/guides/building-the-virtual-order-book

Retrieves the initial price snapshot for pairs from the pricing backend.

```bash
curl "https://backend-pricing.eu.gains.trade/charts"
```

--------------------------------

### Get owner of a token

Source: https://docs.gains.trade/developer/technical-reference/contracts/interfaces/ierc721

Returns the address of the owner of the specified token ID.

```solidity
function ownerOf(uint256) external view returns (address)
```

--------------------------------

### initializeBorrowingFeePerBlockCap

Source: https://docs.gains.trade/images/hJFnQOm8d3mjVbW14zgc-gnsmulticollatdiamond.json

Initializes the borrowing fee per block cap configuration.

```APIDOC
## initializeBorrowingFeePerBlockCap

### Description
Initializes the borrowing fee per block cap settings.

### Parameters
- **_feePerBlockCap** (tuple) - Required - The cap configuration containing minP (uint32) and maxP (uint32).
```

--------------------------------

### GET /trading-history-24h

Source: https://docs.gains.trade/developer/integrators/backend

Provides all open & closed trades in the last 24 hours.

```APIDOC
## GET /trading-history-24h

### Description
Provides all open & closed trades in the last 24 hours.

### Method
GET

### Endpoint
/trading-history-24h

### Response
#### Success Response (200)
- **Array** (object) - A list of trade records from the last 24 hours.
```

--------------------------------

### Prepare Callback Values in Solidity

Source: https://docs.gains.trade/developer/technical-reference/contracts/libraries/updatepositionsize/increasepositionsizeutils

Calculates the necessary values for a trade callback based on existing and partial trade data.

```solidity
function prepareCallbackValues(struct ITradingStorage.Trade _existingTrade, struct ITradingStorage.Trade _partialTrade, struct ITradingCallbacks.AggregatorAnswer _answer) internal view returns (struct IUpdatePositionSize.IncreasePositionSizeValues values)
```

--------------------------------

### Constructor for GNSOtc

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnsotc

Initializes the GNSOtc facet.

```solidity
constructor() public
```

--------------------------------

### GET /api/personal-trading-history/:address/stats

Source: https://docs.gains.trade/developer/integrators/guides/history-endpoints-migration

Fetches all-time trader statistics for a specific address.

```APIDOC
## GET /api/personal-trading-history/:address/stats

### Description
Retrieves all-time statistics for a specific trader without fetching full trade history.

### Method
GET

### Endpoint
/api/personal-trading-history/:address/stats

### Parameters
#### Path Parameters
- **address** (string) - Required - The wallet address.

#### Query Parameters
- **chainId** (integer) - Required - The chain ID.

### Response
#### Success Response (200)
- **totalVolume** (number) - Total trading volume.
- **totalTrades** (integer) - Total number of trades.
- **winRate** (number) - Win rate percentage.
- **thirtyDayVolume** (number) - Volume over the last 30 days.
```

--------------------------------

### GET /rewards/all/{configId}/{epoch}/{address}

Source: https://docs.gains.trade/developer/api-reference/endpoint/rewards-all-by-address

Returns all rewards for a specific address based on the provided configuration ID and epoch.

```APIDOC
## GET /rewards/all/{configId}/{epoch}/{address}

### Description
Returns all rewards for one address.

### Method
GET

### Endpoint
/rewards/all/{configId}/{epoch}/{address}

### Parameters
#### Path Parameters
- **configId** (string) - Required - Reward config ID.
- **epoch** (string) - Required - Epoch ID.
- **address** (string) - Required - Wallet address.

### Request Example
curl -X GET "https://backend-arbitrum.gains.trade/rewards/all/config-id/1/0x0000000000000000000000000000000000000000"

### Response
#### Success Response (200)
- **response** (object) - Successful response containing reward data.
```

--------------------------------

### GET /contests/:id

Source: https://docs.gains.trade/developer/integrators/contests

Retrieves detailed information and statistics for a specific contest.

```APIDOC
## GET /contests/:id

### Description
Retrieves detailed information and statistics for a specific contest.

### Method
GET

### Endpoint
/contests/:id

### Parameters
#### Path Parameters
- **id** (string) - Required - The unique identifier of the contest

### Response
#### Success Response (200)
- **id** (string) - Contest identifier
- **start** (number) - Start timestamp
- **end** (number) - End timestamp
- **stats** (object) - Aggregated contest statistics
- **rewards** (object) - Reward structure details

#### Response Example
{
  "id": "trickortrade",
  "start": 1729608000000,
  "end": 1732026000000,
  "chains": ["arbitrum"],
  "isActive": true,
  "stats": {
    "totalTraders": 1247,
    "totalTrades": 8931,
    "totalPnl": 125430.5,
    "totalVolumePoints": 9847231.25,
    "top300VolumePoints": 8234192.1
  },
  "rewards": {
    "pnlAbsolute": { "1": 40000, "2": 20000, "3": 15000 },
    "volume": { "proportional": true, "pool": 200000, "topN": 300 }
  }
}
```

--------------------------------

### GET /charts

Source: https://docs.gains.trade/developer/integrators/price-feed

Fetches the current OHLC snapshot for all available trading pairs.

```APIDOC
## GET /charts

### Description
Fetches the current OHLC snapshot for each pair. The response provides a comprehensive list of OHLC data where pairId corresponds to the index in the arrays.

### Method
GET

### Endpoint
https://backend-pricing.eu.gains.trade/charts

### Response
#### Success Response (200)
- **time** (number) - Timestamp of the snapshot
- **opens** (array) - List of opening prices
- **highs** (array) - List of high prices
- **lows** (array) - List of low prices
- **closes** (array) - List of closing prices

#### Response Example
{
  "time": 1724244390036,
  "opens": [100.0, 50000.0],
  "highs": [101.0, 50100.0],
  "lows": [99.0, 49900.0],
  "closes": [100.5, 50050.0]
}
```

--------------------------------

### initializeTradingStorage

Source: https://docs.gains.trade/images/hJFnQOm8d3mjVbW14zgc-gnsmulticollatdiamond.json

Initializes the trading storage contract with the provided addresses for GNS, staking, collaterals, and gTokens.

```APIDOC
## initializeTradingStorage

### Description
Initializes the trading storage contract with the provided addresses for GNS, staking, collaterals, and gTokens.

### Parameters
- **_gns** (address) - Required
- **_gnsStaking** (address) - Required
- **_collaterals** (address[]) - Required
- **_gTokens** (address[]) - Required
```

--------------------------------

### GET /api/dapp/wallet/associated/{address}

Source: https://docs.gains.trade/developer/api-reference/endpoint/wallet-associations

Retrieves a list of wallets associated with the provided address.

```APIDOC
## GET /api/dapp/wallet/associated/{address}

### Description
Returns wallets associated with a specific address.

### Method
GET

### Endpoint
/api/dapp/wallet/associated/{address}

### Parameters
#### Path Parameters
- **address** (string) - Required - Wallet address.

### Request Example
curl -X GET "https://backend-global.gains.trade/api/dapp/wallet/associated/0x0000000000000000000000000000000000000000"

### Response
#### Success Response (200)
- **object** (object) - Successful response containing associated wallet data.

#### Error Response (500)
- **error** (string) - Error description
- **message** (string) - Detailed error message
- **success** (boolean) - Status indicator
```

--------------------------------

### getOiWindows

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnspriceimpact

Retrieves long and short open interest details for multiple windows.

```APIDOC
## getOiWindows

### Description
Returns multiple OI windows details (long/short OI).

### Signature
`function getOiWindows(uint48 _windowsDuration, uint256 _pairIndex, uint256[] _windowIds) external view returns (struct IPriceImpact.PairOi[])`

### Parameters
- **_windowsDuration** (uint48) - windows duration (seconds)
- **_pairIndex** (uint256) - index of pair
- **_windowIds** (uint256[]) - ids of windows
```

--------------------------------

### initializeOtc

Source: https://docs.gains.trade/developer/technical-reference/contracts/interfaces/libraries/iotcutils

Initializes the OTC facet with the provided configuration.

```APIDOC
## initializeOtc

### Description
Initializes the OTC facet with the provided configuration.

### Signature
`function initializeOtc(struct IOtc.OtcConfig _config) external`

### Parameters
- **_config** (IOtc.OtcConfig) - Required - The new OTC configuration object.
```

--------------------------------

### GET /api/vip/{address}

Source: https://docs.gains.trade/developer/api-reference/endpoint/vip-status

Retrieves the VIP status for a given wallet address.

```APIDOC
## GET /api/vip/{address}

### Description
Returns the VIP status for a specified wallet address.

### Method
GET

### Endpoint
/api/vip/{address}

### Parameters
#### Path Parameters
- **address** (string) - Required - Wallet address.

### Request Example
curl -X GET "https://backend-global.gains.trade/api/vip/0x0000000000000000000000000000000000000000"

### Response
#### Success Response (200)
- **object** (object) - Successful response containing VIP status details.

#### Error Response (500)
- **error** (string) - Error description
- **message** (string) - Error message
- **success** (boolean) - Success status
```

--------------------------------

### GET /api/stats

Source: https://docs.gains.trade/developer/api-reference/endpoint/stats

Retrieves protocol and trading statistics for a specified blockchain chain.

```APIDOC
## GET /api/stats

### Description
Returns protocol and trading statistics for a chain.

### Method
GET

### Endpoint
/api/stats

### Parameters
#### Query Parameters
- **chainId** (integer) - Required - Blockchain chain ID. Common values: 42161 Arbitrum, 8453 Base, 137 Polygon.

### Request Example
curl -X GET "https://backend-global.gains.trade/api/stats?chainId=42161"

### Response
#### Success Response (200)
- **stats** (array) - List of protocol and trading statistics.

#### Error Responses (500, 503)
- **error** (string) - Error description
- **message** (string) - Error message
- **success** (boolean) - Success status
```

--------------------------------

### Initialize New Fees

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnspairsstorage

Migrates existing fee groups and initializes global trade fee parameters.

```solidity
function initializeNewFees(struct IPairsStorage.GlobalTradeFeeParams _tradeFeeParams) external
```

--------------------------------

### GET /api/total-supply

Source: https://docs.gains.trade/developer/api-reference/endpoint/total-supply

Returns the latest GNS total supply from cached stats.

```APIDOC
## GET /api/total-supply

### Description
Returns the latest GNS total supply from cached stats.

### Method
GET

### Endpoint
/api/total-supply

### Response
#### Success Response (200)
- **totalSupply** (number) - The current total supply of GNS tokens.

#### Response Example
{
  "totalSupply": 100000000
}
```

--------------------------------

### Initialize Trading Parameters

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnstradinginteractions

Sets the initial market order timeout blocks and authorized users for trigger link cost bypass.

```solidity
function initializeTrading(uint16 _marketOrdersTimeoutBlocks, address[] _usersByPassTriggerLink) external
```

--------------------------------

### GET /api/notifications/{address}

Source: https://docs.gains.trade/developer/api-reference/endpoint/notifications

Retrieves active notifications for a specified wallet address.

```APIDOC
## GET /api/notifications/{address}

### Description
Returns active notifications for a wallet.

### Method
GET

### Endpoint
/api/notifications/{address}

### Parameters
#### Path Parameters
- **address** (string) - Required - Wallet address.

### Request Example
curl -X GET "https://backend-global.gains.trade/api/notifications/0x0000000000000000000000000000000000000000"

### Response
#### Success Response (200)
- **object** (object) - Successful response

#### Error Response (500)
- **error** (string) - Error description
- **message** (string) - Error message
- **success** (boolean) - Success status
```

--------------------------------

### Initialize New Fees

Source: https://docs.gains.trade/developer/technical-reference/contracts/libraries/pairsstorageutils

Initializes global trade fee parameters.

```solidity
function initializeNewFees(struct IPairsStorage.GlobalTradeFeeParams _tradeFeeParams) internal
```

--------------------------------

### GET /contest/rewards

Source: https://docs.gains.trade/developer/api-reference/endpoint/legacy-contest-rewards

Retrieves legacy contest rewards data from the trading backend.

```APIDOC
## GET /contest/rewards

### Description
Returns legacy contest rewards data.

### Method
GET

### Endpoint
/contest/rewards

### Response
#### Success Response (200)
- **data** (object) - Legacy contest rewards data.
```

--------------------------------

### Constructor and Modifiers

Source: https://docs.gains.trade/developer/technical-reference/contracts/misc/epochbasedtokenclaim

Initialization logic and access control modifiers.

```solidity
constructor(contract IERC20 _rewardToken, address _owner, address _manager) public
```

```solidity
modifier onlyManager()
```

--------------------------------

### GET /contest/leaderboard

Source: https://docs.gains.trade/developer/api-reference/endpoint/legacy-contest-leaderboard

Retrieves the legacy contest leaderboard cache from the trading backend.

```APIDOC
## GET /contest/leaderboard

### Description
Returns the legacy contest leaderboard cache.

### Method
GET

### Endpoint
/contest/leaderboard

### Response
#### Success Response (200)
- **data** (object) - Successful response containing the leaderboard cache.
```

--------------------------------

### initializeV2

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/gnsstaking

Initializes the contract to support DAI as a reward token. This must be called immediately after contract updates to prevent revert errors in reward distribution.

```APIDOC
## initializeV2

### Description
Adds DAI as a reward token. This is a necessary initialization step after contract updates to ensure distributeRewardDai() functions correctly.

### Signature
`function initializeV2() external`
```

--------------------------------

### initializeChainConfig

Source: https://docs.gains.trade/images/hJFnQOm8d3mjVbW14zgc-gnsmulticollatdiamond.json

Initializes the chain configuration for native transfers.

```APIDOC
## function initializeChainConfig(uint16 _nativeTransferGasLimit, bool _nativeTransferEnabled)

### Description
Sets the initial gas limit and enabled status for native transfers.

### Parameters
- **_nativeTransferGasLimit** (uint16) - The gas limit to set.
- **_nativeTransferEnabled** (bool) - Whether to enable native transfers.
```

--------------------------------

### GET /contest/results

Source: https://docs.gains.trade/developer/api-reference/endpoint/legacy-contest-results

Retrieves legacy contest results data from the trading backend.

```APIDOC
## GET /contest/results

### Description
Returns legacy contest results data.

### Method
GET

### Endpoint
/contest/results

### Request Example
curl -X GET "https://backend-arbitrum.gains.trade/contest/results"

### Response
#### Success Response (200)
- **data** (object) - Successful response containing legacy contest results.
```

--------------------------------

### GET /contest/pnl-percent

Source: https://docs.gains.trade/developer/api-reference/endpoint/legacy-contest-pnl-percent

Retrieves the legacy contest percentage PnL history cache.

```APIDOC
## GET /contest/pnl-percent

### Description
Returns legacy contest percentage PnL history cache.

### Method
GET

### Endpoint
/contest/pnl-percent

### Response
#### Success Response (200)
- **body** (object) - Successful response containing the PnL history cache.
```

--------------------------------

### GET /open-trades

Source: https://docs.gains.trade/developer/api-reference/endpoint/core-open-trades

Retrieves a list of all known open trades from the trading backend.

```APIDOC
## GET /open-trades

### Description
Returns all known open trades from the trading backend.

### Method
GET

### Endpoint
/open-trades

### Response
#### Success Response (200)
- **object** (json) - A JSON object containing the list of open trades.

### Response Example
{
  "trades": []
}
```

--------------------------------

### Fetch VIP Status via cURL

Source: https://docs.gains.trade/developer/api-reference/endpoint/vip-status

Example request to retrieve VIP status for a specific wallet address using the command line.

```bash
curl -X GET "https://backend-global.gains.trade/api/vip/0x0000000000000000000000000000000000000000"
```

--------------------------------

### Initialize Price Aggregator

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnspriceaggregator

Configures the price aggregator with necessary Chainlink feeds, nodes, job IDs, and liquidity pool parameters.

```solidity
function initializePriceAggregator(address _linkToken, contract IChainlinkFeed _linkUsdPriceFeed, uint24 _twapInterval, uint8 _minAnswers, address[] _nodes, bytes32[2] _jobIds, uint8[] _collateralIndices, struct IPriceAggregator.LiquidityPoolInput[] _gnsCollateralLiquidityPools, contract IChainlinkFeed[] _collateralUsdPriceFeeds) external
```

--------------------------------

### initializeNewFees

Source: https://docs.gains.trade/developer/technical-reference/contracts/core/facets/gnspairsstorage

Copies all existing fee groups to new mapping, updates leverage multipliers, and initializes new global trade fee parameters.

```APIDOC
## initializeNewFees

### Description
Copies all existing fee groups to new mapping, multiplies existing groups min/max lev by 1e3, and initializes new global trade fee parameters.

### Parameters
- **_tradeFeeParams** (IPairsStorage.GlobalTradeFeeParams) - Required - Global trade fee parameters.
```

--------------------------------

### initializeNewFees

Source: https://docs.gains.trade/images/hJFnQOm8d3mjVbW14zgc-gnsmulticollatdiamond.json

Initializes global trade fee parameters.

```APIDOC
## initializeNewFees

### Description
Updates the global trade fee configuration.

### Parameters
- **_tradeFeeParams** (tuple) - GlobalTradeFeeParams struct containing referralFeeP, govFeeP, triggerOrderFeeP, gnsOtcFeeP, and gTokenFeeP.
```

--------------------------------

### Fee Object Structure

Source: https://docs.gains.trade/developer/integrators/guides/calculating-liquidation-price

Example of the Fee object structure retrieved after calculating the feeIndex.

```typescript
{
    "openFeeP": 0.0003,
    "closeFeeP": 0.0006,
    "minPositionSizeUsd": 10000,
    "triggerOrderFeeP": 0.0002
}
```

--------------------------------

### Get Borrowing Pair Data

Source: https://docs.gains.trade/images/hJFnQOm8d3mjVbW14zgc-gnsmulticollatdiamond.json

Retrieves the borrowing data for a specific pair index.

```json
{
          "internalType": "uint16",
          "name": "_pairIndex",
          "type": "uint16"
        }
      ],
      "name": "getBorrowingPair",
      "outputs": [
        {
          "components": [
            {
              "internalType": "uint32",
              "name": "feePerBlock",
              "type": "uint32"
            },
            {
              "internalType": "uint64",
              "name": "accFeeLong",
              "type": "uint64"
            },
            {
              "internalType": "uint64",
              "name": "accFeeShort",
              "type": "uint64"
            },
            {
              "internalType": "uint48",
              "name": "accLastUpdatedBlock",
              "type": "uint48"
            },
            {
              "internalType": "uint48",
              "name": "feeExponent",
              "type": "uint48"
            }
          ],
          "internalType": "struct IBorrowingFees.BorrowingData",
          "name": "",
          "type": "tuple"
        }
      ],
      "stateMutability": "view",
      "type": "function",
      "signature": "0x5d5bf24d"
    }
```

--------------------------------

### Open a new trade

Source: https://docs.gains.trade/developer/technical-reference/contracts/libraries/tradinginteractionsutils

Opens a trade with specified parameters, slippage, and referrer.

```solidity
function openTrade(struct ITradingStorage.Trade _trade, uint16 _maxSlippageP, address _referrer) internal
```

```solidity
function openTradeNative(struct ITradingStorage.Trade _trade, uint16 _maxSlippageP, address _referrer) internal
```

--------------------------------

### Retrieve Multiple Open Interest Windows

Source: https://docs.gains.trade/developer/technical-reference/contracts/libraries/priceimpactutils

Fetches an array of open interest data for multiple windows of a specific pair.

```solidity
function getOiWindows(uint48 _windowsDuration, uint256 _pairIndex, uint256[] _windowIds) internal view returns (struct IPriceImpact.PairOi[])
```
Tokens:
Raw