📈 SmartFeed.API Documentation (v1)

🔐 Authentication

All endpoints require JWT Bearer Token authentication except authenticate.

Include this in your request headers:

Authorization: Bearer <YOUR_TOKEN>
⚠️ Important Note:
  • JWT Bearer Token generated today will expire the at 03:00 AM next day.
  • All endpoints require authentication via Bearer token
  • Version in URL should match API version (currently v1)
  • Response structures may contain additional fields

If Status code is not 200 then response will be

Response: 

{
  "Succeeded": false,
  "Message": "Error Message from Server",
  "Data": null
}
Header:
Content-Type: application/json
Authorization: Bearer eyJhbGciOiJIUzpXVCJ9.eyJ1bmlxdWViQc0Mjk5MzExNH0._6LZ4f96jX

📥 Account Endpoints

POST /api/v1/Account/authenticate
Authenticate User

Authenticate with client credentials

Full URL Example:
https://smartfeed.getlivefeed.xyz/api/v1/Account/authenticate
Request Body: 

{
    "clientcode": "CLIENT123",
    "password": "pass@123"
}
Response (200 OK): 

{
    "succeeded": true,
    "data": {
    "accessToken": "eyJhbGciOiJIUzpXVCJ9.eyJ1bmlxdWViQ2xpZW50IiwiZ1DWCxCU0mJmIjoxNzQyOTkzMmlhdCI6MTc0Mjk5MzExNH0._6LZ4f96jXzKBjxvRR_6b53Pg"
    }
}

📊 Instrument Endpoints

GET /api/v1/Instrument/getExchanges
Get Exchanges
Full URL Example:
https://smartfeed.getlivefeed.xyz/api/v1/Instrument/getExchanges
Response (200 OK): 

{
    "succeeded": true,
    "data": [
    {
        "exchangeName": "NSE",
        "startTime": "09:12:00",
        "endTime": "15:31:00"
    },
    {
        "exchangeName": "MCX",
        "startTime": "08:57:00",
        "endTime": "23:56:00"
    }
    ]
}
POST /api/v1/Instrument/instrumentList
Get Instrument List
Full URL Example:
https://smartfeed.getlivefeed.xyz/api/v1/Instrument/instrumentList
Request Body: 
{
  "exchanges": "NSE,MCX"
}
Response (200 OK): 
{
  "succeeded": true,
  "data": [
    {
      "original_exchange": "MCX",
      "instrument_token": "1124123263",
      "exchange_token": "4386786",
      "name": "GOLD",
      "expiry": "04-Apr-2025",
      "exchange": "MCX",
      "tradingsymbol": "GOLD25APRFUT",
      "instrument_type": "FUT",
      "last_price": "0",
      "lot_size": "1",
      "strike": "0",
      "tick_size": "1"
    },
    {
      "original_exchange": "NSE",
      "instrument_token": "89909856870",
      "exchange_token": "33456803",
      "name": "ABB",
      "expiry": "27-Mar-2025",
      "exchange": "NFO",
      "tradingsymbol": "ABB25MARFUT",
      "instrument_type": "FUT",
      "last_price": "0",
      "lot_size": "125",
      "strike": "0",
      "tick_size": "0.05"
    }
  ]
}
POST /api/v1/Instrument/feedData
Get Instrument Feed Data
Full URL Example:
https://smartfeed.getlivefeed.xyz/api/v1/Instrument/feedData
Request Body: 
{
  "instrumentTokens": "1234,5678"
}
Response (200 OK): 
{
  "succeeded": true,
  "data": [
    {
      "exchangeToken": "431876",
      "instrument_token": "110560263",
      "tradable": true,
      "last_price": "87776",
      "last_quantity": 1,
      "average_price": "87702.78",
      "volume": 5158,
      "buy_quantity": 339,
      "sell_quantity": 236,
      "ohlc_open": "87539",
      "ohlc_high": "87898",
      "ohlc_low": "87458",
      "ohlc_close": "87554",
      "change": "222",
      "buy_price_0": "87771",
      "sell_price_0": "87792",
      "buy_qty_0": 1,
      "sell_qty_0": 1,
      "lastTradeTimeD": "2025-03-26T18:22:21",
      "last_trade_time": "26-03-2025 18:22:21",
      "oi": 6186,
      "oi_day_high": 0,
      "oi_day_low": 0,
      "timestamp": "2025-03-26T18:22:38.378",
      "name": "GOLD",
      "expiry": "04-04-2025",
      "exchange": "MCX",
      "tradingsymbol": "GOLD25APRFUT",
      "lot_size": "1.000",
      "lower_circuit": "84928",
      "upper_circuit": "90180",
      "net_change": "222",
      "percentage_change": "0.25",
      "buy": [
        {
          "quantity": 1,
          "price": 87771,
          "orders": 0,
          "flag": 0
        },
        {
          "quantity": 2,
          "price": 87770,
          "orders": 0,
          "flag": 0
        },
        {
          "quantity": 1,
          "price": 87769,
          "orders": 0,
          "flag": 0
        },
        {
          "quantity": 1,
          "price": 87768,
          "orders": 0,
          "flag": 0
        },
        {
          "quantity": 2,
          "price": 87767,
          "orders": 0,
          "flag": 0
        }
      ],
      "sell": [
        {
          "quantity": 1,
          "price": 87792,
          "orders": 0,
          "flag": 0
        },
        {
          "quantity": 2,
          "price": 87793,
          "orders": 0,
          "flag": 0
        },
        {
          "quantity": 2,
          "price": 87794,
          "orders": 0,
          "flag": 0
        },
        {
          "quantity": 1,
          "price": 87795,
          "orders": 0,
          "flag": 0
        },
        {
          "quantity": 2,
          "price": 87797,
          "orders": 0,
          "flag": 0
        }
      ],
      "the52WeekHigh": 89796,
      "the52WeekLow": 0
    },
    {
      "exchangeToken": "35003",
      "instrument_token": "8960770",
      "tradable": false,
      "last_price": "5520.3",
      "last_quantity": 125,
      "average_price": "5531.92",
      "volume": 1334750,
      "buy_quantity": 26500,
      "sell_quantity": 22250,
      "ohlc_open": "5434.55",
      "ohlc_high": "5612.2",
      "ohlc_low": "5395.8",
      "ohlc_close": "5407.15",
      "change": "0",
      "buy_price_0": "5518.25",
      "sell_price_0": "5518.25",
      "buy_qty_0": 125,
      "sell_qty_0": 250,
      "lastTradeTimeD": "2025-03-26T16:48:35.707",
      "last_trade_time": "26-03-2025 15:29:58",
      "oi": 1314375,
      "oi_day_high": 0,
      "oi_day_low": 0,
      "timestamp": "2025-03-26T16:48:35.707",
      "name": "ABB",
      "expiry": "27-03-2025",
      "exchange": "NSE",
      "tradingsymbol": "ABB25MARFUT",
      "lot_size": "125.000",
      "lower_circuit": "4866.45",
      "upper_circuit": "5947.9",
      "net_change": "113.15",
      "percentage_change": "2.09",
      "buy": [],
      "sell": [],
      "the52WeekHigh": 5612.2,
      "the52WeekLow": 0
    }
  ]
}