Dataset

List your datasets

Changed on

Every dataset you have created and not deleted, most recently created first. Never a 404 — an empty array if you have none, same convention as GET /strategies.

With includeDeleted=true, datasets you have deleted are listed too, each with the deletedAt it was deleted at — useful to keep a copy of your list in sync, telling a deleted dataset apart from one that never existed.

get/datasets

Request

  • Base URL: https://api.qtsurfer.net/v1
  • URL: https://api.qtsurfer.net/v1/datasets
  • Auth: HTTP bearer

Query parameters

includeDeletedboolean

true also lists the datasets you have deleted, each with its deletedAt. Any other value, or leaving it out, lists only the ones you have not deleted.

Response

Your datasets

Example response

{
  "datasets": [
    {
      "datasetId": "ds_3f9a1c2e7b0d4a5f",
      "name": "My BTC ticks",
      "type": "ticker",
      "instrument": "BTC/USDT",
      "createdAt": "2026-08-20T09:00:00Z",
      "currentVersionId": "dsv_8e2b4f19c6a03d7e",
      "updatedAt": "2026-08-20T09:04:12Z",
      "from": "2026-03-01T00:00:00Z",
      "to": "2026-03-08T00:00:00Z",
      "cadence": "1m",
      "timestampUnit": "iso",
      "status": "ready",
      "bytes": 4831022,
      "rows": 86400,
      "error": "line 3: column 'close' is not a number: not-a-number"
    }
  ]
}

Changes

  • 87b478f3ee11Revision changes
    • info

      added the new optional query request parameter includeDeleted

    • info

      added the optional property // to the response with the status

  • b918e92d257aRevision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the required property // to the response with the status