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

# Get My Info

> Instantly check your API key details, tier limits, and daily usage.

Not sure if you're hitting your rate limits or if your 30-day Pro trial expired? Drop your key in here. We'll bounce back exactly what your integration is currently allowed to do.

<RequestExample>
  ```bash cURL theme={null}
  curl -H "Authorization: Bearer YOUR_KEY_HERE" \
    https://polychadsbot.xyz/api/v1/me
  ```

  ```python Python theme={null}
  import requests

  response = requests.get(
      "https://polychadsbot.xyz/api/v1/me",
      headers={"Authorization": "Bearer YOUR_KEY_HERE"}
  )
  print(response.json())
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={null}
  {
    "name": "My Prod Bot",
    "tier": "pro",
    "rate_limit": "300/min",
    "websocket": true,
    "webhooks": false,
    "realtime": true,
    "max_page_size": 50,
    "requests_today": 1240
  }
  ```
</ResponseExample>

## Response Breakdown

| Field            | Type    | What it tells you                                                                     |
| ---------------- | ------- | ------------------------------------------------------------------------------------- |
| `name`           | string  | Any custom label you've set for this key (useful for managing multiple integrations). |
| `tier`           | string  | Either `free`, `pro`, or `enterprise`.                                                |
| `rate_limit`     | string  | Your hard cap limits (e.g., `300/min`).                                               |
| `websocket`      | boolean | True if you have access to the `/ws/alerts` live stream.                              |
| `webhooks`       | boolean | True if you can register HTTP endpoints for push delivery.                            |
| `realtime`       | boolean | True if you get alerts instantly, False if you have the 5-minute Free tier delay.     |
| `max_page_size`  | integer | Max results you can request per page on the `/alerts` REST endpoint.                  |
| `requests_today` | integer | Total API calls you've made since UTC midnight.                                       |

<Tip>
  Building a front-end? Hit this endpoint on page load to check if the user's provided API key is valid before opening any WebSocket connections.
</Tip>


## OpenAPI

````yaml GET /me
openapi: 3.0.3
info:
  title: Polychads Alerts API
  version: '1.0'
  description: Real-time Polymarket insider trading alerts
servers:
  - url: https://polychadsbot.xyz/api/v1
security:
  - bearerAuth: []
paths:
  /me:
    get:
      summary: Get My Info
      description: Your API key details and usage.
      operationId: getMe
      responses:
        '200':
          description: Key info
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KeyInfo'
components:
  schemas:
    KeyInfo:
      type: object
      properties:
        name:
          type: string
        tier:
          type: string
        rate_limit:
          type: string
        websocket:
          type: boolean
        webhooks:
          type: boolean
        realtime:
          type: boolean
        max_page_size:
          type: integer
        requests_today:
          type: integer
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Your API key — get one from @chadsapibot on Telegram

````