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

# Obtener usuario actual

> Consultar la cuenta autenticada

Devuelve la información de la cuenta del usuario autenticado, incluyendo saldo, límite de crédito, exposición actual, formato de cuotas por defecto y flags de acceso.

<h2 id="request">
  Solicitud
</h2>

`GET /user/getMe`

Este endpoint no recibe parámetros. Se requiere autenticación (consulta [Autenticación](/es/pages/rest/authentication)).

<CodeGroup>
  ```bash curl theme={null}
  curl https://api.4casters.io/user/getMe \
    -H "Authorization: Bearer YOUR_TOKEN"
  ```
</CodeGroup>

<h2 id="response">
  Respuesta
</h2>

<ResponseField name="data" type="object">
  <Expandable title="data">
    <ResponseField name="user" type="object">
      <Expandable title="user">
        <ResponseField name="id" type="string">Id de usuario.</ResponseField>
        <ResponseField name="username" type="string">Nombre de usuario de la cuenta.</ResponseField>
        <ResponseField name="type" type="string">Tipo de cuenta — `free`, `p2p`, `marketmaker` o `agent`.</ResponseField>
        <ResponseField name="oddsFormat" type="string">Formato de cuotas por defecto. `american` o `decimal`.</ResponseField>
        <ResponseField name="displayBalance" type="number">Saldo actual (valor de visualización).</ResponseField>
        <ResponseField name="creditLimit" type="number">Límite de crédito (negativo en cuentas de crédito).</ResponseField>
        <ResponseField name="liability" type="number">Exposición abierta actual en todos los juegos.</ResponseField>
        <ResponseField name="commissionCharged" type="number">Tasa de comisión cobrada a esta cuenta.</ResponseField>
        <ResponseField name="maxLiability" type="number">Tope de exposición a nivel de cuenta.</ResponseField>
        <ResponseField name="hasMarketMakerAccess" type="boolean">Si la cuenta puede acceder a funciones de market-maker.</ResponseField>

        <ResponseField name="isAdmin" type="boolean" />

        <ResponseField name="isPro" type="boolean" />

        <ResponseField name="isDeposit" type="boolean" />

        <ResponseField name="isAlphaUser" type="boolean" />

        <ResponseField name="defaultExpiry" type="integer">Expiración de orden por defecto, en minutos. `null` para "sin valor por defecto".</ResponseField>
        <ResponseField name="defaultOffer" type="number">Tamaño de oferta por defecto al colocar órdenes.</ResponseField>

        <ResponseField name="sportsbookDefault" type="boolean" />

        <ResponseField name="sportsbookMinimumDisplay" type="number" />

        <ResponseField name="defaultRotationNumbers" type="boolean" />

        <ResponseField name="displayRotationNumbers" type="boolean" />

        <ResponseField name="viewOddsWithCommission" type="boolean" />

        <ResponseField name="defaultSendOrderMessage" type="boolean" />

        <ResponseField name="showChatLastMessage" type="boolean" />

        <ResponseField name="yesNoSummary" type="boolean" />

        <ResponseField name="accessCode" type="string">Código de registro de la cuenta.</ResponseField>
        <ResponseField name="p2pCode" type="string">Si es una cuenta de agente P2P, el código que usan sus referidos al registrarse.</ResponseField>
        <ResponseField name="createdAt" type="string">Marca de tiempo ISO 8601 de creación de la cuenta.</ResponseField>
        <ResponseField name="emailConfirmation" type="boolean">Si el email de la cuenta está confirmado.</ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<h3 id="example">
  Ejemplo
</h3>

<CodeGroup>
  ```json JSON theme={null}
  {
    "data": {
      "user": {
        "id": "5fe37acbb5a23600123662c1",
        "username": "your_username",
        "type": "p2p",
        "oddsFormat": "american",
        "displayBalance": 1250.50,
        "creditLimit": 500,
        "liability": -125.00,
        "commissionCharged": 0.01,
        "hasMarketMakerAccess": false,
        "isAdmin": false,
        "isPro": false,
        "createdAt": "2020-12-23T17:14:09.000Z",
        "emailConfirmation": true
      }
    }
  }
  ```
</CodeGroup>


## OpenAPI

````yaml GET /user/getMe
openapi: 3.1.0
info:
  title: 4casters REST API
  version: 1.0.0
  description: >-
    Public REST API for the 4casters peer-to-peer betting exchange. Use this API
    to manage your account, query the orderbook and games, and place / edit /
    cancel orders.


    All responses (unless noted otherwise) are JSON envelopes of the form `{
    "data": ... }`.
  contact:
    name: 4casters
    url: https://4casters.io
servers:
  - url: https://api.4casters.io
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Authentication
    description: Login and account session management
  - name: User
    description: Read account info, bets, and orders
  - name: Orders
    description: Place, edit, look up, and cancel orders
  - name: Markets
    description: Browse leagues, games, participants, and orderbooks
  - name: Affiliate
    description: Affiliate / referral commission
paths:
  /user/getMe:
    get:
      tags:
        - User
      summary: Get current user
      description: >-
        Return the currently-authenticated user's account information including
        balance, credit limit, current liability, default odds format, and
        access flags.
      responses:
        '200':
          description: Current user info
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      user:
                        $ref: '#/components/schemas/User'
        '401':
          $ref: '#/components/responses/Unauthorized'
components:
  schemas:
    User:
      type: object
      properties:
        id:
          type: string
          description: User id.
        username:
          type: string
        type:
          $ref: '#/components/schemas/UserType'
        oddsFormat:
          $ref: '#/components/schemas/OddsFormat'
        displayBalance:
          type: number
          description: Current balance (display value).
        creditLimit:
          type: number
          description: Credit limit (negative for credit accounts).
        liability:
          type: number
          description: Current open liability across all games.
        commissionCharged:
          type: number
          description: Commission rate charged to this account.
        maxLiability:
          type: number
          description: Account-level cap on liability.
        matchedVolume:
          type: object
          description: Account preferences for displaying matched volume.
        openInterest:
          type: object
          description: Account preferences for displaying open interest.
        isAdmin:
          type: boolean
        hasMarketMakerAccess:
          type: boolean
        isPro:
          type: boolean
        isDeposit:
          type: boolean
        isAlphaUser:
          type: boolean
        sportsbookDefault:
          type: boolean
        defaultRotationNumbers:
          type: boolean
        displayRotationNumbers:
          type: boolean
        viewOddsWithCommission:
          type: boolean
        defaultExpiry:
          type: integer
          nullable: true
          description: Default order expiry, in minutes.
        defaultOffer:
          type: number
          nullable: true
          description: Default offer size when placing orders.
        defaultSendOrderMessage:
          type: boolean
        sportsbookMinimumDisplay:
          type: number
        showChatLastMessage:
          type: boolean
        yesNoSummary:
          type: boolean
        accessCode:
          type: string
          nullable: true
        code:
          type: string
          nullable: true
        p2pCode:
          type: string
          nullable: true
        createdAt:
          type: string
          format: date-time
        emailConfirmation:
          type: boolean
    UserType:
      type: string
      enum:
        - free
        - p2p
        - marketmaker
        - agent
      description: Account type.
    OddsFormat:
      type: string
      enum:
        - american
        - decimal
  responses:
    Unauthorized:
      description: Missing or invalid auth token
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Pass your auth token in the `Authorization` header. The `Bearer` prefix
        is optional; the server also accepts a signed `auth` cookie or a `token`
        field in the request body.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.