Summary

  1. List Endpoints: The list endpoints return the assets list for funds, etc, crypto, add and stock data.
  2. Aggregated Search: The search result is grouped by security name.
  3. Enhanced Searcher: Support over 100.000 securities.
  4. Performance improvements The average response time of the API is <400ms.

New Endpoints
1. Bulk Endpoint: Return the Quote, Candle and ETF data bulked
2. Dividend Calendar: Return upcoming dividends for stocks and etfs.
3. Annual dividends: Annualise dividend to make them easier comparable
4. ETF and Stock dividend estimates: Return dividend estimates.
5. Financial TTM: Return financial TTM results

New Endpoints

Bulk

Endpoint: Bulk


Description: This endpoint returns bulked financial data.

curl --request POST \
     --url https://api.bavest.co/v0/bulk \
     --header 'accept: text/plain' \
     --header 'content-type: application/json' \
     --header 'x-api-key: api-key' \
     --data '
{
  "symbols": [
    {
      "symbol": "IWDA.L"
    }
  ],
  "endpoint": "etf_profile",
  "params": {
    "resolution": "D",
    "symbol": "ARKK"
  }
}
'

Parameters:

  • symbols: The security symbols
  • endpoint: The endpoint name
  • params: Addionall parameters for the endpoint

Search aggregated

Endpoint: Search aggregated


Description: This endpoint returns aggregated search results.

curl --request POST \
     --url https://api.bavest.co/v0/search/aggregated \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: api-key' \
     --data '{"query":"AAPL"}'

Parameters:

  • query: The search query

Dividend Calendar

Endpoint: Dividend Calendar


Description: The dividend calendar return announced dividends.

curl --request POST \
     --url https://api.bavest.co/v0/calendar/dividends \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: api-key'

Financials TTM

Endpoint: Financials TTM


Description: This endpoint returns financial TTM results.

curl --request POST \
     --url https://api.bavest.co/v0/stock/financials/ttm \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: api-key' \
     --data '{"symbol":"AAPL"}'

Parameters:

  • symbol: The security symbol

Financials TTM

Endpoint: Dividend Estimate


Description: This endpoint returns dividend estimates

curl --request POST \
     --url https://api.bavest.co/v0/etf/dividend-estimate \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: api-key' \
     --data '{"symbol":"HDLV.DE"}'

Parameters:

  • symbol: The symbol of the security.

Financials TTM

Endpoint: Annual Dividends


Description: The endpoint provides annual dividends for stocks, ETFs, and mutual funds.

curl --request POST \
     --url https://api.bavest.co/v0/dividends/annual \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --header 'x-api-key: api-key' \
     --data '{"symbol":"AAPL"}'

Parameters:

  • symbol: The symbol of the security.

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").