# Data Sharing

### Data Sharing Parameters for Mini Apps in Speed Wallet

When a wallet user opens a mini app within the Speed Wallet, the platform automatically appends essential parameters to the app’s URL. These parameters provide valuable context about the user and their account, enabling seamless integration and personalized app experiences. 

Below are the parameters that are currently passed in the app’s URL:

1. **acct** (account id):  

   The unique Speed Wallet account ID of the user accessing your mini app. This parameter helps identify the user and manage account-specific interactions within your app.
2. **lang** ( language ): 

   Specifies the language preference of the user within the Speed Wallet application. This enables your app to display content in the user’s preferred language, enhancing the user experience. Example values: en, es, de, hi, etc.
3. **bal\_btc** (account bitcoin balance) : 

   Displays the available Bitcoin (BTC) balance in the user’s Speed Wallet account. The balance is provided in Satoshis (SATs), the smallest unit of Bitcoin (1 BTC = 100,000,000 SATs). This parameter is useful for apps involving payments, investments, or transactions in Bitcoin.
4. **bal\_usdt** ( account USDT balance ) : 

   Indicates the available USDT (Tether) balance in the user’s Speed Wallet account. The balance is provided in standard USDT units, supporting apps that facilitate stablecoin transactions, trading, or purchases.
5. **p\_add** (account lightning address) : 

   Provides the user’s Lightning Network (LN) address associated with their Speed Wallet account. This address is essential for facilitating fast and low-cost transactions over the Lightning Network, particularly for apps offering microtransactions or instant payments.

#### **Example URL with parameters**

`https://subdomain.yourdomain.com?`**`acct=acct_li8hh2xyRuSBWnE4`**`&`**`lang=en`**`&`**`bal_btc=87636`**`&`**`bal_usdt=1975.29`**`&`**`p_add=abc%40speed.app`**  

In this example:

• Mini App URL: `https://subdomain.yourdomain.com`

• Account ID: acct\_li8hh2xyRuSBWnE4

• Language: en (English)

• Bitcoin Balance: 87,636 SATs

• USDT Balance: 1,975.29 USDT

• Lightning Address: <abc@speed.app>

> While creating the mini app, when you click on "Open App" as a developer, Speed sends your account details, including your Speed wallet account ID, balances, and Lightning address as explained above.
>
> However, once your app is listed and used by other Speed wallet users, Speed will send their specific account details in real time which you can use in your mini app.

#### Security Considerations

The above parameters are securely included in the app’s URL without using encryption. App developers should handle these parameters with care, ensuring they are not exposed or logged in a way that compromises user security or privacy.


---

# Agent Instructions: 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:

```
GET https://speed-wallet.gitbook.io/speed-wallet-mini-apps/data-sharing.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.