> ## 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. # Download export > Generates presigned URLs for downloading export files. URLs are valid for 5 minutes. Large exports may be split into multiple files (hourly or daily partitions). The response contains an array of artifacts, each with its own presigned URL. Small exports will have a single artifact. Only available for exports with status `succeeded`. ## OpenAPI ````yaml get /v1/exports/{id}/download 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/exports/{id}/download: get: tags: - Exports summary: Download export description: > Generates presigned URLs for downloading export files. URLs are valid for 5 minutes. Large exports may be split into multiple files (hourly or daily partitions). The response contains an array of artifacts, each with its own presigned URL. Small exports will have a single artifact. Only available for exports with status `succeeded`. operationId: downloadExport parameters: - name: id in: path required: true description: Export job ID (prefixed format, e.g., exp_xxx) schema: type: string pattern: ^exp_[a-f0-9]{32}$ example: exp_0194a1b2c3d4e5f6a7b8c9d0e1f2a3b4 responses: '200': description: Download URLs for all export artifacts content: application/json: schema: $ref: '#/components/schemas/ExportDownloadResponse' '400': $ref: '#/components/responses/BadRequest' '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="") download = client.exports.get_download("exp_019478a23c5f7b8e9d12abcdef012345") print(download) - 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 download = client.exports() .get_download("exp_019478a23c5f7b8e9d12abcdef012345") .await?; println!("{download:#?}"); Ok(()) } components: schemas: ExportDownloadResponse: type: object description: > Download response containing presigned URLs for all export artifacts. Large exports may be split into multiple files (hourly or daily partitions). required: - artifacts - count - total_bytes properties: artifacts: type: array items: $ref: '#/components/schemas/ArtifactDownload' description: List of downloadable artifacts with presigned URLs count: type: integer description: Number of artifacts example: 3 total_bytes: type: integer format: int64 description: Total size across all artifacts in bytes example: 1572864000 example: artifacts: - id: art_0194a1b2c3d4e5f6a7b8c9d0e1f2a3b4 url: https://tickstore-exports.s3.amazonaws.com/exports/... bytes: 524288000 filename: binance_BTCUSDT_trades_part_2024010100.csv.gz - id: art_0194b2c3d4e5f6a7b8c9d0e1f2a3b4c5 url: https://tickstore-exports.s3.amazonaws.com/exports/... bytes: 524288000 filename: binance_BTCUSDT_trades_part_2024010101.csv.gz - id: art_0194c3d4e5f6a7b8c9d0e1f2a3b4c5d6 url: https://tickstore-exports.s3.amazonaws.com/exports/... bytes: 524288000 filename: binance_BTCUSDT_trades_part_2024010102.csv.gz count: 3 total_bytes: 1572864000 ArtifactDownload: type: object description: A single downloadable artifact with presigned URL required: - id - url - bytes - filename properties: id: type: string pattern: ^art_[a-f0-9]{32}$ description: Artifact ID (prefixed format, e.g., art_xxx) example: art_0194a1b2c3d4e5f6a7b8c9d0e1f2a3b4 url: type: string format: uri description: Presigned S3 URL for download (valid for 5 minutes) bytes: type: integer format: int64 description: File size in bytes example: 524288000 filename: type: string description: Suggested filename for download example: binance_BTCUSDT_trades_part_2024010100.csv.gz 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: BadRequest: description: Invalid request parameters 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: invalid_argument message: 'Invalid datastream_id: must be a positive integer' 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 ````