Subjects

GET /subjects

ListSubjects

Discovers non-asset people, accounts, and topics, including AI-related subjects, and returns canonical subject_id values accepted by subject-aware endpoints. Assets and tickers are deliberately excluded; use /assets for them. Search uses the same canonical names, aliases, merge resolution, and ranking as Nebula's internal subject resolver. Supply query for search or subject_id for exact resolution. Parameter rules: subject_id and query cannot be combined.

Parameters

subject_id string QUERY

Canonical non-asset identifier returned by /subjects. It cannot be combined with asset_id or asset_class.

Example:person:donald_trump

query string QUERY

Case-insensitive search across public identifiers and names.

Example:NVIDIA

limit integer QUERY

Maximum results returned.

Default:50

offset integer QUERY

Number of results skipped.

Default:0

cURL Example

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/subjects' \
  --header 'X-API-Key: YOUR_API_KEY'

Responses

200 OK

400 Bad Request

401 Unauthorized

402 Credit balance exhausted

403 Forbidden

404 Not Found

429 Too Many Requests

500 Internal Server Error

503 Service Unavailable

Media type application/json

has_more

boolean required

True when another page is available after the returned records.

limit

integer required

Maximum records requested.

offset

integer required

Number of matching records skipped.

subjects

array<object> required

Non-asset subjects matching the discovery filters.

subjects[].name

string required

Human-readable name.

subjects[].subject_id

string required

Canonical identifier for a non-asset person, account, or topic.

{
  "has_more": false,
  "limit": 50,
  "offset": 0,
  "subjects": [
    {
      "name": "Artificial Intelligence",
      "subject_id": "text:artificial intelligence"
    }
  ]
}