Bloomberg DL onboarding

Learn how to onboard to Bloomberg services provided through Kaiko

Overview

The Kaiko oracle retrieves Bloomberg data on your behalf. To do this, Kaiko authenticates against the Bloomberg Data License (DL) REST API using your own Bloomberg credentials. Kaiko acts as a pass-through: it submits requests to Bloomberg under your entitlements, using the credentials you provide.

These credentials are a pair, a client_id and a client_secret. You generate them from the Bloomberg developer portal and pass them to Kaiko inside the Canton Request.

A note on privacy: thanks to the Canton privacy model, the credentials you submit in a Request are only visible to the parties to that contract (you and Kaiko). They are never written to a shared or public ledger, and are not exposed to other network participants.

What you need to do

Two one-time steps on the Bloomberg side before your first request.

Generate and download your credential file

Your Bloomberg DL credentials are issued as a JSON payload contained in a .txt file; they are downloaded from the Bloomberg portal. The file contains the client_id and client_secret that Kaiko needs.

Follow Bloomberg's official guide to create and download the file: Bloomberg DL REST API quickstart, credentials

Whitelist the Kaiko IP address

Bloomberg restricts API access to approved source IPs. You should add the Kaiko egress IP to your allowed list so that requests submitted by Kaiko under your credentials are accepted:

34.124.120.234

Making requests

Once both steps above are done, pass your client_id and client_secret to Kaiko through the Canton Request. Kaiko uses them to authenticate to Bloomberg and return the requested data. You are then good to go.