Quick Start
- disclaimer
The PathLit API is currently in alpha preview. What does it mean? - first of all, it's free as we are still figuring out how the final product should look like to best fit our audience use case. We are learning what our users need in order to help them solve problems, and really appreciate your feedback.
Second, the platform performance is not (yet) optimised. Concretely, you can expect some endpoints to respond anywhere from 5 to 15 seconds per call.
Finally, despite being in early stages, the computations are tested and validated, thus reliable.
#
Using the PathLit Engine APILet's imagine a scenario where you are allocating some instruments: "ADBE", "T", "CSCO", "JNJ", "AMZN", "BRK-B", "BAC", "PG", "KO", "AAPL", "JPM", "MSFT"
info
If you haven't done it yet, you need to create an account in order to generate an API key (or token). It's really fast and easy.
#
(optional) Retrieving the supported symbolsPathLit currently supports around 800 symbols, you can retrieve them and make sure the one you at interested in are there (the response is truncated):
- Example request
- Response
curl --location --request GET 'https://engine.pathlit.io/v1/timeseries/info' \--header 'x-api-key: xxxxxxxx'
[ "ADBE", "T", "XOM", "CSCO", "WMT", "JNJ", "AMZN", "QCOM", "BRK-B", "BAC", "PG", "PFE", "KO", "AAPL", "CMCSA", "JPM", "ABT", "MSFT"]
#
Get the weights for the symbols- Example request
- Response
curl --location --request GET 'https://engine.pathlit.io/v1/timeseries/info' \--header 'x-api-key: xxxxxxxx' \--data-raw '{ "tickers": [ "ADBE", "T", "CSCO", "JNJ", "AMZN", "BRK-B", "BAC", "PG", "KO", "AAPL", "JPM", "MSFT" ]}'
{ "l1r.l2d.l3ewp": [ 0.0833, 0.0833, 0.0833, 0.0833, 0.0833, 0.0833, 0.0833, 0.0833, 0.0833, 0.0833, 0.0833, 0.0833 ], "l1r.l2d.l3gmvp": [ 0.0046, 0.0787, 5.7342e-19, 0.2482, 0.0199, 0.1788, 1.6694e-18, 0.1715, 0.2394, 0.0197, 3.4107e-18, 0.0391 ], "l1r.l2d.l3hrp": [ 0.0333, 0.0978, 0.0671, 0.2091, 0.0236, 0.1227, 0.0415, 0.1154, 0.1303, 0.0462, 0.0432, 0.0697 ], "l1r.l2d.l3ivp": [ 0.06, 0.0976, 0.0693, 0.1244, 0.0505, 0.1079, 0.0538, 0.1124, 0.1194, 0.0586, 0.0648, 0.0813 ], "l1r.l2d.l3mdcp": [ 0.098, 0.0864, 0.0246, 0.0635, 0.1698, 0.0754, 0.0726, 0.1566, 0.1093, 0.1437, 4.8484e-22, 1.8212e-18 ], "l1r.l2d.l3mdp": [ 0.0703, 0.1008, 0.0204, 0.0946, 0.1025, 0.0972, 0.0468, 0.2106, 0.1561, 0.1007, 1.2316e-17, 1.2835e-18 ], "l1r.l2d.l3rpp": [ 0.06, 0.097, 0.0637, 0.1233, 0.0569, 0.1042, 0.0493, 0.127, 0.127, 0.0635, 0.0554, 0.0727 ], "l1r.l2m.l3ewp": [ 0.0833, 0.0833, 0.0833, 0.0833, 0.0833, 0.0833, 0.0833, 0.0833, 0.0833, 0.0833, 0.0833, 0.0833 ], "l1r.l2m.l3gmvp": [ 0.0195, 0.0975, 2.5488e-18, 0.2359, 0.0225, 0.1436, 7.6837e-20, 0.2137, 0.1602, 0.0257, 1.9835e-18, 0.0815 ], "l1r.l2m.l3hrp": [ 0.0399, 0.1027, 0.0688, 0.2084, 0.0258, 0.138, 0.0199, 0.1185, 0.1169, 0.0459, 0.03, 0.0853 ], "l1r.l2m.l3ivp": [ 0.0634, 0.0957, 0.0691, 0.1238, 0.051, 0.1064, 0.0535, 0.1137, 0.1129, 0.0575, 0.0657, 0.0872 ], "l1r.l2m.l3mdcp": [ 0.09, 0.1122, 0.0465, 0.0589, 0.1555, 0.0306, 0.0675, 0.1555, 0.1038, 0.1434, 0.0076, 0.0285 ], "l1r.l2m.l3mdp": [ 0.0693, 0.1304, 0.039, 0.0885, 0.0962, 0.0395, 0.0439, 0.2146, 0.1423, 0.1001, 0.0061, 0.0302 ], "l1r.l2m.l3rpp": [ 0.0643, 0.0991, 0.0647, 0.1207, 0.0582, 0.0955, 0.0478, 0.1312, 0.1177, 0.0635, 0.0568, 0.0805 ], "l1r.l2w.l3ewp": [ 0.0833, 0.0833, 0.0833, 0.0833, 0.0833, 0.0833, 0.0833, 0.0833, 0.0833, 0.0833, 0.0833, 0.0833 ], "l1r.l2w.l3gmvp": [ 0.0296, 0.0903, 0, 0.1234, 6.3851e-19, 0.2461, 2.4041e-18, 0.2566, 0.1437, 0.0329, 1.1139e-18, 0.0773 ], "l1r.l2w.l3hrp": [ 0.0319, 0.1358, 0.0487, 0.1247, 0.0282, 0.1793, 0.0204, 0.1916, 0.1141, 0.0361, 0.035, 0.054 ], "l1r.l2w.l3ivp": [ 0.0587, 0.0979, 0.0639, 0.1262, 0.0472, 0.1242, 0.0537, 0.1105, 0.1207, 0.0505, 0.0703, 0.0764 ], "l1r.l2w.l3mdcp": [ 0.0764, 0.1166, 0.0315, 8.5945e-20, 0.0968, 0.0812, 0.0757, 0.2215, 0.068, 0.1631, 0, 0.0691 ], "l1r.l2w.l3mdp": [ 0.0542, 0.1378, 0.0243, 1.0183e-19, 0.0552, 0.1217, 0.0491, 0.2955, 0.0991, 0.0993, 1.922e-17, 0.0637 ], "l1r.l2w.l3rpp": [ 0.0566, 0.1035, 0.0564, 0.113, 0.0488, 0.1165, 0.0489, 0.1522, 0.1201, 0.0569, 0.0577, 0.0693 ]}
#
What's next?Now that we have generated some weights we can go to the model section to understand how to make the best of the API response: what is l1r.l2d.l3ewp
, l1r.l2w.l3rpp
and how was it computed.
If a deeper dive is needed, the optimisation section is where you want to go.
If you wonder what are the use cases the PathLit engine can help with, please visit the use cases page.