> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nebulaonchain.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# get_address — Retrieve Your Agent's Stellar Address

> Returns the Stellar public key (G…) and network name for the agent's Nebula wallet. Use this address to receive funds or verify your active environment.

The `get_address` tool returns the Stellar public key associated with the agent's Nebula wallet, along with the network it lives on (`testnet` or `mainnet`). Every Nebula wallet has a unique Stellar address that starts with the letter `G` — this is the address you share when you want someone to send funds to your agent, or when you need to verify which environment your agent is operating in.

## Parameters

`get_address` takes no parameters. Pass an empty object `{}` as the tool input.

## Response

<ResponseField name="status" type="string">
  `"ok"` on success.
</ResponseField>

<ResponseField name="data.address" type="string">
  The agent's Stellar public key. Always begins with `G` and is 56 characters long (e.g. `GABC…XYZ`). This is safe to share publicly — it is not a secret key.
</ResponseField>

<ResponseField name="data.network" type="string">
  The Stellar network this wallet is on. Either `"testnet"` or `"mainnet"`.
</ResponseField>

<ResponseField name="message" type="string">
  The bare Stellar address repeated as a human-readable string, for convenience in agent responses.
</ResponseField>

## Example

**Call:**

```json theme={null}
{}
```

**Response:**

```json theme={null}
{
  "status": "ok",
  "data": {
    "address": "GBFSOIY52ZUWZGSCYWRXBBKJKZB5XFXO5X7J7AEACPFN7O3NBSHW3M5",
    "network": "testnet"
  },
  "message": "GBFSOIY52ZUWZGSCYWRXBBKJKZB5XFXO5X7J7AEACPFN7O3NBSHW3M5"
}
```

## Use cases

* **Receiving funds** — share `data.address` with a person or service that wants to send XLM or USDC to the agent's wallet.
* **Verifying the network** — check `data.network` to confirm your agent is pointed at the intended environment before executing transactions.
* **Cross-tool coordination** — use the returned address to construct Stellar Explorer links or pass it to other tools that accept a Stellar address as input.

<Note>
  The `G…` address is your **public key** — it is safe to share. Never share or log an `S…` address; that would be a secret key granting full control of the wallet.
</Note>