> ## Documentation Index > Fetch the complete documentation index at: https://docs.alphractal.com/llms.txt > Use this file to discover all available pages before exploring further. # Whale_vs_retail_ratio > Retrieve whale vs retail ratio for perpetual derivatives. Returns the ratio of whale to retail trading activity aggregated by the specified timeframe. Supports timeframes: 1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w, 1M. ## OpenAPI ````yaml /api-reference/openapi.json get /{asset}/derivatives/Whale_vs_retail_ratio openapi: 3.1.1 info: title: Alphractal API version: 0.3.0 description: >- Alphractal API provides comprehensive cryptocurrency on-chain data including mining metrics, address analytics, block information, fee data, market indicators, supply metrics, exchange flows, and more. servers: - url: https://api.alphractal.com description: Production server security: - ApiKeyAuth: [] paths: /{asset}/derivatives/Whale_vs_retail_ratio: get: tags: - Derivatives summary: Whale_vs_retail_ratio description: >- Retrieve whale vs retail ratio for perpetual derivatives. Returns the ratio of whale to retail trading activity aggregated by the specified timeframe. Supports timeframes: 1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w, 1M. parameters: - name: asset in: path required: true schema: type: - string - 'null' enum: - 0g - 1inch - 2z - '4' - a - aaoi - aapl - aave - ace - act - ada - aero - agld - agt - aia - ain - aio - aixbt - ake - akt - alch - algo - allo - alt - amat - amd - amzn - anthropic - ape - apr - apt - ar - arb - arc - aria - arkm - arm - arx - asml - aster - asts - at - ath - atom - avaai - avax - avgo - avnt - awe - axs - axti - b - b2 - baba - baby - ban - banana - bananas31 - bank - bard - based - bat - bch - be - beamx - beat - bera - bico - bill - bio - bless - bluai - blur - bmnr - bmt - bnb - bome - bonk - br - brett - bsb - bsv - btc - btcdom - btr - btw - bulla - bx - bz - c - cake - cap - cbrs - cc - cfg - cfx - cheems - chillguy - chip - chz - ckb - cl - clo - coai - cohr - coin - collect - comp - copper - core - coti - cow - crcl - cro - crv - crwv - ctc - cvx - cys - dash - deep - dell - dexe - dog - doge - dos - dot - dram - dydx - eden - edge - egld - eigen - elsa - ena - enj - ens - enso - epic - era - esp - esports - etc - eth - ethfi - eul - evaa - ewy - fartcoin - fet - ff - fhe - fight - fil - floki - flow - flr - fluid - folks - form - frax - g - gala - gas - genius - giggle - glm - glw - gmt - gmx - googl - gps - gram - grass - griffain - grt - grvt - gua - gwei - h - hana - hbar - hei - hemi - hk0700 - hk1810 - hmstr - hnt - holo - home - hood - hot - huma - hype - hyper - ibm - icnt - icp - id - idol - imx - in - inch - inj - intc - inx - io - iota - ip - iren - irys - jasmy - jct - jellyjelly - jst - jto - jup - kaia - kaito - kas - kat - kava - kgen - kite - kmno - koma - koru - la - lab - ldo - light - linea - link - lit - lite - lpt - lsk - ltc - lumia - lunc - lyn - m - magma - mana - manta - mantra - me - mega - meme - merl - met - meta - mina - minimax - mira - mito - mmt - mnt - mon - moodeng - morpho - move - mrvl - msft - mstr - mu - mubarak - muu - mvll - myx - naoris - natgas - nbis - near - neiro - neo - nflx - night - nil - nok - not - now - nvda - nxpc - o - okb - 'on' - ondo - one - op - open - openai - opg - opn - orcl - ordi - parti - paxg - pendle - pengu - people - pepe - pieverse - pippin - play - pltr - plume - pnut - pol - popcat - power - prl - prom - prove - ptb - pump - pyth - q - qcom - qnt - qqq - qtum - rats - rave - re - render - resolv - river - rklb - robo - rose - rsr - rune - rvn - s - safe - saga - sahara - samsung - sand - sei - sent - sfp - shib - sign - siren - skhy - skhynix - skr - sky - skyai - slx - smci - sndk - snx - snxx - sol - soon - soxl - soxs - space - spcx - spk - spx - spy - sqd - sqqq - stable - stbl - stg - sto - storj - strc - strk - stx - sui - sun - sushi - syn - syrup - t - ta - tac - tag - taiko - take - tao - theta - tia - tlm - tnsr - ton - toshi - tqqq - tradoor - trb - tree - tria - trump - truth - trx - tsla - tsm - turbo - tut - twt - uai - ub - uni - us - usdc - useless - vana - velo - velodrome - velvet - vet - virtual - vvv - w - wal - wdc - wet - wif - wld - wlfi - xag - xan - xau - xaut - xcn - xdc - xec - xlm - xmr - xny - xpd - xpin - xpl - xpt - xrp - xtz - xvg - yfi - z - zama - zbt - zec - zen - zerebro - zest - zhipu - zil - zk - zro - zrx - 币安人生 - 龙虾 description: >- Asset identifier, lowercase ticker. The list is the assets that carry this metric — an asset outside it has no data here. example: btc - name: timeframe in: query schema: type: - string - 'null' enum: - 15m - 30m - 1h - 4h - 6h - 12h - 1d default: 1d description: >- Aggregation bucket. Values outside the accepted list fall back to the daily series instead of returning an error. example: 1h - description: >- Start date for filtering results (inclusive). Format: ISO 8601 date-time. name: startDate in: query schema: format: date-time type: string nullable: true required: false - description: >- End date for filtering results (inclusive). Format: ISO 8601 date-time. name: endDate in: query schema: format: date-time type: string nullable: true required: false - name: exchange in: query schema: type: - string - 'null' enum: - Binance - Okex - binance - gate - okx description: Venue identifier. When omitted, the query is not filtered by venue. example: binance - name: symbol in: query schema: type: - string - 'null' description: >- Trading pair symbol (e.g. BTCUSDT). When omitted, data is aggregated across symbols. example: BTCUSDT responses: '200': description: OK content: application/json: schema: type: array items: type: object properties: time: type: string format: date-time whale_vs_retail_ratio: type: number format: double additionalProperties: false components: securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-Api-Key description: >- API Key authentication. Include your API key in the X-Api-Key header for all requests. ````