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

# Token

> This endpoint creates a new token and mints an initial supply to a specified owner address. The token's parameters, such as its symbol, initial quantity, and owner, are specified in the request body. Under the hood, OmniSafe handles the necessary blockchain interactions to register the token and assign the initial tokens to the owner on the blockchain.



## OpenAPI

````yaml POST   /v1/tokens
openapi: 3.0.1
info:
  contact:
    email: developers@ecrop.com
    name: ecrop OmniSafe API Support
    url: https://ecrop.de/contact/
  description: >
    # Preparation Guide

    Welcome to the OmniSafe API Documentation. This document provides a detailed
    list of available APIs and methods for managing wallets, tokens, and
    transfers. Before beginning your integration, it’s recommended to review the
    following essential documents:

    - **API Service Guide (Essential, Pro):** Designed for non-technical users,
      this guide helps in selecting the best API package based on business needs.
      Review it [here](https://youki.atlassian.net/wiki/spaces/mar/pages/534183949/API+Service+Guide).  # Keep or adapt

    - **Integration Handbook:** Targeted at developers, this handbook includes
      crucial details such as endpoint URLs, authentication methods,
      request/response formats, and error handling. It is essential for
      successful integration. Access the handbooks here:

      - [🌳 Pro Package Integration Handbook] # Keep or adapt

      - [🌱 Essential Package Integration Handbook] # Keep or adapt

    Familiarizing yourself with these documents will ensure a smoother
    integration process.
  license:
    name: ecrop OmniSafe
    url: https://developers.ecrop.de/api-license/
  termsOfService: https://developers.ecrop.de/terms-of-use/
  title: OmniSafe API Catalogue
  version: 1.0.0
  x-logo:
    backgroundColor: '#DDDDDD'
    url: >-
      https://static.wixstatic.com/media/fd3e8b_a57864adb1084dea94c9fab462a8f52c~mv2.png/v1/crop/x_0,y_131,w_1253,h_295/fill/w_233,h_55,al_c,q_85,usm_0.66_1.00_0.01,enc_auto/fd3e8b_a57864adb1084dea94c9fab462a8f52c~mv2.png
servers:
  - description: Default
    url: https://omnisafe.sandbox.ecrop.de/omni-safe
security:
  - Bearer Authentication: []
tags:
  - name: Wallets
    description: Endpoints for managing wallets
  - name: Tokens
    description: Endpoints for managing tokens
  - name: Transfers
    description: Endpoints for managing transfers
paths:
  /v1/tokens:
    post:
      tags:
        - Tokens
      summary: Create a token and mint
      description: >-
        This endpoint creates a new token and mints an initial supply to a
        specified owner address. The token's parameters, such as its symbol,
        initial quantity, and owner, are specified in the request body. Under
        the hood, OmniSafe handles the necessary blockchain interactions to
        register the token and assign the initial tokens to the owner on the
        blockchain.
      operationId: createTokenAndMint
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TokenMintDto'
        required: true
      responses:
        '201':
          description: The created token address
          content:
            text/plain:
              schema:
                type: string
                description: The created token address
components:
  schemas:
    TokenMintDto:
      type: object
      properties:
        ownerAddress:
          type: string
          description: The address that will own the newly minted tokens.
        info:
          type: string
          description: Additional information about the token.
        symbol:
          type: string
          description: The symbol of the token (e.g., ABC).
        quantity:
          type: number
          description: The total amount of tokens to mint.
        key:
          type: string
          description: A key that will be related to this transfer.
  securitySchemes:
    Bearer Authentication:
      type: http
      scheme: bearer
      bearerFormat: JWT

````