# Stockbit



Stockbit's own market data and community — one instrument's live snapshot and chart, the trending board, its glossary, and the community's discussion streams and members.



## Stockbit Quote

One instrument's live snapshot on Stockbit — price, change, best bid/offer, and market status.

- Method: `GET`
- Path: `/v1/market/stockbit/quote`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `symbol` | string | required | The instrument's ticker. |
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |

**Example request**

```bash
curl https://api.diraz.ae/v1/market/stockbit/quote \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "symbol": "BBCA",
    "name": "Bank Central Asia Tbk.",
    "sector": "Financials",
    "sub_sector": "Banks",
    "last": 9350,
    "previous_close": 9300,
    "change": 50,
    "change_percent": 0.54,
    "volume": 42123400,
    "average_value": 1250000000,
    "best_bid": { "price": 9350, "volume": 12000 },
    "best_offer": { "price": 9375, "volume": 8000 },
    "trading_date": "2026-08-21",
    "trading_time": "15:59:59",
    "market_status": "closed",
    "updated_at": "2026-08-21T08:59:59.000Z",
    "followers": 812345,
    "indexes": ["LQ45", "IDX30"],
    "tradeable": true
  },
  "meta": {
    "request_id": "req_7Q2fK4mZ",
    "as_of": "2026-08-21T08:59:59.000Z",
    "age_seconds": 3600,
    "next_update_at": "2026-08-23T08:59:59.000Z"
  }
}
```

## Stockbit Chart

One instrument's intraday price series on Stockbit.

- Method: `GET`
- Path: `/v1/market/stockbit/chart`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `symbol` | string | required | The instrument's ticker. |
| `count` | integer | optional | How many of the most recent points to return. |
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |

**Example request**

```bash
curl https://api.diraz.ae/v1/market/stockbit/chart \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "symbol": "BBCA",
    "trading_date": "2026-08-21",
    "previous_close": 9300,
    "items": [
      { "time": "2026-08-21T02:00:00.000Z", "price": 9300, "change": 0, "change_percent": 0 },
      { "time": "2026-08-21T02:30:00.000Z", "price": 9325, "change": 25, "change_percent": 0.27 },
      { "time": "2026-08-21T08:59:59.000Z", "price": 9350, "change": 50, "change_percent": 0.54 }
    ]
  },
  "meta": {
    "request_id": "req_9nP1wYh2",
    "as_of": "2026-08-21T08:59:59.000Z",
    "age_seconds": 3600,
    "next_update_at": "2026-08-23T08:59:59.000Z"
  }
}
```

## Stockbit Trending

The community's current trending board on Stockbit.

- Method: `GET`
- Path: `/v1/market/stockbit/trending`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |

**Example request**

```bash
curl https://api.diraz.ae/v1/market/stockbit/trending \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "items": [
      { "symbol": "BBCA", "name": "Bank Central Asia Tbk.", "last": 9350, "change": 50, "change_percent": 0.54, "tradeable": true },
      { "symbol": "BBRI", "name": "Bank Rakyat Indonesia Tbk.", "last": 4820, "change": -20, "change_percent": -0.41, "tradeable": true }
    ]
  },
  "meta": {
    "request_id": "req_3fL8bQx4",
    "as_of": "2026-08-21T08:59:59.000Z",
    "age_seconds": 3600,
    "next_update_at": "2026-08-23T08:59:59.000Z"
  }
}
```

## Stockbit Profile

A company's own written profile on Stockbit — sector, background, and index membership.

- Method: `GET`
- Path: `/v1/market/stockbit/profile`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `symbol` | string | required | The instrument's ticker. |
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |

**Example request**

```bash
curl https://api.diraz.ae/v1/market/stockbit/profile \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "symbol": "BBCA",
    "name": "Bank Central Asia Tbk.",
    "sector": "Financials",
    "sub_sector": "Banks",
    "exchange": "IDX",
    "listing_status": "Listed",
    "background": "PT Bank Central Asia Tbk. is a private bank offering retail and corporate banking services across Indonesia.",
    "icon_url": "https://assets.stockbit.com/logos/BBCA.png",
    "followers": 812345,
    "indexes": ["LQ45", "IDX30"]
  },
  "meta": {
    "request_id": "req_5wD2rTk9",
    "as_of": "2026-08-21T08:59:59.000Z",
    "age_seconds": 3600,
    "next_update_at": "2026-08-23T08:59:59.000Z"
  }
}
```

## Stockbit Glossary

Stockbit's investing-terms glossary — definitions, formulas, and worked explanations.

- Method: `GET`
- Path: `/v1/market/stockbit/glossary`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `q` | string | optional | Search terms and definitions. |
| `letter` | string | optional | Only terms starting with this letter. |
| `limit` | integer | optional | Maximum terms to return. |
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |

**Example request**

```bash
curl https://api.diraz.ae/v1/market/stockbit/glossary \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "total": 1,
    "items": [
      {
        "slug": "altman-z-score",
        "term": "Altman Z-Score",
        "letter": "A",
        "definition": "A formula that predicts the probability of a company going bankrupt within two years.",
        "formula": "Z = 1.2A + 1.4B + 3.3C + 0.6D + 1.0E",
        "explanation": "A score above 3 suggests a company is unlikely to go bankrupt, below 1.8 suggests distress, and in between is a grey zone."
      }
    ]
  },
  "meta": {
    "request_id": "req_1hB7mNc3",
    "as_of": "2026-08-21T08:59:59.000Z",
    "age_seconds": 3600,
    "next_update_at": "2026-08-23T08:59:59.000Z"
  }
}
```

## Stockbit Stream

The community's live discussion feed for one instrument on Stockbit.

- Method: `GET`
- Path: `/v1/market/stockbit/stream`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `symbol` | string | required | The instrument's ticker. |
| `count` | integer | optional | Maximum posts to return. |
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |

**Example request**

```bash
curl https://api.diraz.ae/v1/market/stockbit/stream \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "symbol": "BBCA",
    "items": [
      {
        "id": 918273645,
        "username": "investor_id",
        "full_name": "Budi Santoso",
        "content": "BBCA breaking out above 9300, volume picking up.",
        "likes": 24,
        "replies": 3,
        "dislikes": 0,
        "is_pinned": false,
        "is_official": false,
        "images": [],
        "tickers": ["BBCA"],
        "created_at": "2026-08-21T07:15:00.000Z"
      }
    ]
  },
  "meta": {
    "request_id": "req_2kX9pLs6",
    "as_of": "2026-08-21T08:59:59.000Z",
    "age_seconds": 3600,
    "next_update_at": "2026-08-23T08:59:59.000Z"
  }
}
```

## Stockbit User

One member's public profile on Stockbit.

- Method: `GET`
- Path: `/v1/market/stockbit/user`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `username` | string | required | The member's Stockbit handle. |
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |

**Example request**

```bash
curl https://api.diraz.ae/v1/market/stockbit/user \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "username": "investor_id",
    "full_name": "Budi Santoso",
    "avatar_url": "https://assets.stockbit.com/avatars/investor_id.jpg",
    "followers": 4210,
    "following": 180,
    "ideas": 342,
    "is_verified": false,
    "joined_at": "2019-03-12T00:00:00.000Z"
  },
  "meta": {
    "request_id": "req_6tY4vQe1",
    "as_of": "2026-08-21T08:59:59.000Z",
    "age_seconds": 3600,
    "next_update_at": "2026-08-23T08:59:59.000Z"
  }
}
```

## Stockbit Post

One post by id from Stockbit's community stream.

- Method: `GET`
- Path: `/v1/market/stockbit/post`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `id` | string | required | The post's id. |
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |

**Example request**

```bash
curl https://api.diraz.ae/v1/market/stockbit/post \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "id": 918273645,
    "url": "https://stockbit.com/post/918273645",
    "username": "investor_id",
    "full_name": "Budi Santoso",
    "content": "BBCA breaking out above 9300, volume picking up.",
    "likes": 24,
    "replies": 3,
    "reposts": 1,
    "dislikes": 0,
    "is_official": false,
    "images": [],
    "created_at": "2026-08-21T07:15:00.000Z"
  },
  "meta": {
    "request_id": "req_8mR3dNw7",
    "as_of": "2026-08-21T08:59:59.000Z",
    "age_seconds": 3600,
    "next_update_at": "2026-08-23T08:59:59.000Z"
  }
}
```

## Stockbit User Stream

Everything one member has posted on Stockbit.

- Method: `GET`
- Path: `/v1/market/stockbit/user-stream`

**Parameters**

| Name | Type | | Description |
|---|---|---|---|
| `username` | string | required | The member's Stockbit handle. |
| `count` | integer | optional | Maximum posts to return. |
| `max_age` | integer (seconds) | optional | Ask for data no older than this. Clamped to the product's own floor, so it can narrow the window but never force a refresh on every call. |

**Example request**

```bash
curl https://api.diraz.ae/v1/market/stockbit/user-stream \
  -H "Authorization: Bearer drz_live_…"
```

**Example response**

```json
{
  "data": {
    "username": "investor_id",
    "items": [
      {
        "id": 918273645,
        "username": "investor_id",
        "full_name": "Budi Santoso",
        "content": "BBCA breaking out above 9300, volume picking up.",
        "likes": 24,
        "replies": 3,
        "dislikes": 0,
        "is_pinned": false,
        "is_official": false,
        "images": [],
        "tickers": ["BBCA"],
        "created_at": "2026-08-21T07:15:00.000Z"
      }
    ]
  },
  "meta": {
    "request_id": "req_4pC6jVy8",
    "as_of": "2026-08-21T08:59:59.000Z",
    "age_seconds": 3600,
    "next_update_at": "2026-08-23T08:59:59.000Z"
  }
}
```