Skip to main content
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

​
status
string
"ok" on success.
​
data.address
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.
​
data.network
string
The Stellar network this wallet is on. Either "testnet" or "mainnet".
​
message
string
The bare Stellar address repeated as a human-readable string, for convenience in agent responses.

​
Example

Call: 
{}
Response: 
{
  "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.
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.