Getting started

The STOMARKET API provides programmatic access to real time security token pricing.

To use this API, you need a API Account. Please contact us at api@stomarket.com to get your access key.

Get Auth Token

Method: POST
End Point: https://api.stomarket.com/api/login

QUERY PARAMETERS

Field	Type	Description
email	String	Email used to request an access account
password	String	Authorization key Givin by STM

Example API account access:

Email: testapi@stomarket.com
Password: TMGCMBN_P_8GUNSS4I8TBC7ZC3VBE5M4PBP

      
        curl --location --request POST 'https://api.stomarket.com/api/login' \
        --form 'email="testapi@stomarket.com"' \
        --form 'password="TMGCMBN_P_8GUNSS4I8TBC7ZC3VBE5M4PBP"'
      
    

Example Response (JSON):

      
        {
          "success": true,
          "total": 1,
          "data": {
            "token": "8|Y0e2pYgTD0pWfKcoa2YGFOwkdTqlpHxZVWa3sVnZ"
          },
          "message": "You may now use this token to make data requests."
        }
      
    

get token data

Security Tokens

To get characters you need to make a GET call to the following url :
https://api.stomarket.com/api/getTokens

Example Request

      
        curl --location --request GET 'https://api.stomarket.com/api/getTokens' \
        --header 'Authorization: Bearer 8|Y0e2pYgTD0pWfKcoa2YGFOwkdTqlpHxZVWa3sVnZ'
      
    

Tokenized Stock Tokens

To get characters you need to make a GET call to the following url :
https://api.stomarket.com/api/getDerivatives

Example Request

      
        curl --location --request GET 'https://api.stomarket.com/api/getDerivatives' \
        --header 'Authorization: Bearer 8|Y0e2pYgTD0pWfKcoa2YGFOwkdTqlpHxZVWa3sVnZ'
      
    

Example Response (JSON):

      
        {
          "success": true,
          "total": 1,
          "data": {
            "TOKEN-NAME": {
              "exchange": "Exchange Name",
              "symbol": "STMTK",
              "price": 381,
              "marketcap": 467040486,
              "24H_volume_usd": 4688,
              "24H_change_percent": 22
            }
          },
          "message": "Query time 2022-06-01 15:51:29"
        }
      
    

get Marketcap & Volume data

To get characters you need to make a POST call to the following url :
https://api.stomarket.com/api/marketStats

QUERY PARAMETERS

Field	Type	Description
from	String	YYYY-MM-DD (2025-05-14)
to	String	YYYY-MM-DD (2025-05-14)

Restrictions:

Query is limited to 1 month intervals maximum.

Example Request

      
        curl --location --request POST 'https://api.stomarket.com/api/marketStats' \
        --header 'Authorization: Bearer 8|Y0e2pYgTD0pWfKcoa2YGFOwkdTqlpHxZVWa3sVnZ' \
        --form 'from="2022-07-15"' \
        --form 'to="2022-07-15"'
      
    

Example Response (JSON):

      
        {
            "success": true,
            "total": 2,
            "data": {
                "2022-07-14": {
                    "security_token_market_cap": 15691548432.9,
                    "security_token_volume": 174007.83,
                    "tokenized_stock_volume": 2067697.79
                },
                "total": {
                    "security_token_volume": 289598.17,
                    "tokenized_stock_volume": 2067697.79
                }
            },
            "message": "Query time 2022-07-15 10:00:18"
        }
      
    

Errors

The Westeros API uses the following error codes:

      
        {
          "success": false,
          "message": "Unauthorised.",
          "data": {
            "error": "Unauthorised"
          }
        }