# Table of Contents - [Our B2B Products - Bubblemaps B2B](#our-b2b-products-bubblemaps-b2b) - [Authentication - Bubblemaps B2B](#authentication-bubblemaps-b2b) - [Introduction - Bubblemaps B2B](#introduction-bubblemaps-b2b) - [Introduction - Bubblemaps B2B](#introduction-bubblemaps-b2b) - [Get Map Data - Bubblemaps B2B](#get-map-data-bubblemaps-b2b) - [Interactive Demo - Bubblemaps B2B](#interactive-demo-bubblemaps-b2b) - [Pricing - Bubblemaps B2B](#pricing-bubblemaps-b2b) - [Get Supported Chains - Bubblemaps B2B](#get-supported-chains-bubblemaps-b2b) - [Quickstart - Bubblemaps B2B](#quickstart-bubblemaps-b2b) --- # Our B2B Products - Bubblemaps B2B [Skip to main content](https://docs.bubblemaps.io/introduction#content-area) [Bubblemaps B2B home page![light logo](https://mintcdn.com/bubblemaps/6oAdGEcDpUeibzqr/logo/light.svg?fit=max&auto=format&n=6oAdGEcDpUeibzqr&q=85&s=657ad5a4e2748d477ab46010534b9c9e)![dark logo](https://mintcdn.com/bubblemaps/6oAdGEcDpUeibzqr/logo/dark.svg?fit=max&auto=format&n=6oAdGEcDpUeibzqr&q=85&s=6154bdea0f45644a31c71a687f45abc8)](https://docs.bubblemaps.io/) Search... ⌘K Search... Navigation Get Started Our B2B Products On this page * [Two Separate Products](https://docs.bubblemaps.io/introduction#two-separate-products) * [Which one should you choose?](https://docs.bubblemaps.io/introduction#which-one-should-you-choose) [​](https://docs.bubblemaps.io/introduction#two-separate-products) Two Separate Products ------------------------------------------------------------------------------------------- Before getting heads down in the docs, you should take the time to ascertain which of our two products you want to work with. * **iFrame Integration**: Ready-to-use Bubblemaps. Our main product, what most of our clients use. A very easy one-liner integration to feature our visuals into your platform, like an autonomous widget. Battle-tested by the industry most famous names (CoinGecko, DexScreener, etc). * **Data API** _\[Beta\]_: Get technical. Directly access our data and present it the way you want within your service. Holders, transfers, clusters, exposed through a REST API. [iFrame Integration\ ------------------](https://docs.bubblemaps.io/iframe) [Data API\ --------](https://docs.bubblemaps.io/data/api) [​](https://docs.bubblemaps.io/introduction#which-one-should-you-choose) Which one should you choose? -------------------------------------------------------------------------------------------------------- If you’re still unsure what product is the best for you, here’s some help: * You are a crypto platform for monitoring tokens, like a chart app, or a telegram monitoring bot, and you want to quickly add some visual value to your app: **Go with the iFrame**. * You are a launchpad, and want to provide an easy visual tool to help your users navigate tokens launched though your platform: **Go with the iFrame**. * You are a token company, and want to demonstrate transparency, validate your tokenomics against your actual supply distribution: **Go with the iFrame** and integrate your own map to your website. * You are a crypto analytics company, like a DeFi analytics app, or a telegram trading bot, and you want to fetch, process, and integrate our data into your codebase and pipelines: **Go with the API**. Whether you are a token company, a Dex, or another DeFi entity, you might also be interested in custom labelling on Bubblemaps. We discuss these on a case by case basis, don’t hesitate to [reach out](https://docs.bubblemaps.io/cdn-cgi/l/email-protection#b3d0dcddc7d2d0c7f3d1c6d1d1dfd6ded2c3c09ddadc) . You might be interested in both products! We can definitely negociate custom deals for companies with extensive needs. [Reach out](https://docs.bubblemaps.io/cdn-cgi/l/email-protection#d7b4b8b9a3b6b4a397b5a2b5b5bbb2bab6a7a4f9beb8) . [Introduction](https://docs.bubblemaps.io/iframe/introduction) ⌘I --- # Authentication - Bubblemaps B2B [Skip to main content](https://docs.bubblemaps.io/data/api/authentication#content-area) [Bubblemaps B2B home page![light logo](https://mintcdn.com/bubblemaps/6oAdGEcDpUeibzqr/logo/light.svg?fit=max&auto=format&n=6oAdGEcDpUeibzqr&q=85&s=657ad5a4e2748d477ab46010534b9c9e)![dark logo](https://mintcdn.com/bubblemaps/6oAdGEcDpUeibzqr/logo/dark.svg?fit=max&auto=format&n=6oAdGEcDpUeibzqr&q=85&s=6154bdea0f45644a31c71a687f45abc8)](https://docs.bubblemaps.io/) Search... ⌘K Search... Navigation Data API \[Beta\] Authentication On this page * [Get Your Key](https://docs.bubblemaps.io/data/api/authentication#get-your-key) * [Rate Limiting](https://docs.bubblemaps.io/data/api/authentication#rate-limiting) * [Using Your Key](https://docs.bubblemaps.io/data/api/authentication#using-your-key) [​](https://docs.bubblemaps.io/data/api/authentication#get-your-key) Get Your Key ------------------------------------------------------------------------------------ To access this API, you’ll need an API key. [Reach out](https://docs.bubblemaps.io/cdn-cgi/l/email-protection#ec8d9c85ac8e998e8e8089818d9c9fc28583) to ask for one. This API is still in beta, we only give API keys to hand-picked partners. [​](https://docs.bubblemaps.io/data/api/authentication#rate-limiting) Rate Limiting -------------------------------------------------------------------------------------- For now, we apply a daily query-seconds limit, negociated on a case by case basis. This means that when you make a query, we time how long it takes to compute, and store that information. If you go over your allowed query-seconds for the day, you’ll start getting `429` errors. Cache is shared with other API consumers, **including the app and iFrame integrations**. Which means that if you query highly demanded maps, you’ll most likely hit cache, minimizing query-seconds usage. The daily limit resets at midnight UTC [​](https://docs.bubblemaps.io/data/api/authentication#using-your-key) Using Your Key ---------------------------------------------------------------------------------------- Pass your key in the `X-ApiKey` header of your requests. Try this out in the [interactive endpoints documentation](https://docs.bubblemaps.io/data/api/endpoints/get-supported-chains) . [Introduction](https://docs.bubblemaps.io/data/api/introduction) [Get Supported Chains](https://docs.bubblemaps.io/data/api/endpoints/get-supported-chains) ⌘I --- # Introduction - Bubblemaps B2B [Skip to main content](https://docs.bubblemaps.io/data/api/introduction#content-area) [Bubblemaps B2B home page![light logo](https://mintcdn.com/bubblemaps/6oAdGEcDpUeibzqr/logo/light.svg?fit=max&auto=format&n=6oAdGEcDpUeibzqr&q=85&s=657ad5a4e2748d477ab46010534b9c9e)![dark logo](https://mintcdn.com/bubblemaps/6oAdGEcDpUeibzqr/logo/dark.svg?fit=max&auto=format&n=6oAdGEcDpUeibzqr&q=85&s=6154bdea0f45644a31c71a687f45abc8)](https://docs.bubblemaps.io/) Search... ⌘K Search... Navigation Data API \[Beta\] Introduction On this page * [What is this?](https://docs.bubblemaps.io/data/api/introduction#what-is-this) [​](https://docs.bubblemaps.io/data/api/introduction#what-is-this) What is this? ----------------------------------------------------------------------------------- We’ve been getting a lot of inquiries from our iFrame partners and other tech teams to expose our data in an API. That’s why we’re now exploring this option! Keep in mind this is still an early version, that we will build over progressively. Before reading more, make sure you are interested in the Data API, and not the iFrame Integration, which is a different thing entirely. In case of doubt, refer back to the differences [here](https://docs.bubblemaps.io/introduction) . This API is in beta and does not come with any guarantees or SLA of any kind yet. Schemas and endpoints may change without notice. Please use with caution! [Pricing](https://docs.bubblemaps.io/iframe/pricing) [Authentication](https://docs.bubblemaps.io/data/api/authentication) ⌘I --- # Introduction - Bubblemaps B2B [Skip to main content](https://docs.bubblemaps.io/iframe/introduction#content-area) [Bubblemaps B2B home page![light logo](https://mintcdn.com/bubblemaps/6oAdGEcDpUeibzqr/logo/light.svg?fit=max&auto=format&n=6oAdGEcDpUeibzqr&q=85&s=657ad5a4e2748d477ab46010534b9c9e)![dark logo](https://mintcdn.com/bubblemaps/6oAdGEcDpUeibzqr/logo/dark.svg?fit=max&auto=format&n=6oAdGEcDpUeibzqr&q=85&s=6154bdea0f45644a31c71a687f45abc8)](https://docs.bubblemaps.io/) Search... ⌘K Search... Navigation iFrame Integration Introduction On this page * [What is this?](https://docs.bubblemaps.io/iframe/introduction#what-is-this) [​](https://docs.bubblemaps.io/iframe/introduction#what-is-this) What is this? --------------------------------------------------------------------------------- Ready-to-use Bubblemaps. A very easy one-liner integration to feature our visuals into your platform, like an autonomous widget. Our iFrames have been battle-tested by the industry most famous names like CoinGecko and DexScreener. In today’s climate of scammy meme-coins, centralized DAOs, celebrities launching rigged tokens with bundled supply, and the ever-growing complexity of blockchain data, you **need** Bubblemaps to navigate the DeFi. Stand out from your competitors: Provide transparency, safety, and easy, visual value to your users with Bubblemaps iFrames. [Interactive Demo\ ----------------](https://docs.bubblemaps.io/iframe/demo) [Quickstart\ ----------](https://docs.bubblemaps.io/iframe/quickstart) Whether you are a token company, a Dex, or another DeFi entity, you might also be interested in custom labelling on Bubblemaps. We discuss these on a case by case basis, don’t hesitate to [reach out](https://docs.bubblemaps.io/cdn-cgi/l/email-protection#aac9c5c4decbc9deeac8dfc8c8c6cfc7cbdad984c3c5) . [Our B2B Products](https://docs.bubblemaps.io/introduction) [Interactive Demo](https://docs.bubblemaps.io/iframe/demo) ⌘I --- # Get Map Data - Bubblemaps B2B [Skip to main content](https://docs.bubblemaps.io/data/api/endpoints/get-map-data#content-area) [Bubblemaps B2B home page![light logo](https://mintcdn.com/bubblemaps/6oAdGEcDpUeibzqr/logo/light.svg?fit=max&auto=format&n=6oAdGEcDpUeibzqr&q=85&s=657ad5a4e2748d477ab46010534b9c9e)![dark logo](https://mintcdn.com/bubblemaps/6oAdGEcDpUeibzqr/logo/dark.svg?fit=max&auto=format&n=6oAdGEcDpUeibzqr&q=85&s=6154bdea0f45644a31c71a687f45abc8)](https://docs.bubblemaps.io/) Search... ⌘K Search... Navigation Data API \[Beta\] Get Map Data Get Map Data cURL Copy curl --request GET \ --url https://api.bubblemaps.io/maps/{chain}/{token_address} \ --header 'X-ApiKey: ' 200 422 Copy { "metadata": { "dt_update": "", "ts_update": 123, "identified_supply": { "share_in_cexs": 123, "share_in_dexs": 123, "share_in_other_contracts": 123 } }, "nodes": { "top_holders": [\ {\ "address": "",\ "address_details": {\ "degree": 123,\ "is_supernode": true,\ "is_contract": true,\ "is_cex": true,\ "is_dex": true,\ "inward_relations": 123,\ "outward_relations": 123,\ "label": "",\ "entity_id": "",\ "first_activity_date": "2023-11-07T05:31:56Z"\ },\ "holder_data": {\ "amount": 123,\ "rank": 123,\ "share": 123\ },\ "is_shown_on_map": true\ }\ ], "magic_nodes": [\ {\ "address": "",\ "address_details": {\ "degree": 123,\ "is_supernode": true,\ "is_contract": true,\ "is_cex": true,\ "is_dex": true,\ "inward_relations": 123,\ "outward_relations": 123,\ "label": "",\ "entity_id": "",\ "first_activity_date": "2023-11-07T05:31:56Z"\ },\ "is_shown_on_map": true\ }\ ] }, "relationships": [\ {\ "from_address": "",\ "to_address": "",\ "data": {\ "total_value": 123,\ "total_transfers": 123,\ "first_date": 123,\ "last_date": 123,\ "token_ref": {\ "chain": "eth",\ "address": ""\ }\ },\ "rel_type": "GROUPED_TRANSFER"\ }\ ], "decentralization_score": 123, "clusters": [\ {\ "share": 123,\ "amount": 123,\ "holder_count": 123,\ "holders": [\ ""\ ]\ }\ ] } GET / maps / {chain} / {token\_address} Try it Get Map Data cURL Copy curl --request GET \ --url https://api.bubblemaps.io/maps/{chain}/{token_address} \ --header 'X-ApiKey: ' 200 422 Copy { "metadata": { "dt_update": "", "ts_update": 123, "identified_supply": { "share_in_cexs": 123, "share_in_dexs": 123, "share_in_other_contracts": 123 } }, "nodes": { "top_holders": [\ {\ "address": "",\ "address_details": {\ "degree": 123,\ "is_supernode": true,\ "is_contract": true,\ "is_cex": true,\ "is_dex": true,\ "inward_relations": 123,\ "outward_relations": 123,\ "label": "",\ "entity_id": "",\ "first_activity_date": "2023-11-07T05:31:56Z"\ },\ "holder_data": {\ "amount": 123,\ "rank": 123,\ "share": 123\ },\ "is_shown_on_map": true\ }\ ], "magic_nodes": [\ {\ "address": "",\ "address_details": {\ "degree": 123,\ "is_supernode": true,\ "is_contract": true,\ "is_cex": true,\ "is_dex": true,\ "inward_relations": 123,\ "outward_relations": 123,\ "label": "",\ "entity_id": "",\ "first_activity_date": "2023-11-07T05:31:56Z"\ },\ "is_shown_on_map": true\ }\ ] }, "relationships": [\ {\ "from_address": "",\ "to_address": "",\ "data": {\ "total_value": 123,\ "total_transfers": 123,\ "first_date": 123,\ "last_date": 123,\ "token_ref": {\ "chain": "eth",\ "address": ""\ }\ },\ "rel_type": "GROUPED_TRANSFER"\ }\ ], "decentralization_score": 123, "clusters": [\ {\ "share": 123,\ "amount": 123,\ "holder_count": 123,\ "holders": [\ ""\ ]\ }\ ] } This is where you get all the interesting map data. You just have to provide: * The token chain and address, through path parameters (see [Get Supported Chains](https://docs.bubblemaps.io/data/api/endpoints/get-supported-chains) ). * Whether you want to use magic nodes or not, through the `use_magic_nodes` query parameter. If you do, magic nodes will be fetched and considered in the relationships, score, and clusters computation. * What data you want to be returned in your response, through the `return_*` query parameters described below. To ensure lightweight responses, only return the data you actually use! All tokens are supported by default, including NFT collections, but beware of errors: a `404` will be returned if no holders are found, and a `400` might be returned for some rare unsupported tokens. ### [​](https://docs.bubblemaps.io/data/api/endpoints/get-map-data#query-duration) Query Duration Query duration ranges from a few `ms` for cache hits, up to a minute for outliers. Most queries should not take more than `15s` though. Using magic nodes will increase the duration of the query. ### [​](https://docs.bubblemaps.io/data/api/endpoints/get-map-data#response-format) Response Format See the expected schema at the end of this page, but here’s some additional context: * The base nodes list is the top 80 holders of the token. This is aligned with the iFrame integrations. This number might change in the future. * All share values are in `[0, 1]` format, meaning `42%` will be returned as `0.42`. * In the nodes lists, you’ll find a `is_shown_on_map` boolean. It is based on the default visibility state on our main app, meaning that CEXs, DEXs, Contracts, and hypernodes (more than 200k transfers) are hidden. These nodes are not considered in the relationships, score, and clusters computation. * The `is_supernode` boolean means that the node has a high volume of transfers (threshold may vary). Relationships between two supernodes are ignored (relationships between a supernode and a non-supernode are included though). * In the `relationships` list, transfers are grouped based on the `(from_address, to_address, token_ref)` key. Meaning that if `A` sends some `BMT` to `B` multiple times, these transfers will be grouped as a unique relationship object. * In some instances, the `decentralization_score` can be null even if you asked for it. (This means the score is not applicable on that map) Returning nodes and relationships on dense maps might crash the API playground web interface. In these cases, don’t hesitate to try out calls directly via curl or your favorite language. If you are using the relationships data, beware of the `token_ref.chain` (ContractTokenRef) and `token_ref.id` (NativeTokenRef) types. They are Enums, but additional chains and native tokens **will** be supported in the future, without notice. Make sure that it won’t break your typing. [Magic Nodes\ -----------](https://x.com/bubblemaps/status/1858578503509086366) [Decentralization Score\ ----------------------](https://bubblemaps.notion.site/Bubblemaps-Decentralization-Factor-ba767100c9534945ae390fd2467e4add) #### Authorizations [​](https://docs.bubblemaps.io/data/api/endpoints/get-map-data#authorization-x-api-key) X-ApiKey string header required #### Path Parameters [​](https://docs.bubblemaps.io/data/api/endpoints/get-map-data#parameter-chain) chain enum required Available options: `eth`, `base`, `solana`, `tron`, `bsc`, `apechain`, `ton`, `polygon`, `avalanche`, `sonic`, `monad` [​](https://docs.bubblemaps.io/data/api/endpoints/get-map-data#parameter-token-address) token\_address string required #### Query Parameters [​](https://docs.bubblemaps.io/data/api/endpoints/get-map-data#parameter-use-magic-nodes) use\_magic\_nodes boolean default:true [​](https://docs.bubblemaps.io/data/api/endpoints/get-map-data#parameter-return-nodes) return\_nodes boolean default:false [​](https://docs.bubblemaps.io/data/api/endpoints/get-map-data#parameter-return-relationships) return\_relationships boolean default:false [​](https://docs.bubblemaps.io/data/api/endpoints/get-map-data#parameter-return-clusters) return\_clusters boolean default:true [​](https://docs.bubblemaps.io/data/api/endpoints/get-map-data#parameter-return-decentralization-score) return\_decentralization\_score boolean default:true #### Response 200 application/json Successful Response [​](https://docs.bubblemaps.io/data/api/endpoints/get-map-data#response-metadata) metadata MapMetadata · object required Show child attributes [​](https://docs.bubblemaps.io/data/api/endpoints/get-map-data#response-nodes-one-of-0) nodes NodesData · object Show child attributes [​](https://docs.bubblemaps.io/data/api/endpoints/get-map-data#response-relationships-one-of-0) relationships GroupedTransfer · object\[\] | null Show child attributes [​](https://docs.bubblemaps.io/data/api/endpoints/get-map-data#response-decentralization-score-one-of-0) decentralization\_score number | null [​](https://docs.bubblemaps.io/data/api/endpoints/get-map-data#response-clusters-one-of-0) clusters ClusterData · object\[\] | null Show child attributes [Get Supported Chains](https://docs.bubblemaps.io/data/api/endpoints/get-supported-chains) ⌘I --- # Interactive Demo - Bubblemaps B2B [Skip to main content](https://docs.bubblemaps.io/iframe/demo#content-area) [Bubblemaps B2B home page![light logo](https://mintcdn.com/bubblemaps/6oAdGEcDpUeibzqr/logo/light.svg?fit=max&auto=format&n=6oAdGEcDpUeibzqr&q=85&s=657ad5a4e2748d477ab46010534b9c9e)![dark logo](https://mintcdn.com/bubblemaps/6oAdGEcDpUeibzqr/logo/dark.svg?fit=max&auto=format&n=6oAdGEcDpUeibzqr&q=85&s=6154bdea0f45644a31c71a687f45abc8)](https://docs.bubblemaps.io/) Search... ⌘K Search... Navigation iFrame Integration Interactive Demo Change the chain and token address to update the interactive demo below. Your iFrame integration will follow a similar pattern with chain and token address inputs, see the [quickstart section](https://docs.bubblemaps.io/iframe/quickstart) for more details on how to actually integrate the iFrame. [Introduction](https://docs.bubblemaps.io/iframe/introduction) [Quickstart](https://docs.bubblemaps.io/iframe/quickstart) ⌘I --- # Pricing - Bubblemaps B2B [Skip to main content](https://docs.bubblemaps.io/iframe/pricing#content-area) [Bubblemaps B2B home page![light logo](https://mintcdn.com/bubblemaps/6oAdGEcDpUeibzqr/logo/light.svg?fit=max&auto=format&n=6oAdGEcDpUeibzqr&q=85&s=657ad5a4e2748d477ab46010534b9c9e)![dark logo](https://mintcdn.com/bubblemaps/6oAdGEcDpUeibzqr/logo/dark.svg?fit=max&auto=format&n=6oAdGEcDpUeibzqr&q=85&s=6154bdea0f45644a31c71a687f45abc8)](https://docs.bubblemaps.io/) Search... ⌘K Search... Navigation iFrame Integration Pricing On this page * [You need a Partner Id](https://docs.bubblemaps.io/iframe/pricing#you-need-a-partner-id) * [Basic Usage](https://docs.bubblemaps.io/iframe/pricing#basic-usage) * [Exchanges & Analytics Platforms](https://docs.bubblemaps.io/iframe/pricing#exchanges-%26-analytics-platforms) [​](https://docs.bubblemaps.io/iframe/pricing#you-need-a-partner-id) You need a Partner Id --------------------------------------------------------------------------------------------- The iFrame will only work if you specify a `partnerId` value. You can use the `demo` partner id to test things out on `localhost` or `0.0.0.0`, but if you want to actually deploy the iFrame on your site, we’ll need to set up a real partner id for you. This unique id is what unlocks integration on your domains (we’ll ask you your production and development domains to whitelist on our side). We can also set up a custom color theme to better match your brand, it will be triggered by your partner id. [​](https://docs.bubblemaps.io/iframe/pricing#basic-usage) Basic Usage ------------------------------------------------------------------------- No worries, if you just want something simple (for example if you’re a token company and want to display your own map on your showcase website) you won’t have to pay a subcription. Some one-time fees may apply depending on custom labelling or marketing needs. [Contact us](https://docs.bubblemaps.io/cdn-cgi/l/email-protection#bad9d5d4cedbd9cefad8cfd8d8d6dfd7dbcac994d3d585c9cfd8d0dfd9ce87f3dcc8dbd7df9f888af3d4cedfddc8dbced3d5d49f888af3d4cbcfd3c8c3) and we’ll discuss it. [​](https://docs.bubblemaps.io/iframe/pricing#exchanges-&-analytics-platforms) Exchanges & Analytics Platforms ----------------------------------------------------------------------------------------------------------------- We have multiple subscription plans depending on volume, customization options, chains support, marketing support, etc. Please [get in touch](https://docs.bubblemaps.io/cdn-cgi/l/email-protection#2b4844455f4a485f6b495e4949474e464a5b5805424414585e49414e485f16624d594a464e0e191b62455f4e4c594a5f4244450e191b62455a5e425952) for more details. [Quickstart](https://docs.bubblemaps.io/iframe/quickstart) [Introduction](https://docs.bubblemaps.io/data/api/introduction) ⌘I --- # Get Supported Chains - Bubblemaps B2B [Skip to main content](https://docs.bubblemaps.io/data/api/endpoints/get-supported-chains#content-area) [Bubblemaps B2B home page![light logo](https://mintcdn.com/bubblemaps/6oAdGEcDpUeibzqr/logo/light.svg?fit=max&auto=format&n=6oAdGEcDpUeibzqr&q=85&s=657ad5a4e2748d477ab46010534b9c9e)![dark logo](https://mintcdn.com/bubblemaps/6oAdGEcDpUeibzqr/logo/dark.svg?fit=max&auto=format&n=6oAdGEcDpUeibzqr&q=85&s=6154bdea0f45644a31c71a687f45abc8)](https://docs.bubblemaps.io/) Search... ⌘K Search... Navigation Data API \[Beta\] Get Supported Chains Get Supported Chains cURL Copy curl --request GET \ --url https://api.bubblemaps.io/chains \ --header 'X-ApiKey: ' 200 422 Copy [\ {\ "id": "eth",\ "name": "",\ "dexscreener_id": "",\ "coingecko_id": ""\ }\ ] GET / chains Try it Get Supported Chains cURL Copy curl --request GET \ --url https://api.bubblemaps.io/chains \ --header 'X-ApiKey: ' 200 422 Copy [\ {\ "id": "eth",\ "name": "",\ "dexscreener_id": "",\ "coingecko_id": ""\ }\ ] Get the list of chains that we currently support. We’ve included corresponding ids of the CoinGecko and DEX Screener platforms, which you can use as a common matching reference if needed. #### Authorizations [​](https://docs.bubblemaps.io/data/api/endpoints/get-supported-chains#authorization-x-api-key) X-ApiKey string header required #### Response 200 application/json Successful Response [​](https://docs.bubblemaps.io/data/api/endpoints/get-supported-chains#response-items-id) id enum required Available options: `eth`, `base`, `solana`, `tron`, `bsc`, `apechain`, `ton`, `polygon`, `avalanche`, `sonic`, `monad` [​](https://docs.bubblemaps.io/data/api/endpoints/get-supported-chains#response-items-name) name string required [​](https://docs.bubblemaps.io/data/api/endpoints/get-supported-chains#response-items-dexscreener-id-one-of-0) dexscreener\_id string | null [​](https://docs.bubblemaps.io/data/api/endpoints/get-supported-chains#response-items-coingecko-id-one-of-0) coingecko\_id string | null [Authentication](https://docs.bubblemaps.io/data/api/authentication) [Get Map Data](https://docs.bubblemaps.io/data/api/endpoints/get-map-data) ⌘I --- # Quickstart - Bubblemaps B2B [Skip to main content](https://docs.bubblemaps.io/iframe/quickstart#content-area) [Bubblemaps B2B home page![light logo](https://mintcdn.com/bubblemaps/6oAdGEcDpUeibzqr/logo/light.svg?fit=max&auto=format&n=6oAdGEcDpUeibzqr&q=85&s=657ad5a4e2748d477ab46010534b9c9e)![dark logo](https://mintcdn.com/bubblemaps/6oAdGEcDpUeibzqr/logo/dark.svg?fit=max&auto=format&n=6oAdGEcDpUeibzqr&q=85&s=6154bdea0f45644a31c71a687f45abc8)](https://docs.bubblemaps.io/) Search... ⌘K Search... Navigation iFrame Integration Quickstart [​](https://docs.bubblemaps.io/iframe/quickstart#iframe-tag) iFrame Tag -------------------------------------------------------------------------- You can iFrame a bubble map by simply setting the URL of the map in the `src` attribute of an `iframe` html tag, like this: Copy Note the simple structure of the URL: Copy https://iframe.bubblemaps.io/map?chain=[chain_id]&address=[token_address]&partnerId=[partner_id] [​](https://docs.bubblemaps.io/iframe/quickstart#available-chains) Available Chains -------------------------------------------------------------------------------------- Currently available chains are `solana`, `eth`, `bsc`, `tron`, `base`, `apechain`, `sonic`, `ton`, `avalanche`, `polygon`, and `monad`. We will keep this list updated. But if you want to get technical and dynamically update your iFrames as we release more chains, you could use our [Supported Chains](https://docs.bubblemaps.io/data/api/endpoints/get-supported-chains) API endpoint. Don’t hesitate to ask. [​](https://docs.bubblemaps.io/iframe/quickstart#partner-id) Partner Id -------------------------------------------------------------------------- If you don’t have a dedicated partner id yet, you can use `demo` to test things out. More info in the [pricing section](https://docs.bubblemaps.io/iframe/pricing) . Otherwise, replace `demo` by your actual partner id. It will unlock the integration on your domains. Your partner id is **not** a secret, so you can have it showing in clear in your frontend code. It only unlocks the integration on your domains, and can not be used to impersonate you. [​](https://docs.bubblemaps.io/iframe/quickstart#styling) Styling -------------------------------------------------------------------- Of course, you still have to style your iframe in terms of size and border to place it correctly in your layout. Keep in mind that browsers usually apply a default border on iframes, which you’ll have to remove. We also recommend using at least a 600px height. Copy iframe { width: 100%; height: 700px; border: none; } Exemple with inline styling: Copy **Custom color themes** are also available on-demand, no code change needed (the color theme is triggered by the partner id). [Interactive Demo](https://docs.bubblemaps.io/iframe/demo) [Pricing](https://docs.bubblemaps.io/iframe/pricing) ⌘I ---