> ## Documentation Index > Fetch the complete documentation index at: https://docs.ticksupply.com/llms.txt > Use this file to discover all available pages before exploring further. # Get data availability > Returns data availability information for a specific datastream. Shows time ranges where data is available along with estimated row counts. ## OpenAPI ````yaml get /v1/availability openapi: 3.1.0 info: title: Ticksupply API version: 1.0.0 description: > The Ticksupply API provides programmatic access to cryptocurrency market data. Subscribe to real-time data streams, manage subscriptions, and export historical data. contact: name: Ticksupply Support email: support@ticksupply.com termsOfService: https://ticksupply.com/terms license: name: Proprietary url: https://ticksupply.com/terms servers: - url: https://api.ticksupply.com description: Production API security: - ApiKeyAuth: [] tags: - name: Catalog description: Browse available exchanges, instruments, and data streams - name: Subscriptions description: Manage data stream subscriptions - name: Exports description: Export historical data to downloadable files - name: Availability description: Query data availability for specific streams - name: Export Schemas description: Manage export column schemas for customized CSV output - name: Billing description: Inspect your plan, access status, and usage for the current billing period paths: /v1/availability: get: tags: - Availability summary: Get data availability description: > Returns data availability information for a specific datastream. Shows time ranges where data is available along with estimated row counts. operationId: getAvailability parameters: - name: datastream_id in: query required: true schema: type: integer format: int64 description: Datastream ID to check availability for example: 123 responses: '200': description: Availability information content: application/json: schema: $ref: '#/components/schemas/AvailabilityResponse' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' '408': $ref: '#/components/responses/RequestTimeout' '429': $ref: '#/components/responses/RateLimited' '500': $ref: '#/components/responses/InternalError' x-codeSamples: - lang: python label: Python (ticksupply library) source: | # pip install ticksupply from ticksupply import Client client = Client(api_key="") info = client.availability.get(datastream_id=123) print(info) - lang: rust label: Rust (ticksupply crate) source: | // cargo add ticksupply // cargo add tokio --features full use ticksupply::Client; #[tokio::main] async fn main() -> ticksupply::Result<()> { let client = Client::with_api_key("")?; let info = client.availability().get(123).await?; println!("{info:#?}"); Ok(()) } components: schemas: AvailabilityResponse: type: object required: - datastream - ranges - updated_at properties: datastream: $ref: '#/components/schemas/DatastreamInfo' ranges: type: array items: $ref: '#/components/schemas/AvailabilityRange' description: Time ranges with available data updated_at: type: string format: date-time description: When availability was last updated DatastreamInfo: type: object description: Simplified datastream information for catalog queries required: - datastream_id - exchange - instrument - stream_type - wire_format properties: datastream_id: type: integer format: int64 description: Unique identifier for subscriptions and exports example: 123 exchange: type: string description: Exchange code example: binance instrument: type: string description: Instrument symbol example: BTCUSDT stream_type: type: string description: Stream type code example: trades wire_format: type: string description: Wire format code example: json AvailabilityRange: type: object required: - from - to - rows_estimate properties: from: type: integer format: int64 description: Start of range (nanoseconds since Unix epoch) example: 1704067200000000000 to: type: integer format: int64 description: End of range (nanoseconds since Unix epoch) example: 1704153600000000000 rows_estimate: type: integer format: int64 description: Estimated number of rows in this range example: 1500000 ApiError: type: object required: - error properties: error: type: object required: - code - message properties: code: type: string description: Error code for programmatic handling enum: - invalid_argument - unauthenticated - permission_denied - not_found - already_exists - request_timeout - rate_limited - payment_required - internal - unavailable message: type: string description: Human-readable error message details: type: object description: Additional error details (optional) responses: Unauthorized: description: Missing or invalid API key headers: X-Request-Id: description: Unique request identifier for support inquiries schema: type: string example: req_abc123def456 content: application/json: schema: $ref: '#/components/schemas/ApiError' example: error: code: unauthenticated message: Invalid or missing API key NotFound: description: Resource not found headers: X-Request-Id: description: Unique request identifier for support inquiries schema: type: string example: req_abc123def456 content: application/json: schema: $ref: '#/components/schemas/ApiError' example: error: code: not_found message: Subscription not found RequestTimeout: description: | Request did not complete within the 10-second deadline. Retry with exponential backoff. If you see this consistently on a particular endpoint, contact support. headers: X-Request-Id: description: Unique request identifier for support inquiries schema: type: string example: req_abc123def456 content: application/json: schema: $ref: '#/components/schemas/ApiError' example: error: code: request_timeout message: Request exceeded 10s deadline RateLimited: description: Rate limit exceeded headers: X-Request-Id: description: Unique request identifier for support inquiries schema: type: string example: req_abc123def456 Retry-After: description: Seconds to wait before retrying schema: type: integer X-RateLimit-Limit-Minute: description: Maximum requests allowed per minute schema: type: integer X-RateLimit-Remaining-Minute: description: Requests remaining in the current minute window schema: type: integer X-RateLimit-Reset-Minute: description: >- Unix timestamp (seconds) when the minute window next has capacity. Included only when the minute bucket is exhausted. schema: type: integer X-RateLimit-Limit-Hour: description: Maximum requests allowed per hour schema: type: integer X-RateLimit-Remaining-Hour: description: Requests remaining in the current hour window schema: type: integer X-RateLimit-Reset-Hour: description: >- Unix timestamp (seconds) when the hour window next has capacity. Included only when the hour bucket is exhausted. schema: type: integer content: application/json: schema: $ref: '#/components/schemas/ApiError' example: error: code: rate_limited message: Rate limit exceeded. Retry after 30 seconds. InternalError: description: Internal server error headers: X-Request-Id: description: Unique request identifier for support inquiries schema: type: string example: req_abc123def456 content: application/json: schema: $ref: '#/components/schemas/ApiError' example: error: code: internal message: An internal error occurred securitySchemes: ApiKeyAuth: type: apiKey in: header name: X-Api-Key description: >- Your API key. Get one from the dashboard at https://app.ticksupply.com/api-keys ````