---
updatedAt: 2026-05-27T08:52:35.000Z
agentTools:
  projectIndex: https://docs.tatum.io/llms.txt
---

# Generate XLM account

<p style="display: none">/v3/xlm/account</p>
<h4>5 credits per API call.</h4><br/>
<p>Generate XLM account. Tatum does not support HD wallet for XLM, only specific address and private key can be generated.</p>


# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "servers": [
    {
      "url": "https://api.tatum.io"
    }
  ],
  "info": {
    "version": "3.18.3",
    "title": "Blockchain"
  },
  "tags": [
    {
      "name": "Stellar - Tatum API"
    }
  ],
  "paths": {
    "/v3/xlm/account": {
      "get": {
        "description": "<p style=\"display: none\">/v3/xlm/account</p>\n<h4>5 credits per API call.</h4><br/>\n<p>Generate XLM account. Tatum does not support HD wallet for XLM, only specific address and private key can be generated.</p>\n",
        "operationId": "XlmWallet",
        "responses": {
          "200": {
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/XlmWallet"
                }
              }
            },
            "description": "OK"
          },
          "401": {
            "$ref": "#/components/responses/Error401"
          },
          "403": {
            "description": "Forbidden. The request is authenticated, but it is not possible to required perform operation due to logical error or invalid permissions.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error403XlmFailed"
                }
              }
            }
          },
          "500": {
            "$ref": "#/components/responses/Error500"
          }
        },
        "security": [
          {
            "X-API-Key": []
          }
        ],
        "x-codeSamples": [],
        "summary": "Generate XLM account",
        "tags": [
          "Stellar - Tatum API"
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "Error401Invalid": {
        "properties": {
          "errorCode": {
            "example": "subscription.invalid",
            "description": "subscription.invalid",
            "type": "string"
          },
          "message": {
            "example": "Unable to find valid subscription for '${apiKey}'",
            "description": "Unable to find valid subscription for '${apiKey}'",
            "type": "string"
          },
          "statusCode": {
            "example": 401,
            "description": "401",
            "type": "number"
          }
        },
        "required": [
          "errorCode",
          "message",
          "statusCode"
        ],
        "type": "object"
      },
      "Error401NotActive": {
        "properties": {
          "errorCode": {
            "example": "subscription.not.active",
            "description": "subscription.not.active",
            "type": "string"
          },
          "message": {
            "example": "Subscription not active anymore.",
            "description": "Subscription not active anymore.",
            "type": "string"
          },
          "statusCode": {
            "example": 401,
            "description": "401",
            "type": "number"
          }
        },
        "required": [
          "errorCode",
          "message",
          "statusCode"
        ],
        "type": "object"
      },
      "Error403XlmFailed": {
        "properties": {
          "errorCode": {
            "description": "xlm.failed",
            "example": "xlm.failed",
            "type": "string"
          },
          "message": {
            "description": "Unable to communicate with blockchain. ${error}",
            "example": "Unable to communicate with blockchain. ${error}",
            "type": "string"
          },
          "statusCode": {
            "description": "403",
            "example": 403,
            "type": "number"
          }
        },
        "required": [
          "errorCode",
          "message",
          "statusCode"
        ],
        "type": "object"
      },
      "Error500": {
        "properties": {
          "message": {
            "example": "Internal server error",
            "description": "Internal server error",
            "type": "string"
          },
          "statusCode": {
            "example": 500,
            "description": "500",
            "type": "number"
          }
        },
        "required": [
          "statusCode",
          "message"
        ],
        "type": "object"
      },
      "XlmWallet": {
        "type": "object",
        "required": [
          "address",
          "secret"
        ],
        "properties": {
          "address": {
            "description": "Generated account address.",
            "example": "GDKYMXOAJ5MK4EVIHHNWRGAAOUZMNZYAETMHFCD6JCVBPZ77TUAZFPKT",
            "type": "string"
          },
          "secret": {
            "description": "Generated secret for account.",
            "example": "SCVVKNLBHOWBNJYHD3CNROOA2P3K35I5GNTYUHLLMUHMHWQYNEI7LVED",
            "type": "string"
          }
        }
      }
    },
    "responses": {
      "Error401": {
        "description": "Unauthorized. Not valid or inactive subscription key present in the HTTP Header.",
        "content": {
          "application/json": {
            "schema": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/Error401NotActive"
                },
                {
                  "$ref": "#/components/schemas/Error401Invalid"
                }
              ]
            }
          }
        }
      },
      "Error500": {
        "description": "Internal server error. There was an error on the server during the processing of the request.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Error500"
            }
          }
        }
      }
    },
    "securitySchemes": {
      "X-API-Key": {
        "type": "apiKey",
        "name": "x-api-key",
        "in": "header",
        "description": "Your **API key** is used to identify your account & your plan, including the number of API calls per second and total monthly calls you have.\n\nEach key is for individual use only.\n\nIf you don't have a key already you can [Sign up for a Free Tatum account](https://co.tatum.io/signup) to get two keys (testnet and mainnet), allowing up to 5 API calls per second and 1,000,000 Credits.\n\nFor testing purposes, you can use the following key which only works inside docs and has limited functionality (e.g. you cannot create virtual accounts or notification subscriptions with it):\n* t-66a730ccccfd17001c479705-2f597d14ad7543f289a03418\n\nFor more details on limits and plans, [click here](https://docs.tatum.io/docs/plans-limits).\n"
      }
    }
  }
}
```