> ## 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.
## Submitting Feedback
If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback:
POST https://docs.deribit.com/feedback
```json
{
"path": "/subscriptions/market-data/perpetualinstrument_nameinterval",
"feedback": "Description of the issue"
}
```
Only submit feedback when you have something specific and actionable to report.
# perpetual.(instrument_name).(interval)
> Provide current interest rate - but only for **perpetual** instruments. Other types won't generate any notification.
## AsyncAPI
````yaml specifications/deribit_asyncapi.json perpetual.(instrument_name).(interval)
id: perpetual.(instrument_name).(interval)
title: 'perpetual.(instrument_name).(interval) '
description: >-
Provide current interest rate - but only for **perpetual** instruments. Other
types won't generate any notification.
servers:
- id: production
protocol: wss
host: deribit.com/ws/api/v2
bindings: []
variables: []
- id: testnet
protocol: wss
host: test.deribit.com/ws/api/v2
bindings: []
variables: []
address: perpetual.(instrument_name).(interval)
parameters:
- id: instrument_name
jsonSchema:
type: string
description: The name of the instrument
description: The name of the instrument
type: string
required: true
deprecated: false
- id: interval
jsonSchema:
type: string
description: >-
Frequency of notifications. Events will be aggregated over this
interval. The value `raw` means no aggregation will be applied **(Please
note that `raw` interval is only available to authorized users)**
**Allowed values:** `raw`, `100ms`, `agg2`
enum:
- raw
- 100ms
- agg2
description: >-
Frequency of notifications. Events will be aggregated over this interval.
The value `raw` means no aggregation will be applied **(Please note that
`raw` interval is only available to authorized users)**
**Allowed values:** `raw`, `100ms`, `agg2`
type: string
required: true
deprecated: false
bindings: []
operations:
- &ref_2
id: send_subscribe_perpetual_instrument_name_interval
title: Send subscribe request for perpetual
description: Client sends subscription request for perpetual updates
type: send
messages:
- &ref_4
id: subscription_message
contentType: application/json
payload:
- name: Subscription Notification Data
description: Server sends subscription notification data
type: object
properties:
- name: data
type: object
required: true
properties:
- name: interest
type: number
description: Current interest
required: false
- name: timestamp
type: integer
description: The timestamp (milliseconds since the Unix epoch)
required: false
- name: index_price
type: number
description: Current index price
required: false
headers: []
jsonPayloadSchema:
type: object
description: Response containing notification data
properties:
data:
type: object
properties:
interest:
type: number
description: Current interest
x-parser-schema-id:
timestamp:
type: integer
example: 1536569522277
description: The timestamp (milliseconds since the Unix epoch)
x-parser-schema-id:
index_price:
description: Current index price
type: number
example: 8247.27
x-parser-schema-id:
required:
- interest
- timestamp
- index_price
additionalProperties: false
x-parser-schema-id:
required:
- data
additionalProperties: false
x-parser-schema-id:
title: Subscription Notification Data
description: Server sends subscription notification data
example: |-
{
"data": {
"interest": 0.004999511380756577,
"timestamp": 1571386349530,
"index_price": 7872.88
}
}
bindings: []
extensions:
- id: x-parser-unique-object-id
value: subscription_message
bindings: []
extensions: &ref_0
- id: x-parser-unique-object-id
value: perpetual.(instrument_name).(interval)
- &ref_1
id: receive_perpetual_instrument_name_interval_updates
title: Receive perpetual updates
description: Client receives perpetual update notifications
type: receive
messages:
- &ref_3
id: subscribe_request
contentType: application/json
payload:
- name: Subscription Request
description: >-
Client sends subscription request to subscribe to notification
channel. Please refer to [Notification
page](https://deribit.mintlify.app/articles/notifications) for
more information.
type: object
properties: []
headers: []
jsonPayloadSchema:
properties: {}
additionalProperties: false
x-parser-schema-id:
title: Subscription Request
description: >-
Client sends subscription request to subscribe to notification
channel. Please refer to [Notification
page](https://deribit.mintlify.app/articles/notifications) for more
information.
example: |-
{
"jsonrpc": "2.0",
"method": "public/subscribe",
"id": 42,
"params": {
"channels": [
"perpetual.BTC-PERPETUAL.100ms"
]
}
}
bindings: []
extensions:
- id: x-parser-unique-object-id
value: subscribe_request
bindings: []
extensions: *ref_0
sendOperations:
- *ref_1
receiveOperations:
- *ref_2
sendMessages:
- *ref_3
receiveMessages:
- *ref_4
extensions:
- id: x-parser-unique-object-id
value: perpetual.(instrument_name).(interval)
securitySchemes: []
````