Arkham

Arkham Hypercore API

The Hypercore API from Arkham — 15 operation(s) for hypercore.

GitHub OpenAPI

Documentation

📖
Authentication
https://raw.githubusercontent.com/api-evangelist/arkham/refs/heads/main/authentication/arkham-authentication.yml
📖
RateLimits
https://raw.githubusercontent.com/api-evangelist/arkham/refs/heads/main/rate-limits/arkham-rate-limits.yml

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/arkham/refs/heads/main/openapi/arkham-hypercore-api-openapi.yml

Other Resources

🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/arkham/refs/heads/main/errors/arkham-error-codes.yml
🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/arkham/refs/heads/main/conventions/arkham-conventions.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/arkham/refs/heads/main/data-model/arkham-data-model.yml
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/arkham/refs/heads/main/asyncapi/arkham-websocket-webhooks.yml

OpenAPI Specification

arkham-hypercore-api-openapi.yml Raw ↑ 
openapi: 3.0.0
info:
  title: Arkham Intel Analytics Hypercore API
  version: 1.1.0
tags:
- name: Hypercore
paths:
  /hypercore/account/{address}/active:
    get:
      summary: Check for HyperCore activity
      description: 'Whether a HyperCore address has any HyperCore activity: a spot balance, open perp position, margin, staking, or vault equity.'
      operationId: GetHypercoreAccountActive
      parameters:
      - name: address
        in: path
        description: HyperCore master or sub-account address.
        required: true
        schema:
          type: string
          description: HyperCore master or sub-account address.
          example: '0xECB63caA47c7c4E77F60f1cE858Cf28dC2B82b00'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HypercoreAccountActiveResponse'
              example:
                active: true
                address: '0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00'
        '400':
          description: Bad Request
        '500':
          description: Internal Server Error
      tags:
      - Hypercore
  /hypercore/account/{address}/perp-positions:
    get:
      summary: Get HyperCore perp positions
      description: Open perpetual positions for a HyperCore address (master + sub-accounts) with mark price, unrealized PnL, and per-DEX USDC margin.
      operationId: GetHypercorePerpPositions
      parameters:
      - name: address
        in: path
        description: HyperCore master or sub-account address.
        required: true
        schema:
          type: string
          description: HyperCore master or sub-account address.
          example: '0xECB63caA47c7c4E77F60f1cE858Cf28dC2B82b00'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HypercorePerpPositionsResponse'
              example:
                accountUsdValue: 62831603.012425
                addresses:
                - '0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00'
                - '0x08b095625fb698837fc436c489ce9e4f6ee084c1'
                - '0x152600cac5306fd519ccb2bdd4b18a441443428a'
                - '0x153ae96fafe232f61b9a19c285b8e8e265642f69'
                - '0x37449263a96d00ec4cd68952a3f3c7fd1927d958'
                - '0x4304dc380a4c9a452c58707487e185caf992ff05'
                - '0x6d9f9706d647d19e93164a7217576797358fa8c3'
                - '0x8185204d31602595fadbb9305155e8981762e60c'
                - '0x82578861165b62466f8e11e51efe74455ed0e1a6'
                - '0x88f9bd20b748c3e533374fa201621ceb119ee9db'
                - '0x8af63f51e0c60851a30da696a6a0911a3d019d5e'
                - '0x8fecb60f12fd9a3db6901b8a7703a24fa2ee1268'
                - '0x90e678b96a3d15bac0e109535692be5361571652'
                - '0x91ea0caf217cb0e51d833d9b66464371fb9d1c5b'
                - '0xa3e4be245fa0cbd5df1718c33cb9c08af5796f3b'
                - '0xb3514b307d17e09d2086738b62ac5db371692d9d'
                - '0xba6be69a57e42572df416997af3b7dcdd59ef360'
                - '0xc21f25650fd7165905e94014529261070c4530a3'
                - '0xc64283a986819174aa0b13b22ff9ab55ac2bd394'
                - '0xe78030f0e93def6280f7331edb81db4a3f547633'
                - '0xefee01d3a0d06c188627d98b6aa814f401f87c4b'
                - '0xfa452867a690af8bc0a3aa585facaf8e70e65ef8'
                - '0xff1ec702af93ac3e9537d9e24c2c4750d44cbf75'
                dexBalances:
                - dex: xyz
                  usdcBalance: 10084680.877152
                - dex: vntl
                  usdcBalance: 0
                - dex: cash
                  usdcBalance: 0.004359
                positions:
                - address: '0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00'
                  coin: xyz:XYZ100
                  direction: long
                  entryPx: 28568.39
                  leverageType: cross
                  leverageValue: 3
                  markPx: 28523.999999999996
                  maxLeverage: 30
                  positionValue: 79536.3216
                  szi: 2.7884
                  unrealizedPnl: -123.78444
                - address: '0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00'
                  coin: xyz:TSLA
                  direction: long
                  entryPx: 392.186
                  leverageType: cross
                  leverageValue: 3
                  markPx: 380.03000000000003
                  maxLeverage: 20
                  positionValue: 608103.86441
                  szi: 1600.147
                  underlyingPricingId: tesla-xstock
                  underlyingSymbol: TSLAX
                  unrealizedPnl: -19451.467595
                - address: '0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00'
                  coin: xyz:NVDA
                  direction: long
                  entryPx: 206.302
                  leverageType: cross
                  leverageValue: 3
                  markPx: 203.20000000000002
                  maxLeverage: 20
                  positionValue: 847307.424
                  szi: 4169.82
                  underlyingPricingId: nvidia-xstock
                  underlyingSymbol: NVDAX
                  unrealizedPnl: -12935.268385
                unrealizedPnl: 1015323.5175330002
                usdcBalance: 179763906.134545
        '400':
          description: Bad Request
        '500':
          description: Internal Server Error
      tags:
      - Hypercore
  /hypercore/account/{address}/portfolio-history:
    get:
      summary: Get HyperCore account value / PnL history
      description: Live account-value and PnL time series per timeframe (day, week, month, allTime) for a HyperCore address. Not aggregated across sub-accounts.
      operationId: GetHypercorePortfolioHistory
      parameters:
      - name: address
        in: path
        description: HyperCore master or sub-account address.
        required: true
        schema:
          type: string
          description: HyperCore master or sub-account address.
          example: '0xECB63caA47c7c4E77F60f1cE858Cf28dC2B82b00'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HypercorePortfolioHistoryResponse'
              example:
                address: '0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00'
                periods:
                - accountValue:
                  - time: 1784246344057
                    value: 95092178.097197
                  - time: 1784298591213
                    value: 98859536.656199
                  period: day
                  pnl:
                  - time: 1784224644641
                    value: 849540.7263119817
                  - time: 1784298591213
                    value: 1945082.7996740043
                - accountValue:
                  - time: 1783727877035
                    value: 91759827.573454
                  - time: 1783814323032
                    value: 96805222.506593
                  - time: 1783896617062
                    value: 101532293.403535
                  period: week
                  pnl:
                  - time: 1784073197689
                    value: -2659247.7237069905
                  - time: 1784138060004
                    value: -3659770.578257978
                  - time: 1784224644641
                    value: -2810229.8519459963
        '400':
          description: Bad Request
        '500':
          description: Internal Server Error
      tags:
      - Hypercore
  /hypercore/account/{address}/spot-balances:
    get:
      summary: Get HyperCore spot balances
      description: Spot token balances for a HyperCore address (master + sub-accounts), each valued in USD at the spot mid price.
      operationId: GetHypercoreSpotBalances
      parameters:
      - name: address
        in: path
        description: HyperCore master or sub-account address.
        required: true
        schema:
          type: string
          description: HyperCore master or sub-account address.
          example: '0xECB63caA47c7c4E77F60f1cE858Cf28dC2B82b00'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HypercoreSpotBalancesResponse'
              example:
                addresses:
                - '0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00'
                - '0x08b095625fb698837fc436c489ce9e4f6ee084c1'
                - '0x152600cac5306fd519ccb2bdd4b18a441443428a'
                - '0x153ae96fafe232f61b9a19c285b8e8e265642f69'
                - '0x37449263a96d00ec4cd68952a3f3c7fd1927d958'
                - '0x4304dc380a4c9a452c58707487e185caf992ff05'
                - '0x6d9f9706d647d19e93164a7217576797358fa8c3'
                - '0x8185204d31602595fadbb9305155e8981762e60c'
                - '0x82578861165b62466f8e11e51efe74455ed0e1a6'
                - '0x88f9bd20b748c3e533374fa201621ceb119ee9db'
                - '0x8af63f51e0c60851a30da696a6a0911a3d019d5e'
                - '0x8fecb60f12fd9a3db6901b8a7703a24fa2ee1268'
                - '0x90e678b96a3d15bac0e109535692be5361571652'
                - '0x91ea0caf217cb0e51d833d9b66464371fb9d1c5b'
                - '0xa3e4be245fa0cbd5df1718c33cb9c08af5796f3b'
                - '0xb3514b307d17e09d2086738b62ac5db371692d9d'
                - '0xba6be69a57e42572df416997af3b7dcdd59ef360'
                - '0xc21f25650fd7165905e94014529261070c4530a3'
                - '0xc64283a986819174aa0b13b22ff9ab55ac2bd394'
                - '0xe78030f0e93def6280f7331edb81db4a3f547633'
                - '0xefee01d3a0d06c188627d98b6aa814f401f87c4b'
                - '0xfa452867a690af8bc0a3aa585facaf8e70e65ef8'
                - '0xff1ec702af93ac3e9537d9e24c2c4750d44cbf75'
                balances:
                - address: '0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00'
                  coin: USDC
                  hold: 5417652.57475905
                  token: 0
                  total: 10874813.93987035
                  underlyingPricingId: usd-coin
                  usdPrice: 1
                  usdValue: 5457161.3651113
                - address: '0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00'
                  coin: PURR
                  entryPx: 0.08784222575940936
                  hold: 0
                  token: 1
                  total: 129.21127
                  underlyingPricingId: purr-2
                  underlyingSymbol: PURR
                  unrealizedPnl: -2.1359560693949984
                  usdPrice: 0.0713115
                  usdValue: 9.214249480605002
                - address: '0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00'
                  coin: HFUN
                  hold: 0
                  token: 2
                  total: 0.73279813
                  underlyingPricingId: hypurr-fun
                  underlyingSymbol: HFUN
                  usdPrice: 13.4645
                  usdValue: 9.866760421385
                totalUsdValue: 16717217.12361454
        '400':
          description: Bad Request
        '500':
          description: Internal Server Error
      tags:
      - Hypercore
  /hypercore/account/{address}/subaccounts:
    get:
      summary: Get HyperCore sub-accounts
      description: Sub-accounts (name, address, vault flag) indexed for a HyperCore master address.
      operationId: GetHypercoreSubAccounts
      parameters:
      - name: address
        in: path
        description: HyperCore master or sub-account address.
        required: true
        schema:
          type: string
          description: HyperCore master or sub-account address.
          example: '0xECB63caA47c7c4E77F60f1cE858Cf28dC2B82b00'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HypercoreSubAccountsResponse'
              example:
                address: '0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00'
                subAccounts:
                - address: '0x8185204d31602595fadbb9305155e8981762e60c'
                  isVault: false
                  master: '0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00'
                  name: sub1
                - address: '0x37449263a96d00ec4cd68952a3f3c7fd1927d958'
                  isVault: false
                  master: '0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00'
                  name: sub10
                - address: '0x152600cac5306fd519ccb2bdd4b18a441443428a'
                  isVault: false
                  master: '0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00'
                  name: sub11
        '400':
          description: Bad Request
        '500':
          description: Internal Server Error
      tags:
      - Hypercore
  /hypercore/account/{address}/summary:
    get:
      summary: Get HyperCore account value summary
      description: Total account value (spot USD + perp equity + staked HYPE) for a HyperCore address. A master address aggregates across all of its sub-accounts; a sub-account returns only its own value.
      operationId: GetHypercoreAccountSummary
      parameters:
      - name: address
        in: path
        description: HyperCore master or sub-account address.
        required: true
        schema:
          type: string
          description: HyperCore master or sub-account address.
          example: '0xECB63caA47c7c4E77F60f1cE858Cf28dC2B82b00'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HypercoreAccountSummaryResponse'
              example:
                address: '0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00'
                addresses:
                - '0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00'
                - '0x08b095625fb698837fc436c489ce9e4f6ee084c1'
                - '0x152600cac5306fd519ccb2bdd4b18a441443428a'
                - '0x153ae96fafe232f61b9a19c285b8e8e265642f69'
                - '0x37449263a96d00ec4cd68952a3f3c7fd1927d958'
                - '0x4304dc380a4c9a452c58707487e185caf992ff05'
                - '0x6d9f9706d647d19e93164a7217576797358fa8c3'
                - '0x8185204d31602595fadbb9305155e8981762e60c'
                - '0x82578861165b62466f8e11e51efe74455ed0e1a6'
                - '0x88f9bd20b748c3e533374fa201621ceb119ee9db'
                - '0x8af63f51e0c60851a30da696a6a0911a3d019d5e'
                - '0x8fecb60f12fd9a3db6901b8a7703a24fa2ee1268'
                - '0x90e678b96a3d15bac0e109535692be5361571652'
                - '0x91ea0caf217cb0e51d833d9b66464371fb9d1c5b'
                - '0xa3e4be245fa0cbd5df1718c33cb9c08af5796f3b'
                - '0xb3514b307d17e09d2086738b62ac5db371692d9d'
                - '0xba6be69a57e42572df416997af3b7dcdd59ef360'
                - '0xc21f25650fd7165905e94014529261070c4530a3'
                - '0xc64283a986819174aa0b13b22ff9ab55ac2bd394'
                - '0xe78030f0e93def6280f7331edb81db4a3f547633'
                - '0xefee01d3a0d06c188627d98b6aa814f401f87c4b'
                - '0xfa452867a690af8bc0a3aa585facaf8e70e65ef8'
                - '0xff1ec702af93ac3e9537d9e24c2c4750d44cbf75'
                perpPositionCount: 123
                perpUnrealizedPnl: 1015323.5175330002
                perpUsdValue: 62831603.012425
                perpUsdcBalance: 179763906.134545
                pricingAvailable: true
                spotBalanceCount: 34
                spotUsdValue: 16717217.12361454
                stakedUsdValue: 15428141.678624816
                subAccountCount: 22
                totalUsdValue: 94976961.81466436
        '400':
          description: Bad Request
        '500':
          description: Internal Server Error
      tags:
      - Hypercore
  /hypercore/account/{address}/trades:
    get:
      summary: Get HyperCore trade history
      description: Merged spot and perp fills for a HyperCore address (master + sub-accounts), newest first, paginated via limit/offset.
      operationId: GetHypercoreTrades
      parameters:
      - name: limit
        in: query
        description: Max fills to return (default 50, max 200).
        schema:
          type: integer
          description: Max fills to return (default 50, max 200).
          example: 50
      - name: offset
        in: query
        description: 'Pagination offset into the merged fill history. Default: 0.'
        schema:
          type: integer
          description: 'Pagination offset into the merged fill history. Default: 0.'
          example: 0
      - name: address
        in: path
        description: HyperCore master or sub-account address.
        required: true
        schema:
          type: string
          description: HyperCore master or sub-account address.
          example: '0x020ca66c30bec2c4fe3861a94e4db4a498a35872'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HypercoreTradesResponse'
              example:
                addresses:
                - '0x020ca66c30bec2c4fe3861a94e4db4a498a35872'
                hasMore: true
                limit: 50
                offset: 0
                trades:
                - address: '0x020ca66c30bec2c4fe3861a94e4db4a498a35872'
                  closedPnl: 0
                  coin: ETH
                  direction: Open Long
                  fee: 9.970859
                  feeToken: USDC
                  hash: '0x0a62f1391c59819b0bdc044022f1670203a2001eb75ca06dae2b9c8bdb5d5b85'
                  kind: perp
                  price: 1832.7
                  side: B
                  size: 18.1351
                  time: '2026-07-17T14:10:59.009Z'
                - address: '0x020ca66c30bec2c4fe3861a94e4db4a498a35872'
                  closedPnl: 0
                  coin: ETH
                  direction: Open Long
                  fee: 3.77439
                  feeToken: USDC
                  hash: '0x0a62f1391c59819b0bdc044022f1670203a2001eb75ca06dae2b9c8bdb5d5b85'
                  kind: perp
                  price: 1832.7
                  side: B
                  size: 6.8649
                  time: '2026-07-17T14:10:59.009Z'
                - address: '0x020ca66c30bec2c4fe3861a94e4db4a498a35872'
                  closedPnl: 0
                  coin: ETH
                  direction: Open Long
                  fee: 13.753499
                  feeToken: USDC
                  hash: '0x282c56304428027829a6044022f1010206a50015df2b214acbf50183032bdc62'
                  kind: perp
                  price: 1833.8
                  side: B
                  size: 25
                  time: '2026-07-17T14:10:51.906Z'
        '400':
          description: Bad Request
        '500':
          description: Internal Server Error
      tags:
      - Hypercore
  /hypercore/entity/{entity}/active:
    get:
      summary: Check for HyperCore entity activity
      description: 'Whether any address attributed to the entity has HyperCore activity: a spot balance, open perp position, margin, staking, or vault equity.'
      operationId: GetHypercoreEntityActive
      parameters:
      - name: entity
        in: path
        description: Arkham entity ID.
        required: true
        schema:
          type: string
          description: Arkham entity ID.
          example: wintermute
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HypercoreEntityActiveResponse'
              example:
                active: true
                entity: wintermute
        '400':
          description: Bad Request
        '500':
          description: Internal Server Error
      tags:
      - Hypercore
  /hypercore/entity/{entity}/perp-positions:
    get:
      summary: Get HyperCore entity perp positions
      description: Open perpetual positions across every address attributed to the entity, with mark price, unrealized PnL, and per-DEX USDC margin.
      operationId: GetHypercoreEntityPerpPositions
      parameters:
      - name: entity
        in: path
        description: Arkham entity ID.
        required: true
        schema:
          type: string
          description: Arkham entity ID.
          example: wintermute
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HypercorePerpPositionsResponse'
              example:
                accountUsdValue: 60422375.07808398
                addresses:
                - '0x0000006daea1723962647b7e189d311d757fb793'
                - '0x0000f079e68bbcc79ab9600ace786b0a4db1c83c'
                - '0x03ae1a796dfe0400439211133d065bda774b9d3e'
                dexBalances:
                - dex: xyz
                  usdcBalance: 9719026.928198999
                - dex: ''
                  usdcBalance: 161683016.732425
                - dex: cash
                  usdcBalance: 0.004359
                positions:
                - address: '0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00'
                  coin: PUMP
                  direction: short
                  entryPx: 0.0015532833786410095
                  leverageType: cross
                  leverageValue: 3
                  markPx: 0.001625
                  maxLeverage: 10
                  positionValue: 4264428.89925
                  szi: -2624263938
                  underlyingPricingId: pump-fun
                  underlyingSymbol: PUMP
                  unrealizedPnl: -188203.34318759906
                - address: '0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00'
                  coin: kPEPE
                  direction: short
                  entryPx: 0.0026949657593151586
                  leverageType: cross
                  leverageValue: 10
                  markPx: 0.002675
                  maxLeverage: 10
                  positionValue: 1309223.594175
                  szi: -489429381
                  underlyingPricingId: pepe
                  underlyingSymbol: PEPE
                  unrealizedPnl: 9771.829222813132
                - address: '0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00'
                  coin: kBONK
                  direction: short
                  entryPx: 0.003497
                  leverageType: cross
                  leverageValue: 10
                  markPx: 0.003168
                  maxLeverage: 10
                  positionValue: 171282.754368
                  szi: -54066526
                  underlyingPricingId: bonk
                  underlyingSymbol: BONK
                  unrealizedPnl: 17787.887054000017
                unrealizedPnl: 1653719.941092011
                usdcBalance: 171402043.664983
        '400':
          description: Bad Request
        '500':
          description: Internal Server Error
      tags:
      - Hypercore
  /hypercore/entity/{entity}/portfolio-history:
    get:
      summary: Get HyperCore entity account value / PnL history
      description: Combined account-value and PnL time series per timeframe (day, week, month, allTime) across an entity's HyperCore addresses, at daily resolution.
      operationId: GetHypercoreEntityPortfolioHistory
      parameters:
      - name: entity
        in: path
        description: Arkham entity ID.
        required: true
        schema:
          type: string
          description: Arkham entity ID.
          example: wintermute
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HypercoreEntityPortfolioHistoryResponse'
              example:
                entity: wintermute
                periods:
                - accountValue:
                  - time: 1784246344057
                    value: 95158621.32031299
                  - time: 1784294531578
                    value: 98562252.84599899
                  period: day
                  pnl:
                  - time: 1784224706077
                    value: 846167.4401189685
                  - time: 1784294531578
                    value: 2471029.4675139785
                - accountValue:
                  - time: 1783727996396
                    value: 91760066.196543
                  - time: 1783814323032
                    value: 96805461.583287
                  - time: 1783900560020
                    value: 101532531.30774198
                  period: week
                  pnl:
                  - time: 1783726080034
                    value: -2659042.1070310175
                  - time: 1783810080061
                    value: -2659041.3849770427
                  - time: 1783897680023
                    value: -2659040.7379760146
        '400':
          description: Bad Request
        '500':
          description: Internal Server Error
      tags:
      - Hypercore
  /hypercore/entity/{entity}/spot-balances:
    get:
      summary: Get HyperCore entity spot balances
      description: Spot token balances across every address attributed to the entity, each valued in USD at the spot mid price.
      operationId: GetHypercoreEntitySpotBalances
      parameters:
      - name: entity
        in: path
        description: Arkham entity ID.
        required: true
        schema:
          type: string
          description: Arkham entity ID.
          example: wintermute
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HypercoreSpotBalancesResponse'
              example:
                addresses:
                - '0x0000006daea1723962647b7e189d311d757fb793'
                - '0x0000f079e68bbcc79ab9600ace786b0a4db1c83c'
                - '0x03ae1a796dfe0400439211133d065bda774b9d3e'
                balances:
                - address: '0x9f2a049145af1ee33ee1de8adc0e62041761cc5d'
                  coin: MAX
                  hold: 0
                  token: 734
                  total: 9995.425307
                  usdPrice: 4e-7
                  usdValue: 0.0039981701228
                - address: '0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00'
                  coin: USDC
                  hold: 6289812.51771749
                  token: 0
                  total: 9991392.00856484
                  underlyingPricingId: usd-coin
                  usdPrice: 1
                  usdValue: 3701579.490847349
                - address: '0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00'
                  coin: UBTC
                  entryPx: 64115.25251628088
                  hold: 36.39076
                  token: 197
                  total: 97.9853715109
                  underlyingPricingId: unit-bitcoin
                  underlyingSymbol: UBTC
                  unrealizedPnl: -141515.61936333403
                  usdPrice: 62671
                  usdValue: 6140841.217959614
                totalUsdValue: 16750028.265744798
        '400':
          description: Bad Request
        '500':
          description: Internal Server Error
      tags:
      - Hypercore
  /hypercore/entity/{entity}/summary:
    get:
      summary: Get HyperCore entity value summary
      description: Total HyperCore value (spot USD + perp equity + staked HYPE) aggregated across every address attributed to the entity, sub-accounts included.
      operationId: GetHypercoreEntitySummary
      parameters:
      - name: entity
        in: path
        description: Arkham entity ID.
        required: true
        schema:
          type: string
          description: Arkham entity ID.
          example: wintermute
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HypercoreEntitySummaryResponse'
              example:
                addressCount: 71
                entity: wintermute
                perpPositionCount: 123
                perpUnrealizedPnl: 1653719.941092011
                perpUsdValue: 60422375.07808398
                perpUsdcBalance: 171402043.664983
                pricingAvailable: true
                spotBalanceCount: 45
                spotUsdValue: 16750028.265744798
                stakedUsdValue: 15341482.640184918
                subAccountCount: 22
                totalUsdValue: 92513885.98401369
        '400':
          description: Bad Request
        '500':
          description: Internal Server Error
      tags:
      - Hypercore
  /hypercore/markets:
    get:
      summary: List HyperCore markets
      description: Every token that has a HyperCore spot or perpetual market. Returns each token's pricing id, symbol, and name.
      operationId: GetHypercoreMarkets
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HypercoreMarketsResponse'
              example:
                markets:
                - name: Bitcoin
                  pricingId: bitcoin
                  symbol: BTC
                - name: Ethereum
                  pricingId: ethereum
                  symbol: ETH
                - name: Hyperliquid
                  pricingId: hyperliquid
                  symbol: HYPE
        '400':
          description: Bad Request
        '500':
          description: Internal Server Error
      tags:
      - Hypercore
  /hypercore/token/{pricingId}/positions:
    get:
      summary: Get top HyperCore perp positions for a token
      description: Returns the largest open HyperCore perp positions on the token's canonical market, optionally netted per entity.
      operationId: GetHypercoreTokenPositions
      parameters:
      - name: side
        in: query
        description: Filter to 'long' or 'short' positions; omit for both.
        schema:
          type: string
          description: Filter to 'long' or 'short' positions; omit for both.
          example: long
      - name: groupByEntity
        in: query
        description: If 'true', nets positions per attributed entity.
        schema:
          type: string
          description: If 'true', nets positions per attributed entity.
          example: 'true'
      - name: sort
        in: query
        description: 'Sort column: size, value, pnl, funding (default size).'
        schema:
          type: string
          description: 'Sort column: size, value, pnl, funding (default size).'
          example: size
      - name: ascending
        in: query
        description: If 'true', sorts ascending.
        schema:
          type: string
          description: If 'true', sorts ascending.
          example: 'true'
      - name: limit
        in: query
        description: Rows per page (default 50, max 100).
        schema:
          type: integer
          description: Rows per page (default 50, max 100).
          example: 50
      - name: offset
        in: query
        description: 'Pagination offset (offset+limit capped at 1000). Default: 0.'
        schema:
          type: integer
          description: 'Pagination offset (offset+limit capped at 1000). Default: 0.'
          example: 0
      - name: pricingId
        in: path
        description: CoinGecko pricing id of the token.
        required: true
        schema:
          type: string
          description: CoinGecko pricing id of the token.
          example: bitcoin
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HypercoreTokenPositionsResponse'
              example:
                hasPerp: true
                positions:
                - address:
                    address: '0x92ea19eceb7a8de0f50978a1583a5d8b018050e9'
                    arkhamLabel:
                      address: '0x92ea19ECeB7a8dE0f50978A1583A5D8b018050e9'
                      chainType: evm
                      name: '"GarretBullish" on Markets.xyz'
                    chain: hyperevm
                    contract: false
                    service: false
                  addressCount: 1
                  coin: BTC
                  cumFundingSinceOpen: 862173.863344
                  direction: long
                  entryPx: 76117.3
                 

# --- truncated at 32 KB (105 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/arkham/refs/heads/main/openapi/arkham-hypercore-api-openapi.yml