Skip to main content
GET
/
{protocol}
/
position
/
{txHash}
Position By txHash
curl --request GET \
  --url https://api.copin.io/{protocol}/position/{txHash}
{
  "id": "<string>",
  "account": "<string>",
  "key": "<string>",
  "logId": 123,
  "openBlockNumber": 123,
  "openBlockTime": "<string>",
  "closeBlockNumber": 123,
  "closeBlockTime": "<string>",
  "indexToken": "<string>",
  "pair": "<string>",
  "size": 123,
  "fee": 123,
  "collateral": 123,
  "averagePrice": 123,
  "funding": 123,
  "pnl": 123,
  "realisedPnl": 123,
  "roi": 123,
  "realisedRoi": 123,
  "isLong": true,
  "isWin": true,
  "isLiquidate": true,
  "leverage": 123,
  "orderCount": 123,
  "orderIncreaseCount": 123,
  "orderDecreaseCount": 123,
  "durationInSecond": 123,
  "status": "<string>",
  "createdAt": "<string>",
  "protocol": "<string>",
  "orders": [
    {
      "id": "<string>",
      "account": "<string>",
      "txHash": "<string>",
      "logId": 123,
      "blockNumber": 123,
      "blockTime": "<string>",
      "key": "<string>",
      "indexToken": "<string>",
      "pair": "<string>",
      "sizeDeltaNumber": 123,
      "sizeNumber": 123,
      "collateralDeltaNumber": 123,
      "priceNumber": 123,
      "feeNumber": 123,
      "fundingRateNumber": 123,
      "fundingNumber": 123,
      "leverage": 123,
      "isLong": true,
      "isOpen": true,
      "isClose": true,
      "type": "<string>",
      "createdAt": "<string>"
    }
  ]
}

​
Authentication

This endpoint requires authentication using a JWT token or API-KEY in the header.
​
Authorization
string
JWT token in the format: Authorization {token}
​
x-api-key
string
Token in the format: x-api-key {api-key}

​
Path Parameters

​
protocol
string
required
The supported protocols include: GMX, KWENTA, POLYNOMIAL, POLYNOMIAL_L2, GMX_V2_AVAX, GMX_V2, GNS, GNS_POLY, GNS_BASE, GNS_APE, LEVEL_BNB, LEVEL_ARB, MUX_ARB, APOLLOX_BNB, AVANTIS_BASE, EQUATION_ARB, LOGX_BLAST, LOGX_MODE, MYX_ARB, DEXTORO, VELA_ARB, HMX_ARB, SYNTHETIX_V3, SYNTHETIX_V3_ARB, KTX_MANTLE, CYBERDEX, YFX_ARB, KILOEX_OPBNB, KILOEX_BNB, KILOEX_MANTA, KILOEX_BASE, ROLLIE_SCROLL, MUMMY_FANTOM, HYPERLIQUID, SYNFUTURE_BASE, MORPHEX_FANTOM, PERENNIAL_ARB, BSX_BASE, DYDX, UNIDEX_ARB, VERTEX_ARB, HORIZON_BNB, HOLDSTATION_ZKSYNC, ZENO_METIS, LINEHUB_LINEA, BMX_BASE, FOXIFY_ARB, APOLLOX_BASE, GMX_AVAX, SYNTHETIX, DEPERP_BASE, ELFI_ARB, PERPETUAL_OP, JUPITER, HOLDSTATION_BERA, GMX_SOL, HYPERLIQUID, OSTIUM_ARB
​
txHash
string
required
The open order transaction hash

​
Request Query

​
logId
string
The open order log id. Goes with the transaction hash
​
account
string
Trader’s account address. Goes with the transaction hash
​
isLong
boolean
Whether the position is long. Goes with the transaction hash

​
Request Example

curl --request GET \
  --url https://api.copin.io/GMX_V2/position/0xe614b4c0eee87864c62ee58d8caf156ab20c414c15212a851054814806513a27 \
  --header 'x-api-key: u9jpUfrTAukk45QjWVg7DBtQYxdGgy'

​
Response:

​
id
string
Unique identifier for the position
​
account
string
Trader’s account address
​
key
string
Unique key for the position
​
logId
number
Log ID
​
openBlockNumber
number
Block number when position was opened
​
openBlockTime
string
Timestamp when position was opened
​
closeBlockNumber
number
Block number when position was closed
​
closeBlockTime
string
Timestamp when position was closed
​
indexToken
string
Token address
​
pair
string
Trading pair
​
size
number
Position size
​
fee
number
Fee paid
​
collateral
number
Collateral amount
​
averagePrice
number
Average entry price
​
funding
number
Funding amount
​
pnl
number
Profit and loss including fee
​
realisedPnl
number
Profit and loss without fee
​
roi
number
Return on investment including fee
​
realisedRoi
number
Return on investment without fee
​
isLong
boolean
Whether position is long
​
isWin
boolean
Whether position is winning
​
isLiquidate
boolean
Whether position was liquidated
​
leverage
number
Leverage used
​
orderCount
number
Number of orders
​
orderIncreaseCount
number
Number of increase orders
​
orderDecreaseCount
number
Number of decrease orders
​
durationInSecond
number
Duration in seconds
​
status
string
Position status (OPEN, CLOSE)
​
createdAt
string
Timestamp when record was created
​
protocol
string
Protocol name
​
orders
array
Array of orders for this position

​
Response Example

[
  {
    "id": "68b013c560ef2b091560eef4",
    "account": "0x35C85d656F3465176dD6906f2F6800C121Ee5BD8",
    "key": "0x79f8ea29781e33491e36df651b09ee3362f1ef994b56308c50475c3ac4e8839e",
    "logId": 28,
    "indexToken": "0x09400D9DB990D5ed3f35D7be61DfAEB900Af03C9",
    "leverage": 49.974536479476136,
    "size": 2449.5118,
    "collateralToken": "49.0201",
    "collateral": 49.01519799,
    "averagePrice": 214.114837,
    "fee": 2.4546069900000003,
    "realisedPnl": 12.291132520720291,
    "pnl": 9.83652553072029,
    "realisedRoi": 25.08,
    "roi": 20.07,
    "isLong": true,
    "openBlockNumber": 373122680,
    "closeBlockNumber": 373123787,
    "durationInSecond": 369,
    "orderCount": 2,
    "orderIncreaseCount": 1,
    "orderDecreaseCount": 1,
    "isWin": true,
    "isLiquidate": false,
    "status": "CLOSE",
    "openBlockTime": "2025-08-28T08:30:57.000Z",
    "closeBlockTime": "2025-08-28T08:35:34.000Z",
    "totalDecreasePnl": 0,
    "closePrice": 215.18922,
    "protocol": "GMX_V2",
    "txHashes": [
      "0xc0abc39677962d8357731c438f59aec1337ea801a40730d7d4a7b47f1210c143",
      "0xe614b4c0eee87864c62ee58d8caf156ab20c414c15212a851054814806513a27"
    ],
    "createdAt": "2025-08-28T08:31:01.132Z",
    "pair": "SOL-USDT",
    "updatedAt": "2025-08-28T08:41:06.162Z"
  }
]