API Release Notes July 25/24

Summary

1. Search Endpoint: The search endpoint now supports funds, crypto, and forex data.
2. Consistent API Response Codes: The API response codes are now consistent across all endpoints:
   • 200: Success
   • 401: Unauthorised
   • 403: Forbidden
   • 404: Not Found
   • 500: Internal Server Error

• New Endpoints
  • Crypto Price: Returns price data for cryptocurrencies.
  • ETF Fundamental: Returns fundamental data for Exchange Traded Funds (ETFs).
  • ETF Metrics: Returns performance metrics for Exchange Traded Funds (ETFs).
  • Fund Profile: Returns the profile information for a specified fund.
  • Fund Sector: Returns the fund sector list.
  • Fund Allocation Exposure: Returns the exposure for a specified fund.
  • Fund Country: Returns the country list for the specified fund.
  • Fund Holding: Returns the holdings list for a specified fund.
• Deprecated Announcements
  • Version 0 Maintenance:
    • Version 0 (v0) will be maintained until 31.12.2024. After this date, it will be required to switch to Version 1 (v1).
    • V1 is released in October 2024 and contains only small changes with the goal of improving the developer experience.
  • Changes in (Version 1)
    • Indices Constituents:
      • The indices constituents endpoint is removed as of 01.05.2024.
    • ETF Holdings:
      • The field "cusip" will be removed starting from Version 1 (v1) and greater, effective 01.07.2024.
    • Stock Candle:
      • The endpoint will be removed as of 31.12.2024. Please use the /candle endpoint instead.

 

New Endpoints

Crypto Price

Endpoint: Crypto Price


Description: This endpoint provides a price quote for a specified cryptocurrency. Over 1000 cryptocurrency symbols are supported.

curl --request POST  
     --url <https://api.bavest.co/v0/crypto/price>  
     --header 'accept: application/json'  
     --header 'content-type: application/json'  
     --header 'x-api-key: api-key'  
      --data '{  
       "symbol": "BTCUSD"  
     }'  

Parameters:

• symbol: The crypto symbol (e.g. BTCUSD)


ETF Metrics

Endpoint: https://docs.bavest.co/reference/post-etf-metrics


Description: This endpoint returns performance metrics for Exchange Traded Funds (ETFs).



curl --request POST  
     --url <https://api.bavest.co/v0/etf/metrics>  
     --header 'accept: application/json'  
     --header 'content-type: application/json'  
     --header 'x-api-key: api-key'  
     --data '{  "from": 1361290149,  "to": 1676588400,  "resolution": "D",  "currency": "EUR",  "symbol": "IWDA.L"}' 

Parameters:

• from: Start timestamp (Unix epoch).
• to: End timestamp (Unix epoch).
• resolution: Data resolution (e.g., "D" for daily).
• currency: Currency code (e.g., "EUR").
• symbol: ETF symbol (e.g., "IWDA.L").


ETF Fundamentals

Endpoint: https://docs.bavest.co/reference/etf-fundamentals


Description: This endpoint provides fundamental data for specified ETFs.

Sample Request:

curl --request POST  
     --url <https://api.bavest.co/v0/etf/fundamentals>  
     --header 'accept: application/json'  
     --header 'content-type: application/json'  
     --header 'x-api-key  

Fund Allocation Exposure

Endpoint: https://docs.bavest.co/reference/post-fund-allocation-exposure


Description: The fund allocation exposure endpoint returns the exposure for a specified fund.



curl --request POST  
     --url <https://api.bavest.co/v0/fund/allocation-exposure>  
     --header 'accept: application/json'  
     --header 'content-type: application/json'  
     --header 'x-api-key: api-key'  
     --data '{  
       "isin": "DE000ETFL573"  
     }'  

Parameters:

• isin: International Securities Identification Number (ISIN) of the fund (e.g., "DE000ETFL573").

Fund Country

Endpoint: https://docs.bavest.co/reference/post-fund-country

Description: The fund country endpoint returns the country list for the specified fund.



curl --request POST  
     --url <https://api.bavest.co/v0/fund/country>  
     --header 'accept: application/json'  
     --header 'content-type: application/json'  
     --header 'x-api-key: api-key'  
     --data '{  
       "isin": "DE000ETFL573"  
     }'  

Parameters:

• isin: International Securities Identification Number (ISIN) of the fund (e.g., "DE000ETFL573").

 

Fund Holding

Endpoint: https://docs.bavest.co/reference/post-fund-holding


Description: The fund holding endpoint returns the holdings list for a specified fund.

curl --request POST
     --url <https://api.bavest.co/v0/fund/holding>
     --header 'accept: application/json'
     --header 'content-type: application/json'
     --header 'x-api-key: api-key'
     --data '{
       "isin": "DE000ETFL573"

     }'

Parameters:

• isin: International Securities Identification Number (ISIN) of the fund (e.g., "DE000ETFL573").

Fund Profile

Endpoint: https://docs.bavest.co/reference/post-fund-profile


Description: The fund holding endpoint returns the holdings list for a specified fund.


curl --request POST  
     --url <https://api.bavest.co/v0/fund/profile>  
     --header 'accept: application/json'  
     --header 'content-type: application/json'  
     --header 'x-api-key: api-key'  
     --data '{  
       "isin": "DE000ETFL573"  
     }'  

Parameters:

• isin: International Securities Identification Number (ISIN) of the fund (e.g., "DE000ETFL573").

 

Fund Sector

Endpoint: https://docs.bavest.co/reference/post-fund-sector


Description: The fund sector endpoint returns the fund sector list.

curl --request POST  
     --url <https://api.bavest.co/v0/fund/sector>  
     --header 'accept: application/json'  
     --header 'content-type: application/json'  
     --header 'x-api-key: api-key'  
     --data '{  
       "isin": "DE000ETFL573"  
     }'  

Parameters:

• isin: International Securities Identification Number (ISIN) of the fund (e.g., "DE000ETFL573").