ஸ்மார்ட்ஏபிஐ டாக்குமெண்டேஷன் குறித்து தெரிந்து கொள்வோம்!

வணக்கம் வாசகர்களே; தொழில்நுட்பப் பின்னணி இல்லாதவர்கள் ஸ்மார்ட்ஏபிஐ டாக்குமெண்டேஷன் மற்றும் போரம் போன்ற தொழில்நுட்ப ஆவணங்களையும், கலந்துரையாடல் தளங்களையும் கையாள்வது பல நேரங்களில் கடினமாக இருப்பதை நாங்கள் கவனித்துள்ளோம்.

யூசர்களின் கருத்துக்களை நாங்கள் தினமும் பரிசீலித்து, எங்களின் ஆவணங்களை மேம்படுத்தி வந்தாலும், அது அனைவருக்கும் எளிதாகப் புரியும் வகையில் இல்லாமல் இருக்கலாம் என்பதை நாங்கள் உணர்கிறோம். எனவே, இந்த கட்டுரை, ஸ்மார்ட் ஏபிஐ டாக்குமெண்டேஷனின் ஒவ்வொரு பகுதியும் என்ன சொல்கிறது என்பதை நீங்கள் எளிதாகப் புரிந்து கொள்ள உதவும்.

ஸ்மார்ட் ஏபிஐ டாக்குமெண்டேஷன்

எந்தவொரு தொழில்நுட்ப ஆவணத்தின் முக்கிய நோக்கமும், டெவலப்பர்களுக்கு ஒரு குறிப்பிட்ட வழிகாட்டியாக அமைவதே ஆகும். API எவ்வாறு செயல்படும், எந்த வகையான கோரிக்கைகளை அவர்கள் அனுப்பலாம், ஒரு நொடிக்கு எத்தனை கோரிக்கைகளை அனுப்ப முடியும் போன்ற சந்தேகங்கள் எழும்போது அவர்கள் இந்த ஆவணத்தைப் பார்த்துத் தெரிந்துகொள்ளலாம்.

இணையத்தில் ஸ்மார்ட் ஏபிஐ பற்றி இருக்கும் மற்ற எல்லாத் தகவல்களையும் விட, இந்த அதிகாரப்பூர்வ ஆவணமே முதன்மையான மற்றும் துல்லியமான ஆதாரமாகக் கருதப்பட வேண்டும். இதை உங்களுக்காக நாங்கள் எளிமையாக தயாரித்துள்ளோம், அவற்றை சுருக்கமாகப் பார்ப்போம்.

ஏபிஐ என்றால் என்ன?

ஏபிஐ என்பதை ஒரு கேட்வே, அதாவது நுழைவாயில் போல நினைத்துப் பாருங்கள். தகவல்களைச் சேகரிப்பதற்கான அல்லது தகவல்களை அனுப்புவதற்கான உங்கள் நுழைவாயில் அது. உதாரணத்திற்கு, பல பகுதிகளைக் கொண்ட ஒரு சூப்பர் மார்க்கெட்டை எடுத்துக் கொள்வோம்.

நீங்கள் ஆடைகள் வாங்க விரும்பினால் ஆடைகள் இருக்கும் பகுதிக்குச் செல்லவீர்கள், சமையல் எண்ணெய் வாங்க விரும்பினால் உணவு பொருட்கள் இருக்கும் பகுதிக்குச் செல்லவீர்கள், அதுபோல உங்கள் கிஃப்ட் வவுச்சரை மாற்ற விரும்பினால் பில்லிங் பகுதிக்குச் செல்லவீர்கள். இந்த ஒவ்வொரு பகுதியும் உங்களுக்கான ஒரு நுழைவாயிலாகச் செயல்படுகிறது. அதே முறையில், ஒரு ஏபிஐ உங்களது மார்ஜின் பேலன்ஸ் விவரங்களைப் பெறவும், ஆர்டர்களைச் செய்யவும், ஆர்டர்களை மாற்றியமைக்கவும் உங்களை அனுமதிக்கிறது.

லைப்ரரிகள் மற்றும் SDK-க்கள்

சாஃப்ட்வேர் டெவலப்மெண்ட் கிட்கள் டெவலப்பர்களுக்கு மிகவும் பயனுள்ளதாக இருக்கும். நீங்கள் ஒரு தாய்லாந்து சூப்பர் மார்க்கெட்டில் இருப்பதாகக் கற்பனை செய்துக் கொள்ளுங்கள், உங்களுக்குத் தாய்லாந்து மொழி தெரியாது. அங்குள்ள உள்ளூர் வழிகாட்டி ஒருவரின் உதவியை நீங்கள் நாடுகிறீர்கள். அவர் சூப்பர் மார்க்கெட்டின் வெவ்வேறு பகுதிகளில் உள்ள நபர்களுடன் தொடர்புகொண்டு உங்களுக்குத் தேவையானதை மிகச் சிறந்த முறையில் பெற்றுத் தருகிறார்.

இப்போது அந்த உள்ளூர் வழிகாட்டி உங்களுக்கு ஒரு SDK போலச் செயல்படுகிறார். ஏஞ்சல் ஒன் குழு உங்களுக்குப் பல மொழிகளில் SDK-க்களை வழங்கியுள்ளது. ஏபிஐ -ன் ஒவ்வொரு நுழைவாயிலையும் தனித்தனியாகக் கையாளும் கவலை இல்லாமல், உங்கள் விதி சார்ந்த உத்திகளை உருவாக்க உங்களுக்குப் பிடித்தமான மொழியை நீங்கள் பயன்படுத்திக் கொள்ளலாம். எங்களது அனைத்து SDK-க்களையும் இந்த Github பக்கத்தில் நீங்கள் காணலாம்.

ரெஸ்பான்ஸ் ஸ்ட்ரக்சர்

ஆவணத்தில் உள்ள ரெஸ்பான்ஸ் ஸ்ட்ரக்சர்பகுதி, ஏபிஐ அல்லது SDK மூலம் அனுப்பப்படும் கோரிக்கையின் பதிலை விளக்குகிறது. இந்த பதில் எப்போதும் JSON வடிவத்தில் பெறப்படுகிறது, இது புரோகிராமிங் உலகில் மிகவும் தரநிலையான தரவுப் வடிவமாகும்.

ஒரு ஏபிஐ கோரிக்கை வெற்றிகரமாக இருக்கும்போதும் அல்லது தோல்வியடையும் போதும் அதன் பதில் எவ்வாறு இருக்கும் என்பதற்கான உதாரணங்களை இந்த ஆவணம் காட்டுகிறது. நுழைவாயில்களை அணுக நீங்கள் SDK-ஐப் பயன்படுத்தினால், ஹெடர் பாராமீட்டர்கள் குறித்து நீங்கள் கவலைப்பட வேண்டியதில்லை.

எரர் கோடுகள்

பிழைகள் ஏற்படுவது இயல்பு; நாம் எவ்வளவுதான் தடுக்க முயன்றாலும் அவை நடக்கவே செய்கின்றன. ஸ்மார்ட் ஏபிஐ அல்லது ஏதேனும் ஒரு SDK-ஐப் பயன்படுத்தும் போது, தகவலைச் செயலாக்கத் தேவையான அனைத்து விவரங்களும் உங்கள் கோரிக்கையில் இல்லை என்றாலோ அல்லது தவறான விவரங்கள் (தவறான பாஸ்வேர்ட், தவறான டிக்கர் போன்றவை) இருந்தாலோ, உங்களுக்கு ஒரு எரர் கோடு வரும். ஒவ்வொரு எரர் கோடும் என்ன அர்த்தத்தைக் குறிக்கிறது என்பதை இந்தப் பக்கம் உங்களுக்குத் தெரிவிக்கிறது.

யூசர்

நீங்கள் நேரடியாக ஏபிஐ எண்ட் பாயிண்ட்டைப் பயன்படுத்துகிறீர்கள் என்றால், Python, NodeJS, Go, Java, R போன்ற பல மொழிகளுக்கான குறியீட்டு உதாரணங்களை இந்தப் பக்கம் காட்டுகிறது. இருப்பினும், நீங்கள் ஒரு புதிய கோடராக இருந்தால், உங்கள் வேலையை எளிதாக்கும் SDK-க்களைப் பயன்படுத்துமாறு நாங்கள் பரிந்துரைக்கிறோம். லாக்-இன் செய்வது எப்படி, ஏஞ்சல் ஒன் சர்வர்களில் உங்களை எவ்வாறு அங்கீகரிப்பது, பின்னர் லாக்-அவுட் செய்வது எப்படி என்பதற்கான உதாரணங்களை நீங்கள் இங்குப் பெறலாம்.

குட் டில் டிரிக்கர்

டெலிவரி மற்றும் மார்ஜின பிரிவுகளில் NSE மற்றும் BSE எக்ஸ்சேஞ்ச்களில் குட் டில் டிரிக்கர் ஆர்டர்களைச் செய்வதற்கான வசதியை ஸ்மார்ட் ஏபிஐ உங்களுக்கு வழங்குகிறது. நீங்கள் தினசரி கண்காணிக்கத் தேவையில்லாத நீண்ட கால ஆர்டரைச் செய்ய விரும்பும் போது GTT ஆர்டர்கள் மிகவும் பயனுள்ளதாக இருக்கும்; உங்கள் விலை வந்தவுடன் அது தானாகவே இயங்கி அந்தப் பொசிஷனுக்குள் நுழைந்துவிடும். புதிய GTT விதிகளை உருவாக்குவது, அவற்றை மாற்றுவது மற்றும் ரத்து செய்வது போன்றவற்றுக்கான குறியீட்டு உதாரணங்களை ஆவணத்தின் இந்தப் பகுதி வழங்குகிறது.

ஆர்டர்கள்

எங்களது ஸ்மார்ட்ஏபிஐ-ல் மிகவும் பரவலாகப் பயன்படுத்தப்படும் அம்சம் ஆர்டர்ஸ் எண்ட் பாயிண்ட் ஆகும். ஏபிஐ-கள் மூலம் உங்கள் புரோக்கரேஜ் கணக்கில் ஆர்டர்களை எவ்வாறு செய்வது, மாற்றுவது மற்றும் ரத்து செய்வது என்பதற்கான குறியீட்டு உதாரணங்களையும், ரெஸ்பான்ஸ் ஸ்ட்ரக்சரையும் இந்த ஆவணங்கள் உங்களுக்கு வழங்கும்.

ஆர்டர்ஸ் எண்ட் பாயிண்ட் மூலம் அன்றைய தினத்தில் நீங்கள் செய்த அனைத்து வர்த்தகங்களின் பட்டியலையும் நீங்கள் பெறலாம். மேலும் நீங்கள் குறிப்பிடும் எந்தவொரு குறியீட்டின் LTP (Last Traded Price - கடைசி வர்த்தக விலை) விவரத்தையும் பெற இது உங்களை அனுமதிக்கும்.

போர்ட்ஃபோலியோ

ஏஞ்சல் ஒன் நிறுவனத்தில் நீங்கள் வைத்துள்ள போர்ட்ஃபோலியோ பற்றிய அனைத்து தகவல்களையும் இந்த எண்ட் பாயிண்ட் வழங்குகிறது. உங்களுடைய அனைத்து ஹோல்டிங்ஸ், பொசிஷன்ஸ் ஆகியவற்றைப் பெறுவது எப்படி என்பதற்கான உதாரணத்தை இந்த ஆவணம் வழங்குகிறது. மேலும் உங்களிடம் இருக்கும் பொசிஷனை வேறு தயாரிப்பு வகைக்கு (உதாரணமாக INTRADAY-லிருந்து DELIVERY-க்கு) மாற்றுவதற்கான ஆப்ஷனையும் இது வழங்குகிறது; அடுத்த கட்டுரையில், Python SDK-ஐப் பயன்படுத்தி இதற்கான சில உதாரணங்களை நாங்கள் உங்களுக்குக் காட்டுவோம்.

போஸ்ட்பேக்

நீங்கள் ஏபிஐ-கள் அல்லது SDK-க்கள் மூலம் ஆர்டர் செய்யும்போது, உங்கள் ஆர்டர் ஐடி-யுடன் கூடிய JSON பதில் உங்களுக்குக் கிடைக்கும். போஸ்ட்பேக் அம்சம் (நீங்கள் அதைச் செயல்படுத்தியிருந்தால்), ஏபிஐ கீயை உருவாக்கும் போது நீங்கள் வழங்கிய போஸ்ட்பேக் URL-ல் முழுமையான ஆர்டர் பதிலைப் பெற உங்களை அனுமதிக்கிறது. இது கட்டாயமான ஒன்று அல்ல, ஆனால் நீங்கள் இதை அமைக்க விரும்பினால் ஒரு சாம்பிள் பதிலை இது வழங்குகிறது.

ஹிஸ்டாரிகல் ஏபிஐ

ஸ்மார்ட்ஏபிஐ யூசர்களிடையே மிகவும் பிரபலமான மற்றொரு எண்ட் பாயிண்ட் இதுவாகும். இந்த பகுதி API-கள் மூலம் NSE பிரிவு மற்றும் NFO ஃபியூச்சர்ஸ்களில் உள்ள அனைத்து பங்குகளுக்கான வரலாற்றுத் தரவை வெவ்வேறு மொழிகளில் எவ்வாறு பெறுவது என்பதற்கான மாதிரி குறியீட்டை உங்களுக்கு வழங்குகிறது. எங்களது எதிர்காலக் கட்டுரையில் இந்த அம்சத்தை நீங்கள் எவ்வாறு பயன்படுத்தலாம் என்பதைக் காட்ட நாங்கள் Python SDK-ஐப் பயன்படுத்துவோம். எனவே தொடர்ந்து இணைந்திருங்கள்!

பப்ளிஷர் JS பிளகின

ஒரே கிளிக்கில் ஆர்டர்களை இயக்கவும், ஏஞ்சல் ஒன் தளத்தில் பங்குகளை வாங்க/விற்கவும் தங்கள் வாடிக்கையாளர்களுக்கு டைனமிக் பட்டன்களை உருவாக்க விரும்பும் வாசகர்களுக்கு இந்தப் பகுதி பயனுள்ளதாக இருக்கும். இது ஜாவாஸ்கிரிப்ட் மொழியில் உள்ளது, மேலும் இந்த பட்டன்களை உங்கள் இணையதளம், மொபைல் ஆப், டெலிகிராம் சாட்போட்கள் மற்றும் பிற தளங்களில் இணைக்க முடியும். இந்த ஆவணம் பல்வேறு வகையான பட்டன்களுக்கான மாதிரி குறியீடுகளை உங்களுக்கு வழங்கும்.

வெப்சாக்கெட் ஸ்ட்ரீமிங்

வெப்சாக்கெட்ஸ் (Websockets - WSS) என்பது அடிப்படையில் நமக்கும் புரோக்கர் சர்வர்களுக்கும் இடையிலான ஒரு இணைப்பாகும், அங்கு சர்வரில் இருந்து தொடர்ச்சியான பங்கு விலை தகவல்களை நாம் கோருகிறோம். புரோக்கர் அல்லது வாடிக்கையாளர் இந்த இணைப்பை நிறுத்தும் வரை, அது தொடர்ச்சியான நேரலை விலைகளை (stream of prices) வழங்குகிறது. ஆவணத்தில் உள்ள இந்தப் பக்கம், நேரலை விலைகளின் ஸ்ட்ரீமைப் பெற நீங்கள் எவ்வாறு API எண்ட் பாயிண்ட்டைப் பயன்படுத்தலாம் மற்றும் ஆர்டர்களைச் செய்ய உங்கள் விதி சார்ந்த உத்தியின் மூலம் அவற்றை எவ்வாறு இயக்கலாம் என்பதைக் காட்டுகிறது. Python SDK-க்கள் மூலம் வெப்சாக்கெட்டுகளை எவ்வாறு பயன்படுத்துவது என்பதுபற்றி கட்டுரை விரைவில் வெளிவரும்.

வெப்சாக்கெட் ஆர்டர் ஸ்டேட்டஸ்

சந்தைகளில் நீங்கள் ஒரு லிமிட் (LIMIT) அல்லது ஸ்டாப்லாஸ் (STOPLOSS) ஆர்டரைச் செய்யும்போது, உங்கள் விலை நிபந்தனை பூர்த்தி செய்யப்படாவிட்டால் அது உடனடியாக நிறைவேறாமல் போகலாம். இத்தகைய ஆர்டர்களைக் கண்காணிக்க, யூசர்கள் ஆவணத்தின் இந்த பகுதியைப் பயன்படுத்தி ஆர்டர் ஃபீட்களுக்கு (order feeds) சப்ஸ்கிரைப் செய்யலாம். இதன் மூலம் உங்கள் ஆர்டர் நிறைவேறும் போதோ அல்லது ரத்து செய்யப்படும் போதோ உடனடியாக உங்களுக்கு அறிவிக்கப்படும்.

இன்ஸ்ட்ரூமெண்ட்ஸ்

உங்களுக்குத் தெரிந்தபடி, எப்போதும் IPO-க்கள் நடந்து கொண்டே இருக்கின்றன. அதுமட்டுமின்றி புதிய ஆப்ஷன்கள் மற்றும் ஃபியூச்சர்ஸ் காலாவதி தேதிகளும் (expiries) அவ்வப்போது வருகின்றன. உங்கள் உத்திகளில் அவற்றைப் பயன்படுத்துவதற்காக, இந்த சமீபத்திய இன்ஸ்ட்ரூமெண்ட்ஸ் பட்டியலை புரோகிராமிங் முறையில் பெற SmartAPI உங்களை அனுமதிக்கிறது. இந்தப் பட்டியலை எவ்வாறு பெறுவது என்பதற்கான உதாரணத்தை இந்த ஆவணம் காட்டுகிறது; JSON வடிவிலான தரவு எப்படி இருக்கும் என்பதைச் சரிபார்க்க நீங்கள் இந்த லிங்க்கையும் பார்வையிடலாம்.

ரேட் லிமிட்

எங்களது அனைத்து SmartAPI யூசர்களுக்கும் சமமான சிறந்த சேவையை வழங்குவதற்காக, ஒரு யூசர் ஒவ்வொரு நொடியும் செய்யக்கூடிய API கோரிக்கைகளின் எண்ணிக்கையை நாங்கள் கட்டுப்படுத்துகிறோம். ஆவணத்தில் உள்ள இந்தப் பக்கம் உங்களுக்கு அந்த ரேட் லிமிட்களை வழங்குகிறது; உதாரணமாக, 1 வினாடியில் உங்களால் 10-க்கும் மேற்பட்ட ஆர்டர் கோரிக்கைகளைச் செய்ய முடியாது, ஆனால் அது ஒரு நிமிடத்திற்கு 600 ஆர்டர் கோரிக்கைகளாகும். இந்தத் துறையிலுள்ள மற்ற புரோக்கர்களுடன் ஒப்பிடும்போது இது மிகவும் தாராளமான வரம்பாகும்.

சேஞ்ச்லாக்

SmartAPI-ஐ இன்னும் சிறந்ததாகவும், வலுவானதாகவும், வேகமானதாகவும் மாற்ற காலப்போக்கில் நாங்கள் அதை மேம்படுத்தி வருகிறோம். API-களில் நாங்கள் செய்யும் அனைத்து மாற்றங்களையும் ஆவணத்தில் உள்ள இந்தப் பக்கம் உங்களுக்கு வழங்கும்.

வழக்கம் போல, விதி சார்ந்த வர்த்தகத்தில் (rule-based trading) நீங்கள் சிறந்து விளங்குவதற்கான உங்கள் பயணத்தில் நாங்கள் உறுதியுடன் இருக்கிறோம். எனவே எங்களுக்கான ஆலோசனைகள் அல்லது கருத்துக்கள் ஏதேனும் இருந்தால் அல்லது நாங்கள் ஏதேனும் குறிப்பிட்ட பிளாக்கை எழுத விரும்பினால், தயவுசெய்து கீழே உள்ள பதில்களில் எங்களுக்குத் தெரியப்படுத்துங்கள், நாங்கள் அதை மகிழ்ச்சியுடன் செய்வோம்.

பொறுப்புத் துறப்பு (Disclaimer): 'பத்திரச் சந்தையில் முதலீடு செய்வது சந்தை அபாயங்களுக்கு உட்பட்டது, முதலீடு செய்வதற்கு முன் அது தொடர்பான அனைத்து ஆவணங்களையும் கவனமாகப் படிக்கவும்.'