Create a free API key

Create a Free-plan key (100 requests a day). The key is shown once; the server stores only its hash. Limited to 3 signups per address per day.

POST /signup

Create a Free-plan key (100 requests a day). The key is shown once; the server stores only its hash. Limited to 3 signups per address per day.

Authentication

No API key is required for this route.

Request body

{
  "content": {
    "application/json": {
      "schema": {
        "$ref": "#/components/schemas/SignupRequest"
      }
    }
  },
  "required": true
}

Example request

curl --fail-with-body -X POST \
  "https://polymarket.omray.dev/signup"

Responses

StatusMeaning
201Successful Response
422Validation Error

Authenticated requests can return 401 for an invalid key or 429 when a plan limit is reached. Upstream failures may return a server error; do not treat an error as an empty dataset.

OpenAPI operation schema
{
  "tags": [
    "Account"
  ],
  "summary": "Create a free API key",
  "description": "Create a Free-plan key (100 requests a day). The key is shown once; the server stores only its hash. Limited to 3 signups per address per day.",
  "operationId": "signup",
  "requestBody": {
    "content": {
      "application/json": {
        "schema": {
          "$ref": "#/components/schemas/SignupRequest"
        }
      }
    },
    "required": true
  },
  "responses": {
    "201": {
      "description": "Successful Response",
      "content": {
        "application/json": {
          "schema": {}
        }
      }
    },
    "422": {
      "description": "Validation Error",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/HTTPValidationError"
          }
        }
      }
    }
  }
}