> For the complete documentation index, see [llms.txt](https://docs.kaiko.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kaiko.com/on-chain/third-party-data/bloomberg/bloomberg-dl-onboarding.md).
# Bloomberg DL onboarding
## 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](https://developer.bloomberg.com/portal/quickstarts/dl_rest_qs?chapterId=3099\&entityType=document-v2)
### 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:
{% hint style="info" %}
34.124.120.234
{% endhint %}
## 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.
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://docs.kaiko.com/on-chain/third-party-data/bloomberg/bloomberg-dl-onboarding.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.