Cuenta

Consulta los límites de tu plan y tu uso de almacenamiento en vivo frente a ellos.

Todas las rutas de cuenta requieren un JWT tipo bearer obtenido mediante autenticación. Dividido en dos endpoints a propósito: tu plan y sus límites no cambian a mitad de sesión y no cuesta nada consultarlos, mientras que el uso es una cifra en vivo que cambia con cada subida de conjunto de datos o ejecución de estrategia.

Método	Ruta	Propósito
`GET`	`/account`	Tu identidad y los límites de tu plan
`GET`	`/account/usage`	Tu uso de almacenamiento en vivo frente a esos límites

Obtener tu plan y sus límites

GET /account — sin ninguna consulta a base de datos detrás, seguro de llamar en cada carga de página.

curl https://api.qtsurfer.net/v1/account 
  -H "Authorization: Bearer $TOKEN"

{
  "userId": "00000000-0000-0000-0000-000000000000",
  "tier": "free",
  "maxExecute": 10,
  "maxRangeDays": 7,
  "maxSweepCartesian": 100,
  "maxImportRangeHours": 6,
  "maxDatasets": 3,
  "maxDatasetBytes": 52428800,
  "maxTotalStorageBytes": 104857600,
  "_links": {
    "self": { "href": "/v1/account" },
    "usage": { "href": "/v1/account/usage" }
  }
}

Campo	Notas
`userId`	tu id de cuenta — la claim `sub` del JWT
`tier`	tu plan de suscripción actual
`maxExecute`	número máximo de ejecuciones de estrategia (y barridos) que puedes tener corriendo a la vez a través de la API. Arrancar una por encima de este número se responde con `429`, cuyo mensaje lleva el mismo número. El valor ya incluye el margen de API que tenga tu plan
`maxRangeDays`	longitud máxima, en días, del rango de tiempo de un backtest sobre uno de tus propios conjuntos de datos
`maxSweepCartesian`	cuadrícula completa más grande, en combinaciones de parámetros, que un barrido puede ejecutar con el muestreador `grid`. Una cuadrícula mayor se rechaza con `400`; los muestreadores `random` y `lhs` no están sujetos a él
`maxImportRangeHours`	longitud máxima, en horas, del rango de tiempo de una importación de un conjunto de datos desde un exchange. Consulta Importar un conjunto de datos en lugar de subirlo
`maxDatasets`	número máximo de conjuntos de datos activos que permite tu plan
`maxDatasetBytes`	tamaño máximo, en bytes, de una sola versión de un conjunto de datos tal como se almacena (los `bytes` de su versión lista: para una subida CSV, el fichero convertido, no el que subes). Consulta Límites de tamaño
`maxTotalStorageBytes`	almacenamiento combinado máximo, en bytes, entre todos los conjuntos de datos, señales de ejecución de estrategia y estrategias registradas de tu cuenta — ver abajo

Obtener tu uso en vivo

GET /account/usage — cuánto de maxTotalStorageBytes estás usando ahora mismo. Una sola bolsa compartida, no un tope por tipo de recurso: los conjuntos de datos, las señales de ejecución de estrategia y las estrategias registradas cuentan todos contra el mismo total, ya que compiten por el mismo almacenamiento subyacente. No garantizado en tiempo real — una subida o ejecución de estrategia recién terminada puede tardar un instante en reflejarse aquí.

curl https://api.qtsurfer.net/v1/account/usage 
  -H "Authorization: Bearer $TOKEN"

{
  "datasetsUsed": 2,
  "datasetBytesUsed": 15728640,
  "signalsUsed": 1,
  "signalBytesUsed": 524288,
  "strategiesUsed": 4,
  "strategyBytesUsed": 40960,
  "storageBytesUsed": 16293888,
  "_links": {
    "self": { "href": "/v1/account/usage" },
    "account": { "href": "/v1/account" }
  }
}

Campo	Notas
`datasetsUsed` / `datasetBytesUsed`	conjuntos de datos activos y sus bytes combinados de la versión actual — el mismo conjunto que limita `maxDatasets`
`signalsUsed` / `signalBytesUsed`	subidas de señales de ejecución de estrategia registradas y sus bytes combinados
`strategiesUsed` / `strategyBytesUsed`	estrategias registradas y los bytes combinados de la fuente de cada una más su bytecode compilado más reciente (las compilaciones sustituidas no cuentan)
`storageBytesUsed`	`datasetBytesUsed + signalBytesUsed + strategyBytesUsed` — el número que se compara con `maxTotalStorageBytes` de `GET /account`

Dónde se aplica el límite

maxTotalStorageBytes se comprueba cuando añades nuevos bytes de conjunto de datos — POST /datasets/{datasetId}/uploads/{uploadId}/finalize y POST /datasets/imports devuelven ambos 429 si tu cuenta ya está en el límite o por encima (consulta Conjuntos de datos para el texto exacto). Las señales de ejecución de estrategia y las estrategias registradas se reflejan en storageBytesUsed pero no disparan un 429 por sí mismas hoy — elimina un conjunto de datos para liberar espacio si estás en tu límite.

Guías relacionadas

Conjuntos de datos — el recurso que cuenta hacia, y puede quedar bloqueado por, maxTotalStorageBytes.
Estrategias — las estrategias registradas cuentan hacia strategyBytesUsed.