Skip to main content

​
Overview

list_subscriptions returns all marketplace model subscriptions for the authenticated user — including active, expired, and trial subscriptions. Auth required.

​
Parameters

​
status
string
Filter by subscription status. Accepted values:
ValueDescription
"active"Currently active subscriptions only (default)
"expired"Expired subscriptions
"all"All subscriptions regardless of status
​
limit
integer
Maximum results to return. Default: 20. Max: 100.

​
Returns

{
  "total": 2,
  "subscriptions": [
    {
      "subscription_id": "sub_8f2a1c9d",
      "model_id": "qx-mom-us-001",
      "model_name": "US Large-Cap Momentum",
      "plan": "trial",
      "status": "active",
      "started_at": "2026-04-06T09:15:00Z",
      "expires_at": "2026-04-20T09:15:00Z",
      "trial": true,
      "days_remaining": 14
    },
    {
      "subscription_id": "sub_3d1b9e7f",
      "model_id": "qx-factor-007",
      "model_name": "Global Multi-Factor",
      "plan": "monthly",
      "status": "active",
      "started_at": "2026-03-01T00:00:00Z",
      "expires_at": "2026-05-01T00:00:00Z",
      "trial": false,
      "days_remaining": 25
    }
  ]
}
FieldDescription
subscription_idUnique subscription ID
status"active" or "expired"
days_remainingDays until expiry (null if expired)
trialWhether the subscription is a free trial

​
Example

{
  "status": "active"
}

​
Next Step

Use an active model_id from the results as input to run_signal.