> ## Documentation Index
> Fetch the complete documentation index at: https://docs.deribit.com/llms.txt
> Use this file to discover all available pages before exploring further.
# public/get_basket_index_composition
> Retrieves the latest composition of a basket index, including constituents, weights, cap factors, and the index divisor. The composition object is returned as received from the index composition service; Deribit does not remap field names or types.
The `index_name` parameter is case-insensitive. Only basket indexes listed on Deribit are accepted; currently this is `COIN50`. Other Coinbase baskets such as `AI10` or `TECH100` are rejected. An unknown or missing `index_name` returns `invalid_params`.
[Try in API console](https://test.deribit.com/api_console?method=%2Fpublic%2Fget_basket_index_composition)
## OpenAPI
````yaml /specifications/deribit_upcoming_openapi.json get /public/get_basket_index_composition
openapi: 3.0.0
info:
title: Deribit API
version: 2.1.1
servers:
- url: https://test.deribit.com/api/v2
security: []
tags:
- name: WebSocket Only
description: Can only be used over websockets.
- name: Public
description: Public methods can be used without authentication.
- name: Private
description: >-
Private methods require authentication. All requests must include a
valid OAuth2 token.
A token can be requested using the /public/auth method.
When using the websockets protocol, the token must be included as a
parameter access_token in the message. When using REST (HTTP
GET), the token may also be passed in the Authorization
header.
- name: Authentication
- name: Session Management
- name: Subscription Management
description: >-
Subscription works as [notifications](#notifications), so users will
automatically (after subscribing) receive messages from the server.
Overview for each channel response format is described in
[subscriptions](#subscriptions) section.
- name: Account Management
- name: Trading
- name: Market Data
- name: Wallet
- name: Chat
- name: lsp
description: >-
Methods and notifications for the Liquidity Support Program (LSP), the
mechanism that assigns risk from liquidated positions to designated LSP
participant subaccounts before falling back to auto-deleveraging (ADL).
paths:
/public/get_basket_index_composition:
get:
tags:
- Market Data
- Public
description: >+
Retrieves the latest composition of a basket index, including
constituents, weights, cap factors, and the index divisor. The
composition object is returned as received from the index composition
service; Deribit does not remap field names or types.
The `index_name` parameter is case-insensitive. Only basket indexes
listed on Deribit are accepted; currently this is `COIN50`. Other
Coinbase baskets such as `AI10` or `TECH100` are rejected. An unknown or
missing `index_name` returns `invalid_params`.
[Try in API
console](https://test.deribit.com/api_console?method=%2Fpublic%2Fget_basket_index_composition)
parameters:
- name: index_name
required: true
in: query
schema:
$ref: '#/components/schemas/basket_index_name'
description: >
Basket index identifier. Case-insensitive. Currently `COIN50` is the
only supported value.
requestBody:
content:
application/json:
examples:
request:
value:
jsonrpc: '2.0'
id: 1
method: public/get_basket_index_composition
params:
index_name: COIN50
description: JSON-RPC Request Example
description: JSON-RPC request body
responses:
'200':
$ref: '#/components/responses/PublicGetBasketIndexCompositionResponse'
components:
schemas:
basket_index_name:
example: COIN50
type: string
description: >-
Basket index identifier (case-insensitive). Currently only COIN50 is
supported.
PublicGetBasketIndexCompositionResponse:
properties:
jsonrpc:
type: string
enum:
- '2.0'
description: The JSON-RPC version (2.0)
id:
type: integer
description: The id that was sent in the request
result:
type: object
additionalProperties: true
properties:
product_id:
type: string
example: COIN50
description: Basket index identifier
divisor:
type: string
example: '3935813421.91702'
description: >-
Index divisor used to scale the basket market cap into the
published index level
timestamp:
type: string
example: '2024-11-11T14:47:26Z'
description: Snapshot timestamp of this composition (RFC 3339)
inception_timestamp:
type: string
example: '2020-12-31T00:00:00Z'
description: Timestamp when this index was first created (RFC 3339)
last_rebalance:
type: string
example: '2024-08-30T00:00:00Z'
description: Timestamp of the last index rebalance (RFC 3339)
constituents:
type: array
items:
type: object
additionalProperties: true
properties:
symbol:
type: string
example: BTC-USD
description: Constituent asset pair symbol
name:
type: string
example: Bitcoin
description: Constituent name
rank:
type: number
example: 1
description: Constituent rank order in the index
cap_factor:
type: string
example: '0.456192678887042'
description: >-
Constituent market-cap factor (multiplier) applied for
capping
amount:
type: string
example: '19745468'
description: Constituent amount outstanding
market_cap:
type: string
example: '1625637364529.9463'
description: Constituent total market cap
index_market_cap:
type: string
example: '741603864223.787'
description: >-
Constituent market cap represented in the index after
capping
weight:
type: string
example: '0.5130230783794717'
description: Weight of the constituent in the index
running_weight:
type: string
example: '0.5130230783794717'
description: >-
Cumulative weight of this constituent and all
higher-ranked constituents
description: Ordered set of index constituents
description: >
Latest basket composition, forwarded as received from the index
composition service. Deribit does not remap field names or types.
Typical fields from the former INTX composition endpoint are listed
below; additional properties may be present.
required:
- result
- jsonrpc
type: object
responses:
PublicGetBasketIndexCompositionResponse:
content:
application/json:
schema:
$ref: '#/components/schemas/PublicGetBasketIndexCompositionResponse'
examples:
response:
value:
jsonrpc: '2.0'
id: 1
result:
product_id: COIN50
divisor: '3935813421.91702'
timestamp: '2024-11-11T14:47:26Z'
inception_timestamp: '2020-12-31T00:00:00Z'
last_rebalance: '2024-08-30T00:00:00Z'
constituents:
- symbol: BTC-USD
name: Bitcoin
rank: 1
cap_factor: '0.456192678887042'
amount: '19745468'
market_cap: '1625637364529.9463'
index_market_cap: '741603864223.787'
weight: '0.5130230783794717'
running_weight: '0.5130230783794717'
- symbol: ETH-USD
name: Ethereum
rank: 2
cap_factor: '1'
amount: '120390000'
market_cap: '396812441178.12'
index_market_cap: '396812441178.12'
weight: '0.2745124011023314'
running_weight: '0.7875354794818031'
- symbol: SOL-USD
name: Solana
rank: 3
cap_factor: '1'
amount: '467810000'
market_cap: '82144117812.45'
index_market_cap: '82144117812.45'
weight: '0.0568124011023314'
running_weight: '0.8443478805841345'
description: Response example
description: Success response
````
## Related topics
- [public/get_index_price](/api-reference/upcoming/market-data/public-get_index_price.md)
- [public/get_index_chart_data](/api-reference/upcoming/market-data/public-get_index_chart_data.md)
- [public/get_supported_index_names](/api-reference/upcoming/market-data/public-get_supported_index_names.md)
- [public/get_index_price_names](/api-reference/upcoming/market-data/public-get_index_price_names.md)
- [public/get_volatility_index_data](/api-reference/upcoming/market-data/public-get_volatility_index_data.md)