Kitta API Documentation

Kitta aggregates Nepse data from various sources to redistribute it in a managed way. The API is rate-limited to 5 requests per second. To use the API, you need to get an API key from here and include it in the Authorization header as Authorization: Api Key.

Endpoints

/stocks/date_wise_price

POST

Get share market for a date.

Request Body

{
  "date": "2022-01-01"
}

Response

{
  "data": []
}

Example Code

JavaScript:

fetch('/stocks/date_wise_price', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Api Key'
  },
  body: JSON.stringify({
    date: '2022-01-01'
  })
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error(error))

Python:

import requests

response = requests.post('https://api.kitta.dev/stocks/date_wise_price', headers={
  'Content-Type': 'application/json',
  'Authorization': 'Api Key'
}, json={
  'date': '2022-01-01'
})

print(response.json())

/stocks/live

GET

Get live share prices.

Response

{
  "data": []
}

Example Code

JavaScript:

fetch('/stocks/live', {
  headers: {
    'Authorization': 'Api Key'
  }
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error(error))

Python:

import requests

response = requests.get('https://api.kitta.dev/stocks/live', headers={
  'Authorization': 'Api Key'
})

print(response.json())

/misc/brokers/

GET

Fetch all broker & dealer information.

Response

[
  {
    "id": 0,
    "activeStatus": "",
    "clearingMemberId": 0,
    "memberCode": "",
    "memberName": "",
    "membershipTypeMaster": {},
    "authorizedContactPerson": "",
    "authorizedContactPersonNumber": "",
    "provinceList": [],
    "districtList": [],
    "municipalities": [],
    "memberTMSLinkMapping": {},
    "isDealer": "",
    "memberBranchMappings": []
  }
]

Example Code

JavaScript:

fetch('/misc/brokers/', {
  headers: {
    'Authorization': 'Api Key'
  }
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error(error))

Python:

import requests

response = requests.get('https://api.kitta.dev/misc/brokers/', headers={
  'Authorization': 'Api Key'
})

print(response.json())

/misc/holidays/

GET

Fetch all the holidays for a year, Saturdays are not counted.

Parameters

• year (required): Year for which holidays are to be fetched.

Response

[
  {
    "id": 0,
    "instrumentTypeId": 0,
    "holidayDate": "",
    "holidayDescription": "",
    "modifiedBy": "",
    "modifiedDate": "",
    "activeStatus": ""
  }
]

Example Code

JavaScript:

fetch('/misc/holidays/?year=2022', {
  headers: {
    'Authorization': 'Api Key'
  }
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error(error))

Python:

import requests

response = requests.get('https://api.kitta.dev/misc/holidays/?year=2022', headers={
  'Authorization': 'Api Key'
})

print(response.json())

/misc/companies/

GET

Fetch all the companies listed in Nepse.

Response

[
  {
    "id": 0,
    "companyName": "",
    "symbol": "",
    "securityName": "",
    "status": "",
    "companyEmail": "",
    "website": "",
    "sectorName": "",
    "regulatoryBody": "",
    "instrumentType": ""
  }
]

Example Code

JavaScript:

fetch('/misc/companies/', {
  headers: {
    'Authorization': 'Api Key'
  }
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error(error))

Python:

import requests

response = requests.get('https://api.kitta.dev/misc/companies/', headers={
  'Authorization': 'Api Key'
})

print(response.json())