Integration API - a brief description.

While standard visual charts are accessible through the web platform, data can also be machine-accessed, facilitating integration into analytical tools or algorithmic workflows. The system supports data exchange through REST API architecture with short-lived token rotation logic.

Authentication

Short data API access requires authentication first. Retrieve your account and pick YOUR_ACCESS_TOKEN in the response:


curl --request POST \
  --url {BASE_HTTPS_URL}/userapigateway/pnc/signin \
  --header 'Content-Type: application/json' \
  --data '{
    "username": "YourUsername",
    "password": "YourPassword"
  }'

 

If the provided credentials are ok, HTTP status code 200 OK is returned and the response looks like this:


       YOUR_ACCESS_TOKEN

 
 

else HTTP error code 401 UNAUTHORIZED is raised and, as response, an error message is returned, like this:



       Invalid username or password	

GET Endpoints

Once authenticated, you can call the following Endpoints and ask for Short Data. Use the generated Access Token to poll the dataset.

cumulative short position registered for a given Stock on specific Day

curl --request GET \
  --url {BASE_HTTPS_URL}/userapigateway/pnc/findIT/STOCK_NAME/DAY	 \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'
 

The response looks like this:

{
  "pnc": 
    {
      "name": "STOCK_NAME",
      "dateRef": "ISO_DATE"
    },
    "isin": "ISIN",
    "numPositions": NUM_POS,
    "totValue": TOTAL_VALUE,
    "datePnc": "ISO_DATE"
}
 

Italy stocks market, active cumulative short positions increased/decreased respect last samples

curl --request GET \
  --url {BASE_HTTPS_URL}/userapigateway/pnc/findLastDeltaIT 	 \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'
 

for every Italian stock under coverage, only cumulative short positions increased/decreased respect last samples are returned.

Germany stocks market, active cumulative short positions increased/decreased respect last samples

curl --request GET \
  --url {BASE_HTTPS_URL}/userapigateway/pnc/findLastDeltaDE 	 \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'
 

for every German stock under coverage, only cumulative short positions increased/decreased respect last samples are returned.

France stocks market, active cumulative short positions increased/decreased respect last samples

curl --request GET \
  --url {BASE_HTTPS_URL}/userapigateway/pnc/findLastDeltaFR 	 \
  --header 'Authorization: Bearer YOUR_ACCESS_TOKEN'
 

for every French stock under coverage, only cumulative short positions increased/decreased respect last samples are returned.

 

The response looks like this:

{
  "accounts": [
    {
      "accountId": "YOUR_ACCOUNT_ID",
      "accountType": "BROKERAGE",
      "name": "STOCK_NAME",
      "isin": "ISIN",
      "dateRef": "ISO_DATE",
      "numPositions": NUM_POS
      "totValue": VALUE
      "datePnc": "ISO_DATE"
    }
  ]
}
 

For all three of these endpoints, the response looks like this:

{
  "deltas": [
    {
      "name": "STOCK_NAME",
      "dateRef": "ISO_DATE",
      "isin": "ISIN",
      "deltaValue": DELTA
    },
    {
      "name": "STOCK_NAME",
      "dateRef": "ISO_DATE",
      "isin": "ISIN",
      "deltaValue": DELTA
    }
  ]
}

Subscription prices

For BASE_HTTPS_URL, terms of service, usage policies, prices (monthly or yearly plans) and payment methods write to info@shortsellingmi.it API tutorial and specific documentation will be provided after subscription.