# api.polymarket.m7.org Endpoint Documentation

Generated on 2026-07-19 from `cli/endpoints.php --json`, `config/general.json`, and the PHP handlers under `lib/php/thisProject/api`.

## Conventions

- Base URL: `https://api.polymarket.m7.org`
- Response format: `json`; error format: `json`.
- Request parameters are read from the parsed request payload (`$this->r`), which may include query, form, or JSON body values depending on the router parser.
- `ANY` means the route is registered without an HTTP-method constraint. Prefer `POST` for mutations and request bodies unless the caller contract says otherwise.
- "Detected request fields" are statically extracted from handlers and delegated service methods; table-backed filters may accept additional fields.

## Authentication

- No `auth.m7_token` block is present in `config/general.json`; handlers may still validate tokens directly.
- No principal route protection block was found in config.

## Endpoint Summary

| Method | Path | Auth | Handler |
| --- | --- | --- | --- |
| `ANY` | `/api/hello` | no explicit auth gate detected in route/handler | `hello\Controller` |
| `ANY` | `/api/v1/control/bronze/cursors` | validated token required by `api/control/Controller.php` | `control\bronze\cursors\Select` |
| `ANY` | `/api/v1/control/bronze/cursors/view` | validated token required by `api/control/Controller.php` | `control\bronze\cursors\View` |
| `ANY` | `/api/v1/control/bronze/http-documents` | validated token required by `api/control/Controller.php` | `control\bronze\httpDocuments\Select` |
| `ANY` | `/api/v1/control/bronze/http-documents/view` | validated token required by `api/control/Controller.php` | `control\bronze\httpDocuments\View` |
| `ANY` | `/api/v1/control/bronze/runs` | validated token required by `api/control/Controller.php` | `control\bronze\runs\Select` |
| `ANY` | `/api/v1/control/bronze/runs/view` | validated token required by `api/control/Controller.php` | `control\bronze\runs\View` |
| `ANY` | `/api/v1/control/endpoints` | validated token required by `api/control/Controller.php` | `control\endpoints\Select` |
| `ANY` | `/api/v1/control/endpoints/update` | validated token required by `api/control/Controller.php` | `control\endpoints\UpdateById` |
| `ANY` | `/api/v1/control/endpoints/view` | validated token required by `api/control/Controller.php` | `control\endpoints\View` |
| `ANY` | `/api/v1/control/jobs` | validated token required by `api/control/Controller.php` | `control\jobs\Select` |
| `ANY` | `/api/v1/control/jobs/run` | validated token required by `api/control/Controller.php` | `control\jobs\Run` |
| `ANY` | `/api/v1/control/jobs/update` | validated token required by `api/control/Controller.php` | `control\jobs\UpdateById` |
| `ANY` | `/api/v1/control/jobs/view` | validated token required by `api/control/Controller.php` | `control\jobs\View` |
| `ANY` | `/api/v1/control/processors` | validated token required by `api/control/Controller.php` | `control\processors\Select` |
| `ANY` | `/api/v1/control/processors/update` | validated token required by `api/control/Controller.php` | `control\processors\UpdateById` |
| `ANY` | `/api/v1/control/processors/view` | validated token required by `api/control/Controller.php` | `control\processors\View` |
| `ANY` | `/api/v1/control/runs` | validated token required by `api/control/Controller.php` | `control\runs\Select` |
| `ANY` | `/api/v1/control/runs/view` | validated token required by `api/control/Controller.php` | `control\runs\View` |
| `ANY` | `/api/v1/endpoints` | no explicit auth gate detected in route/handler | `endpoints\Select` |
| `ANY` | `/api/v1/endpoints/view` | no explicit auth gate detected in route/handler | `endpoints\View` |
| `ANY` | `/api/v1/hello` | no explicit auth gate detected in route/handler | `hello\Controller` |
| `ANY` | `/api/v1/reference/events` | no explicit auth gate detected in route/handler | `reference\events\Select` |
| `ANY` | `/api/v1/reference/events/tags` | no explicit auth gate detected in route/handler | `reference\events\tags\Select` |
| `ANY` | `/api/v1/reference/events/tags/view` | no explicit auth gate detected in route/handler | `reference\events\tags\View` |
| `ANY` | `/api/v1/reference/events/view` | no explicit auth gate detected in route/handler | `reference\events\View` |
| `ANY` | `/api/v1/reference/markets` | no explicit auth gate detected in route/handler | `reference\markets\Select` |
| `ANY` | `/api/v1/reference/markets/tags` | no explicit auth gate detected in route/handler | `reference\markets\tags\Select` |
| `ANY` | `/api/v1/reference/markets/tags/view` | no explicit auth gate detected in route/handler | `reference\markets\tags\View` |
| `ANY` | `/api/v1/reference/markets/tokens` | no explicit auth gate detected in route/handler | `reference\markets\tokens\Select` |
| `ANY` | `/api/v1/reference/markets/tokens/view` | no explicit auth gate detected in route/handler | `reference\markets\tokens\View` |
| `ANY` | `/api/v1/reference/markets/view` | no explicit auth gate detected in route/handler | `reference\markets\View` |
| `ANY` | `/api/v1/reference/series` | no explicit auth gate detected in route/handler | `reference\series\Select` |
| `ANY` | `/api/v1/reference/series/view` | no explicit auth gate detected in route/handler | `reference\series\View` |
| `ANY` | `/api/v1/reference/tags` | no explicit auth gate detected in route/handler | `reference\tags\Select` |
| `ANY` | `/api/v1/reference/tags/view` | no explicit auth gate detected in route/handler | `reference\tags\View` |
| `ANY` | `/api/v2/control/bronze/cursors` | validated token required by `api/control/Controller.php` | `control\bronze\cursors\Select` |
| `ANY` | `/api/v2/control/bronze/cursors/view` | validated token required by `api/control/Controller.php` | `control\bronze\cursors\View` |
| `ANY` | `/api/v2/control/bronze/http-documents` | validated token required by `api/control/Controller.php` | `control\bronze\httpDocuments\Select` |
| `ANY` | `/api/v2/control/bronze/http-documents/view` | validated token required by `api/control/Controller.php` | `control\bronze\httpDocuments\View` |
| `ANY` | `/api/v2/control/bronze/runs` | validated token required by `api/control/Controller.php` | `control\bronze\runs\Select` |
| `ANY` | `/api/v2/control/bronze/runs/view` | validated token required by `api/control/Controller.php` | `control\bronze\runs\View` |
| `ANY` | `/api/v2/control/endpoints` | validated token required by `api/control/Controller.php` | `control\endpoints\Select` |
| `ANY` | `/api/v2/control/endpoints/update` | validated token required by `api/control/Controller.php` | `control\endpoints\UpdateById` |
| `ANY` | `/api/v2/control/endpoints/view` | validated token required by `api/control/Controller.php` | `control\endpoints\View` |
| `ANY` | `/api/v2/control/jobs` | validated token required by `api/control/Controller.php` | `control\jobs\Select` |
| `ANY` | `/api/v2/control/jobs/run` | validated token required by `api/control/Controller.php` | `control\jobs\Run` |
| `ANY` | `/api/v2/control/jobs/update` | validated token required by `api/control/Controller.php` | `control\jobs\UpdateById` |
| `ANY` | `/api/v2/control/jobs/view` | validated token required by `api/control/Controller.php` | `control\jobs\View` |
| `ANY` | `/api/v2/control/processors` | validated token required by `api/control/Controller.php` | `control\processors\Select` |
| `ANY` | `/api/v2/control/processors/update` | validated token required by `api/control/Controller.php` | `control\processors\UpdateById` |
| `ANY` | `/api/v2/control/processors/view` | validated token required by `api/control/Controller.php` | `control\processors\View` |
| `ANY` | `/api/v2/control/runs` | validated token required by `api/control/Controller.php` | `control\runs\Select` |
| `ANY` | `/api/v2/control/runs/view` | validated token required by `api/control/Controller.php` | `control\runs\View` |
| `ANY` | `/api/v2/endpoints` | no explicit auth gate detected in route/handler | `endpoints\Select` |
| `ANY` | `/api/v2/endpoints/view` | no explicit auth gate detected in route/handler | `endpoints\View` |
| `ANY` | `/api/v2/hello` | no explicit auth gate detected in route/handler | `hello\Controller` |
| `ANY` | `/api/v2/reference/events` | no explicit auth gate detected in route/handler | `reference\events\Select` |
| `ANY` | `/api/v2/reference/events/tags` | no explicit auth gate detected in route/handler | `reference\events\tags\Select` |
| `ANY` | `/api/v2/reference/events/tags/view` | no explicit auth gate detected in route/handler | `reference\events\tags\View` |
| `ANY` | `/api/v2/reference/events/view` | no explicit auth gate detected in route/handler | `reference\events\View` |
| `ANY` | `/api/v2/reference/markets` | no explicit auth gate detected in route/handler | `reference\markets\Select` |
| `ANY` | `/api/v2/reference/markets/tags` | no explicit auth gate detected in route/handler | `reference\markets\tags\Select` |
| `ANY` | `/api/v2/reference/markets/tags/view` | no explicit auth gate detected in route/handler | `reference\markets\tags\View` |
| `ANY` | `/api/v2/reference/markets/tokens` | no explicit auth gate detected in route/handler | `reference\markets\tokens\Select` |
| `ANY` | `/api/v2/reference/markets/tokens/view` | no explicit auth gate detected in route/handler | `reference\markets\tokens\View` |
| `ANY` | `/api/v2/reference/markets/view` | no explicit auth gate detected in route/handler | `reference\markets\View` |
| `ANY` | `/api/v2/reference/series` | no explicit auth gate detected in route/handler | `reference\series\Select` |
| `ANY` | `/api/v2/reference/series/view` | no explicit auth gate detected in route/handler | `reference\series\View` |
| `ANY` | `/api/v2/reference/tags` | no explicit auth gate detected in route/handler | `reference\tags\Select` |
| `ANY` | `/api/v2/reference/tags/view` | no explicit auth gate detected in route/handler | `reference\tags\View` |

## Endpoints

### ANY /api/hello

Handles hello.

- Handler: `thisProject\api\hello\Controller`
- Source: `lib/php/thisProject/api/hello/Controller.php`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields: none in the handler; endpoint may be informational or delegates opaque input.
- Response: success comment(s): `OK`.

### ANY /api/v1/control/bronze/cursors

Handles control bronze cursors.

- Handler: `thisProject\api\control\bronze\cursors\Select`
- Source: `lib/php/thisProject/api/control/bronze/cursors/Select.php`
- Delegates to: `lib/php/thisProject/service/bronze/SyncCursors.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `cursor_id` (optional/detected). Detected in handler or delegated service code.
  - `endpoint` (optional/detected). Detected in handler or delegated service code.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `source` (optional/detected). Source document/content payload.
- Response: success comment(s): `OK`.
- Notable errors: `[bronze_sync_cursors/select]`; `sync cursor not found`.

### ANY /api/v1/control/bronze/cursors/view

Gets control bronze cursors.

- Handler: `thisProject\api\control\bronze\cursors\View`
- Source: `lib/php/thisProject/api/control/bronze/cursors/View.php`
- Delegates to: `lib/php/thisProject/service/bronze/SyncCursors.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `cursor_id` (optional/detected). Detected in handler or delegated service code.
  - `endpoint` (optional/detected). Detected in handler or delegated service code.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `source` (optional/detected). Source document/content payload.
- Response: success comment(s): `OK`.
- Notable errors: `[bronze_sync_cursors/select]`; `sync cursor not found`.

### ANY /api/v1/control/bronze/http-documents

Handles control bronze http documents.

- Handler: `thisProject\api\control\bronze\httpDocuments\Select`
- Source: `lib/php/thisProject/api/control/bronze/httpDocuments/Select.php`
- Delegates to: `lib/php/thisProject/service/bronze/RawHttpDocuments.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `document_id` (optional/detected). Raw document id.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `request_key` (optional/detected). Request correlation key.
  - `run_id` (optional/detected). Pull/ingestion run id.
- Response: success comment(s): `OK`.
- Notable errors: `[bronze_raw_http_documents/select]`.

### ANY /api/v1/control/bronze/http-documents/view

Gets control bronze http documents.

- Handler: `thisProject\api\control\bronze\httpDocuments\View`
- Source: `lib/php/thisProject/api/control/bronze/httpDocuments/View.php`
- Delegates to: `lib/php/thisProject/service/bronze/RawHttpDocuments.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `document_id` (optional/detected). Raw document id.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `request_key` (optional/detected). Request correlation key.
  - `run_id` (optional/detected). Pull/ingestion run id.
- Response: success comment(s): `OK`.
- Notable errors: `[bronze_raw_http_documents/select]`.

### ANY /api/v1/control/bronze/runs

Handles control bronze runs.

- Handler: `thisProject\api\control\bronze\runs\Select`
- Source: `lib/php/thisProject/api/control/bronze/runs/Select.php`
- Delegates to: `lib/php/thisProject/service/bronze/IngestionRuns.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `run_id` (optional/detected). Pull/ingestion run id.
- Response: success comment(s): `OK`.
- Notable errors: `[bronze_ingestion_runs/select]`.

### ANY /api/v1/control/bronze/runs/view

Gets control bronze runs.

- Handler: `thisProject\api\control\bronze\runs\View`
- Source: `lib/php/thisProject/api/control/bronze/runs/View.php`
- Delegates to: `lib/php/thisProject/service/bronze/IngestionRuns.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `run_id` (optional/detected). Pull/ingestion run id.
- Response: success comment(s): `OK`.
- Notable errors: `[bronze_ingestion_runs/select]`.

### ANY /api/v1/control/endpoints

Handles control endpoints.

- Handler: `thisProject\api\control\endpoints\Select`
- Source: `lib/php/thisProject/api/control/endpoints/Select.php`
- Delegates to: `lib/php/thisProject/service/control/RestPullEndpoints.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `endpoint_id` (optional/detected). REST endpoint id.
  - `endpoint_key` (optional/detected). REST endpoint key.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
- Response: success comment(s): `OK`.
- Notable errors: `[control_rest_pull_endpoints/select]`; `endpoint not found`.

### ANY /api/v1/control/endpoints/update

Updates control endpoints.

- Handler: `thisProject\api\control\endpoints\UpdateById`
- Source: `lib/php/thisProject/api/control/endpoints/UpdateById.php`
- Delegates to: `lib/php/thisProject/service/control/RestPullEndpoints.php::select`, `lib/php/thisProject/service/control/RestPullEndpoints.php::updateByID`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `endpoint_id` (required). REST endpoint id.
  - `endpoint_key` (optional/detected). REST endpoint key.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
- Response: success comment(s): `OK`.
- Notable errors: `Missing endpoint_id`; `endpoint $endpointId not found`; `[control_rest_pull_endpoints/select]`; `endpoint not found`; `[control_rest_pull_endpoints/updateByID]`; `Missing update record`.

### ANY /api/v1/control/endpoints/view

Gets control endpoints.

- Handler: `thisProject\api\control\endpoints\View`
- Source: `lib/php/thisProject/api/control/endpoints/View.php`
- Delegates to: `lib/php/thisProject/service/control/RestPullEndpoints.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `endpoint_id` (optional/detected). REST endpoint id.
  - `endpoint_key` (optional/detected). REST endpoint key.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
- Response: success comment(s): `OK`.
- Notable errors: `[control_rest_pull_endpoints/select]`; `endpoint not found`.

### ANY /api/v1/control/jobs

Handles control jobs.

- Handler: `thisProject\api\control\jobs\Select`
- Source: `lib/php/thisProject/api/control/jobs/Select.php`
- Delegates to: `lib/php/thisProject/service/control/RestPullJobs.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `job_id` (optional/detected). Job id. Some handlers also accept `id` as an alias.
  - `job_key` (optional/detected). REST pull job key.
- Response: success comment(s): `OK`.
- Notable errors: `[control_rest_pull_jobs/select]`; `job not found`.

### ANY /api/v1/control/jobs/run

Runs control jobs.

- Handler: `thisProject\api\control\jobs\Run`
- Source: `lib/php/thisProject/api/control/jobs/Run.php`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields: none in the handler; endpoint may be informational or delegates opaque input.
- Response: success comment(s): `OK`.

### ANY /api/v1/control/jobs/update

Updates control jobs.

- Handler: `thisProject\api\control\jobs\UpdateById`
- Source: `lib/php/thisProject/api/control/jobs/UpdateById.php`
- Delegates to: `lib/php/thisProject/service/control/RestPullJobs.php::select`, `lib/php/thisProject/service/control/RestPullJobs.php::updateByID`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `job_id` (required). Job id. Some handlers also accept `id` as an alias.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `job_key` (optional/detected). REST pull job key.
- Response: success comment(s): `OK`.
- Notable errors: `Missing job_id`; `job $jobId not found`; `[control_rest_pull_jobs/select]`; `job not found`; `[control_rest_pull_jobs/updateByID]`; `Missing update record`.

### ANY /api/v1/control/jobs/view

Gets control jobs.

- Handler: `thisProject\api\control\jobs\View`
- Source: `lib/php/thisProject/api/control/jobs/View.php`
- Delegates to: `lib/php/thisProject/service/control/RestPullJobs.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `job_id` (optional/detected). Job id. Some handlers also accept `id` as an alias.
  - `job_key` (optional/detected). REST pull job key.
- Response: success comment(s): `OK`.
- Notable errors: `[control_rest_pull_jobs/select]`; `job not found`.

### ANY /api/v1/control/processors

Handles control processors.

- Handler: `thisProject\api\control\processors\Select`
- Source: `lib/php/thisProject/api/control/processors/Select.php`
- Delegates to: `lib/php/thisProject/service/control/RawHttpDocumentProcessors.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `process_key` (optional/detected). Processor key.
  - `processor_id` (optional/detected). Raw document processor id.
- Response: success comment(s): `OK`.
- Notable errors: `[control_raw_http_document_processors/select]`; `processor not found`.

### ANY /api/v1/control/processors/update

Updates control processors.

- Handler: `thisProject\api\control\processors\UpdateById`
- Source: `lib/php/thisProject/api/control/processors/UpdateById.php`
- Delegates to: `lib/php/thisProject/service/control/RawHttpDocumentProcessors.php::select`, `lib/php/thisProject/service/control/RawHttpDocumentProcessors.php::updateByID`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `processor_id` (required). Raw document processor id.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `process_key` (optional/detected). Processor key.
- Response: success comment(s): `OK`.
- Notable errors: `Missing processor_id`; `processor $processorId not found`; `[control_raw_http_document_processors/select]`; `processor not found`; `[control_raw_http_document_processors/updateByID]`; `Missing update record`.

### ANY /api/v1/control/processors/view

Gets control processors.

- Handler: `thisProject\api\control\processors\View`
- Source: `lib/php/thisProject/api/control/processors/View.php`
- Delegates to: `lib/php/thisProject/service/control/RawHttpDocumentProcessors.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `process_key` (optional/detected). Processor key.
  - `processor_id` (optional/detected). Raw document processor id.
- Response: success comment(s): `OK`.
- Notable errors: `[control_raw_http_document_processors/select]`; `processor not found`.

### ANY /api/v1/control/runs

Handles control runs.

- Handler: `thisProject\api\control\runs\Select`
- Source: `lib/php/thisProject/api/control/runs/Select.php`
- Delegates to: `lib/php/thisProject/service/control/RestPullRuns.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `job_id` (optional/detected). Job id. Some handlers also accept `id` as an alias.
  - `pull_run_id` (optional/detected). Pull run id.
- Response: success comment(s): `OK`.
- Notable errors: `[control_rest_pull_runs/select]`.

### ANY /api/v1/control/runs/view

Gets control runs.

- Handler: `thisProject\api\control\runs\View`
- Source: `lib/php/thisProject/api/control/runs/View.php`
- Delegates to: `lib/php/thisProject/service/control/RestPullRuns.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `job_id` (optional/detected). Job id. Some handlers also accept `id` as an alias.
  - `pull_run_id` (optional/detected). Pull run id.
- Response: success comment(s): `OK`.
- Notable errors: `[control_rest_pull_runs/select]`.

### ANY /api/v1/endpoints

Handles endpoints.

- Handler: `thisProject\api\endpoints\Select`
- Source: `lib/php/thisProject/api/endpoints/Select.php`
- Delegates to: `lib/php/thisProject/service/control/RestPullEndpoints.php::select`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `endpoint_id` (optional/detected). REST endpoint id.
  - `endpoint_key` (optional/detected). REST endpoint key.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
- Response: success comment(s): `OK`.
- Notable errors: `[control_rest_pull_endpoints/select]`; `endpoint not found`.

### ANY /api/v1/endpoints/view

Gets endpoints.

- Handler: `thisProject\api\endpoints\View`
- Source: `lib/php/thisProject/api/endpoints/View.php`
- Delegates to: `lib/php/thisProject/service/control/RestPullEndpoints.php::select`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `endpoint_id` (optional/detected). REST endpoint id.
  - `endpoint_key` (optional/detected). REST endpoint key.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
- Response: success comment(s): `OK`.
- Notable errors: `[control_rest_pull_endpoints/select]`; `endpoint not found`.

### ANY /api/v1/hello

Handles hello.

- Handler: `thisProject\api\hello\Controller`
- Source: `lib/php/thisProject/api/hello/Controller.php`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields: none in the handler; endpoint may be informational or delegates opaque input.
- Response: success comment(s): `OK`.

### ANY /api/v1/reference/events

Handles reference events.

- Handler: `thisProject\api\reference\events\Select`
- Source: `lib/php/thisProject/api/reference/events/Select.php`
- Delegates to: `lib/php/thisProject/service/reference/Events.php::search`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `count` (optional/detected). Detected in handler or delegated service code.
  - `endDate` (optional/detected). Detected in handler or delegated service code.
  - `endDateAfter` (optional/detected). Detected in handler or delegated service code.
  - `end_date_after` (optional/detected). Detected in handler or delegated service code.
  - `event_id` (optional/detected). Polymarket event id.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `limit` (optional/detected). Page size limit.
  - `offset` (optional/detected). Zero-based pagination offset.
  - `order` (optional/detected). Detected in handler or delegated service code.
  - `startDate` (optional/detected). Detected in handler or delegated service code.
- Response: success comment(s): `OK`.

### ANY /api/v1/reference/events/tags

Handles reference events tags.

- Handler: `thisProject\api\reference\events\tags\Select`
- Source: `lib/php/thisProject/api/reference/events/tags/Select.php`
- Delegates to: `lib/php/thisProject/service/reference/EventTags.php::search`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `linkedAt` (optional/detected). Detected in handler or delegated service code.
- Response: success comment(s): `OK`.

### ANY /api/v1/reference/events/tags/view

Gets reference events tags.

- Handler: `thisProject\api\reference\events\tags\View`
- Source: `lib/php/thisProject/api/reference/events/tags/View.php`
- Delegates to: `lib/php/thisProject/service/reference/EventTags.php::view`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `event_id` (required). Polymarket event id.
  - `tag_id` (required). Polymarket tag id.
- Response: success comment(s): `OK`.
- Notable errors: `Missing event_id or tag_id`; `reference event tag not found`.

### ANY /api/v1/reference/events/view

Gets reference events.

- Handler: `thisProject\api\reference\events\View`
- Source: `lib/php/thisProject/api/reference/events/View.php`
- Delegates to: `lib/php/thisProject/service/reference/Events.php::view`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `event_id` (required). Polymarket event id.
  - `slug` (required). Slug lookup value.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
- Response: success comment(s): `OK`.
- Notable errors: `reference event not found`; `Missing event_id or slug`.

### ANY /api/v1/reference/markets

Handles reference markets.

- Handler: `thisProject\api\reference\markets\Select`
- Source: `lib/php/thisProject/api/reference/markets/Select.php`
- Delegates to: `lib/php/thisProject/service/reference/Markets.php::search`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `count` (optional/detected). Detected in handler or delegated service code.
  - `enableOrderBook` (optional/detected). Detected in handler or delegated service code.
  - `endDate` (optional/detected). Detected in handler or delegated service code.
  - `endDateAfter` (optional/detected). Detected in handler or delegated service code.
  - `end_date_after` (optional/detected). Detected in handler or delegated service code.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `limit` (optional/detected). Page size limit.
  - `market_id` (optional/detected). Polymarket market id.
  - `negRisk` (optional/detected). Detected in handler or delegated service code.
  - `offset` (optional/detected). Zero-based pagination offset.
  - `order` (optional/detected). Detected in handler or delegated service code.
  - `resolutionSource` (optional/detected). Detected in handler or delegated service code.
- Response: success comment(s): `OK`.

### ANY /api/v1/reference/markets/tags

Handles reference markets tags.

- Handler: `thisProject\api\reference\markets\tags\Select`
- Source: `lib/php/thisProject/api/reference/markets/tags/Select.php`
- Delegates to: `lib/php/thisProject/service/reference/MarketTags.php::search`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `linkedAt` (optional/detected). Detected in handler or delegated service code.
- Response: success comment(s): `OK`.

### ANY /api/v1/reference/markets/tags/view

Gets reference markets tags.

- Handler: `thisProject\api\reference\markets\tags\View`
- Source: `lib/php/thisProject/api/reference/markets/tags/View.php`
- Delegates to: `lib/php/thisProject/service/reference/MarketTags.php::view`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `market_id` (required). Polymarket market id.
  - `tag_id` (required). Polymarket tag id.
- Response: success comment(s): `OK`.
- Notable errors: `Missing market_id or tag_id`; `reference market tag not found`.

### ANY /api/v1/reference/markets/tokens

Handles reference markets tokens.

- Handler: `thisProject\api\reference\markets\tokens\Select`
- Source: `lib/php/thisProject/api/reference/markets/tokens/Select.php`
- Delegates to: `lib/php/thisProject/service/reference/MarketTokens.php::search`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `token_id` (optional/detected). Polymarket token id.
- Response: success comment(s): `OK`.

### ANY /api/v1/reference/markets/tokens/view

Gets reference markets tokens.

- Handler: `thisProject\api\reference\markets\tokens\View`
- Source: `lib/php/thisProject/api/reference/markets/tokens/View.php`
- Delegates to: `lib/php/thisProject/service/reference/MarketTokens.php::view`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `token_id` (required). Polymarket token id.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
- Response: success comment(s): `OK`.
- Notable errors: `Missing token_id`.

### ANY /api/v1/reference/markets/view

Gets reference markets.

- Handler: `thisProject\api\reference\markets\View`
- Source: `lib/php/thisProject/api/reference/markets/View.php`
- Delegates to: `lib/php/thisProject/service/reference/Markets.php::view`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `market_id` (required). Polymarket market id.
  - `slug` (required). Slug lookup value.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
- Response: success comment(s): `OK`.
- Notable errors: `reference market not found`; `Missing market_id or slug`.

### ANY /api/v1/reference/series

Handles reference series.

- Handler: `thisProject\api\reference\series\Select`
- Source: `lib/php/thisProject/api/reference/series/Select.php`
- Delegates to: `lib/php/thisProject/service/reference/Series.php::search`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `series_id` (optional/detected). Polymarket series id.
- Response: success comment(s): `OK`.

### ANY /api/v1/reference/series/view

Gets reference series.

- Handler: `thisProject\api\reference\series\View`
- Source: `lib/php/thisProject/api/reference/series/View.php`
- Delegates to: `lib/php/thisProject/service/reference/Series.php::view`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `series_id` (required). Polymarket series id.
  - `slug` (required). Slug lookup value.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
- Response: success comment(s): `OK`.
- Notable errors: `reference series not found`; `Missing series_id or slug`.

### ANY /api/v1/reference/tags

Handles reference tags.

- Handler: `thisProject\api\reference\tags\Select`
- Source: `lib/php/thisProject/api/reference/tags/Select.php`
- Delegates to: `lib/php/thisProject/service/reference/Tags.php::search`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `forceHide` (optional/detected). Detected in handler or delegated service code.
  - `forceShow` (optional/detected). Detected in handler or delegated service code.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `isCarousel` (optional/detected). Detected in handler or delegated service code.
  - `tag_id` (optional/detected). Polymarket tag id.
- Response: success comment(s): `OK`.

### ANY /api/v1/reference/tags/view

Gets reference tags.

- Handler: `thisProject\api\reference\tags\View`
- Source: `lib/php/thisProject/api/reference/tags/View.php`
- Delegates to: `lib/php/thisProject/service/reference/Tags.php::view`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `slug` (required). Slug lookup value.
  - `tag_id` (required). Polymarket tag id.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
- Response: success comment(s): `OK`.
- Notable errors: `reference tag not found`; `Missing tag_id or slug`.

### ANY /api/v2/control/bronze/cursors

Handles control bronze cursors.

- Handler: `thisProject\api\control\bronze\cursors\Select`
- Source: `lib/php/thisProject/api/control/bronze/cursors/Select.php`
- Delegates to: `lib/php/thisProject/service/bronze/SyncCursors.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `cursor_id` (optional/detected). Detected in handler or delegated service code.
  - `endpoint` (optional/detected). Detected in handler or delegated service code.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `source` (optional/detected). Source document/content payload.
- Response: success comment(s): `OK`.
- Notable errors: `[bronze_sync_cursors/select]`; `sync cursor not found`.

### ANY /api/v2/control/bronze/cursors/view

Gets control bronze cursors.

- Handler: `thisProject\api\control\bronze\cursors\View`
- Source: `lib/php/thisProject/api/control/bronze/cursors/View.php`
- Delegates to: `lib/php/thisProject/service/bronze/SyncCursors.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `cursor_id` (optional/detected). Detected in handler or delegated service code.
  - `endpoint` (optional/detected). Detected in handler or delegated service code.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `source` (optional/detected). Source document/content payload.
- Response: success comment(s): `OK`.
- Notable errors: `[bronze_sync_cursors/select]`; `sync cursor not found`.

### ANY /api/v2/control/bronze/http-documents

Handles control bronze http documents.

- Handler: `thisProject\api\control\bronze\httpDocuments\Select`
- Source: `lib/php/thisProject/api/control/bronze/httpDocuments/Select.php`
- Delegates to: `lib/php/thisProject/service/bronze/RawHttpDocuments.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `document_id` (optional/detected). Raw document id.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `request_key` (optional/detected). Request correlation key.
  - `run_id` (optional/detected). Pull/ingestion run id.
- Response: success comment(s): `OK`.
- Notable errors: `[bronze_raw_http_documents/select]`.

### ANY /api/v2/control/bronze/http-documents/view

Gets control bronze http documents.

- Handler: `thisProject\api\control\bronze\httpDocuments\View`
- Source: `lib/php/thisProject/api/control/bronze/httpDocuments/View.php`
- Delegates to: `lib/php/thisProject/service/bronze/RawHttpDocuments.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `document_id` (optional/detected). Raw document id.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `request_key` (optional/detected). Request correlation key.
  - `run_id` (optional/detected). Pull/ingestion run id.
- Response: success comment(s): `OK`.
- Notable errors: `[bronze_raw_http_documents/select]`.

### ANY /api/v2/control/bronze/runs

Handles control bronze runs.

- Handler: `thisProject\api\control\bronze\runs\Select`
- Source: `lib/php/thisProject/api/control/bronze/runs/Select.php`
- Delegates to: `lib/php/thisProject/service/bronze/IngestionRuns.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `run_id` (optional/detected). Pull/ingestion run id.
- Response: success comment(s): `OK`.
- Notable errors: `[bronze_ingestion_runs/select]`.

### ANY /api/v2/control/bronze/runs/view

Gets control bronze runs.

- Handler: `thisProject\api\control\bronze\runs\View`
- Source: `lib/php/thisProject/api/control/bronze/runs/View.php`
- Delegates to: `lib/php/thisProject/service/bronze/IngestionRuns.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `run_id` (optional/detected). Pull/ingestion run id.
- Response: success comment(s): `OK`.
- Notable errors: `[bronze_ingestion_runs/select]`.

### ANY /api/v2/control/endpoints

Handles control endpoints.

- Handler: `thisProject\api\control\endpoints\Select`
- Source: `lib/php/thisProject/api/control/endpoints/Select.php`
- Delegates to: `lib/php/thisProject/service/control/RestPullEndpoints.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `endpoint_id` (optional/detected). REST endpoint id.
  - `endpoint_key` (optional/detected). REST endpoint key.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
- Response: success comment(s): `OK`.
- Notable errors: `[control_rest_pull_endpoints/select]`; `endpoint not found`.

### ANY /api/v2/control/endpoints/update

Updates control endpoints.

- Handler: `thisProject\api\control\endpoints\UpdateById`
- Source: `lib/php/thisProject/api/control/endpoints/UpdateById.php`
- Delegates to: `lib/php/thisProject/service/control/RestPullEndpoints.php::select`, `lib/php/thisProject/service/control/RestPullEndpoints.php::updateByID`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `endpoint_id` (required). REST endpoint id.
  - `endpoint_key` (optional/detected). REST endpoint key.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
- Response: success comment(s): `OK`.
- Notable errors: `Missing endpoint_id`; `endpoint $endpointId not found`; `[control_rest_pull_endpoints/select]`; `endpoint not found`; `[control_rest_pull_endpoints/updateByID]`; `Missing update record`.

### ANY /api/v2/control/endpoints/view

Gets control endpoints.

- Handler: `thisProject\api\control\endpoints\View`
- Source: `lib/php/thisProject/api/control/endpoints/View.php`
- Delegates to: `lib/php/thisProject/service/control/RestPullEndpoints.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `endpoint_id` (optional/detected). REST endpoint id.
  - `endpoint_key` (optional/detected). REST endpoint key.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
- Response: success comment(s): `OK`.
- Notable errors: `[control_rest_pull_endpoints/select]`; `endpoint not found`.

### ANY /api/v2/control/jobs

Handles control jobs.

- Handler: `thisProject\api\control\jobs\Select`
- Source: `lib/php/thisProject/api/control/jobs/Select.php`
- Delegates to: `lib/php/thisProject/service/control/RestPullJobs.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `job_id` (optional/detected). Job id. Some handlers also accept `id` as an alias.
  - `job_key` (optional/detected). REST pull job key.
- Response: success comment(s): `OK`.
- Notable errors: `[control_rest_pull_jobs/select]`; `job not found`.

### ANY /api/v2/control/jobs/run

Runs control jobs.

- Handler: `thisProject\api\control\jobs\Run`
- Source: `lib/php/thisProject/api/control/jobs/Run.php`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields: none in the handler; endpoint may be informational or delegates opaque input.
- Response: success comment(s): `OK`.

### ANY /api/v2/control/jobs/update

Updates control jobs.

- Handler: `thisProject\api\control\jobs\UpdateById`
- Source: `lib/php/thisProject/api/control/jobs/UpdateById.php`
- Delegates to: `lib/php/thisProject/service/control/RestPullJobs.php::select`, `lib/php/thisProject/service/control/RestPullJobs.php::updateByID`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `job_id` (required). Job id. Some handlers also accept `id` as an alias.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `job_key` (optional/detected). REST pull job key.
- Response: success comment(s): `OK`.
- Notable errors: `Missing job_id`; `job $jobId not found`; `[control_rest_pull_jobs/select]`; `job not found`; `[control_rest_pull_jobs/updateByID]`; `Missing update record`.

### ANY /api/v2/control/jobs/view

Gets control jobs.

- Handler: `thisProject\api\control\jobs\View`
- Source: `lib/php/thisProject/api/control/jobs/View.php`
- Delegates to: `lib/php/thisProject/service/control/RestPullJobs.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `job_id` (optional/detected). Job id. Some handlers also accept `id` as an alias.
  - `job_key` (optional/detected). REST pull job key.
- Response: success comment(s): `OK`.
- Notable errors: `[control_rest_pull_jobs/select]`; `job not found`.

### ANY /api/v2/control/processors

Handles control processors.

- Handler: `thisProject\api\control\processors\Select`
- Source: `lib/php/thisProject/api/control/processors/Select.php`
- Delegates to: `lib/php/thisProject/service/control/RawHttpDocumentProcessors.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `process_key` (optional/detected). Processor key.
  - `processor_id` (optional/detected). Raw document processor id.
- Response: success comment(s): `OK`.
- Notable errors: `[control_raw_http_document_processors/select]`; `processor not found`.

### ANY /api/v2/control/processors/update

Updates control processors.

- Handler: `thisProject\api\control\processors\UpdateById`
- Source: `lib/php/thisProject/api/control/processors/UpdateById.php`
- Delegates to: `lib/php/thisProject/service/control/RawHttpDocumentProcessors.php::select`, `lib/php/thisProject/service/control/RawHttpDocumentProcessors.php::updateByID`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `processor_id` (required). Raw document processor id.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `process_key` (optional/detected). Processor key.
- Response: success comment(s): `OK`.
- Notable errors: `Missing processor_id`; `processor $processorId not found`; `[control_raw_http_document_processors/select]`; `processor not found`; `[control_raw_http_document_processors/updateByID]`; `Missing update record`.

### ANY /api/v2/control/processors/view

Gets control processors.

- Handler: `thisProject\api\control\processors\View`
- Source: `lib/php/thisProject/api/control/processors/View.php`
- Delegates to: `lib/php/thisProject/service/control/RawHttpDocumentProcessors.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `process_key` (optional/detected). Processor key.
  - `processor_id` (optional/detected). Raw document processor id.
- Response: success comment(s): `OK`.
- Notable errors: `[control_raw_http_document_processors/select]`; `processor not found`.

### ANY /api/v2/control/runs

Handles control runs.

- Handler: `thisProject\api\control\runs\Select`
- Source: `lib/php/thisProject/api/control/runs/Select.php`
- Delegates to: `lib/php/thisProject/service/control/RestPullRuns.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `job_id` (optional/detected). Job id. Some handlers also accept `id` as an alias.
  - `pull_run_id` (optional/detected). Pull run id.
- Response: success comment(s): `OK`.
- Notable errors: `[control_rest_pull_runs/select]`.

### ANY /api/v2/control/runs/view

Gets control runs.

- Handler: `thisProject\api\control\runs\View`
- Source: `lib/php/thisProject/api/control/runs/View.php`
- Delegates to: `lib/php/thisProject/service/control/RestPullRuns.php::select`
- Auth: validated token required by `api/control/Controller.php`.
- Detected request fields:
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `job_id` (optional/detected). Job id. Some handlers also accept `id` as an alias.
  - `pull_run_id` (optional/detected). Pull run id.
- Response: success comment(s): `OK`.
- Notable errors: `[control_rest_pull_runs/select]`.

### ANY /api/v2/endpoints

Handles endpoints.

- Handler: `thisProject\api\endpoints\Select`
- Source: `lib/php/thisProject/api/endpoints/Select.php`
- Delegates to: `lib/php/thisProject/service/control/RestPullEndpoints.php::select`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `endpoint_id` (optional/detected). REST endpoint id.
  - `endpoint_key` (optional/detected). REST endpoint key.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
- Response: success comment(s): `OK`.
- Notable errors: `[control_rest_pull_endpoints/select]`; `endpoint not found`.

### ANY /api/v2/endpoints/view

Gets endpoints.

- Handler: `thisProject\api\endpoints\View`
- Source: `lib/php/thisProject/api/endpoints/View.php`
- Delegates to: `lib/php/thisProject/service/control/RestPullEndpoints.php::select`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `endpoint_id` (optional/detected). REST endpoint id.
  - `endpoint_key` (optional/detected). REST endpoint key.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
- Response: success comment(s): `OK`.
- Notable errors: `[control_rest_pull_endpoints/select]`; `endpoint not found`.

### ANY /api/v2/hello

Handles hello.

- Handler: `thisProject\api\hello\Controller`
- Source: `lib/php/thisProject/api/hello/Controller.php`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields: none in the handler; endpoint may be informational or delegates opaque input.
- Response: success comment(s): `OK`.

### ANY /api/v2/reference/events

Handles reference events.

- Handler: `thisProject\api\reference\events\Select`
- Source: `lib/php/thisProject/api/reference/events/Select.php`
- Delegates to: `lib/php/thisProject/service/reference/Events.php::search`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `count` (optional/detected). Detected in handler or delegated service code.
  - `endDate` (optional/detected). Detected in handler or delegated service code.
  - `endDateAfter` (optional/detected). Detected in handler or delegated service code.
  - `end_date_after` (optional/detected). Detected in handler or delegated service code.
  - `event_id` (optional/detected). Polymarket event id.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `limit` (optional/detected). Page size limit.
  - `offset` (optional/detected). Zero-based pagination offset.
  - `order` (optional/detected). Detected in handler or delegated service code.
  - `startDate` (optional/detected). Detected in handler or delegated service code.
- Response: success comment(s): `OK`.

### ANY /api/v2/reference/events/tags

Handles reference events tags.

- Handler: `thisProject\api\reference\events\tags\Select`
- Source: `lib/php/thisProject/api/reference/events/tags/Select.php`
- Delegates to: `lib/php/thisProject/service/reference/EventTags.php::search`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `linkedAt` (optional/detected). Detected in handler or delegated service code.
- Response: success comment(s): `OK`.

### ANY /api/v2/reference/events/tags/view

Gets reference events tags.

- Handler: `thisProject\api\reference\events\tags\View`
- Source: `lib/php/thisProject/api/reference/events/tags/View.php`
- Delegates to: `lib/php/thisProject/service/reference/EventTags.php::view`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `event_id` (required). Polymarket event id.
  - `tag_id` (required). Polymarket tag id.
- Response: success comment(s): `OK`.
- Notable errors: `Missing event_id or tag_id`; `reference event tag not found`.

### ANY /api/v2/reference/events/view

Gets reference events.

- Handler: `thisProject\api\reference\events\View`
- Source: `lib/php/thisProject/api/reference/events/View.php`
- Delegates to: `lib/php/thisProject/service/reference/Events.php::view`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `event_id` (required). Polymarket event id.
  - `slug` (required). Slug lookup value.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
- Response: success comment(s): `OK`.
- Notable errors: `reference event not found`; `Missing event_id or slug`.

### ANY /api/v2/reference/markets

Handles reference markets.

- Handler: `thisProject\api\reference\markets\Select`
- Source: `lib/php/thisProject/api/reference/markets/Select.php`
- Delegates to: `lib/php/thisProject/service/reference/Markets.php::search`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `count` (optional/detected). Detected in handler or delegated service code.
  - `enableOrderBook` (optional/detected). Detected in handler or delegated service code.
  - `endDate` (optional/detected). Detected in handler or delegated service code.
  - `endDateAfter` (optional/detected). Detected in handler or delegated service code.
  - `end_date_after` (optional/detected). Detected in handler or delegated service code.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `limit` (optional/detected). Page size limit.
  - `market_id` (optional/detected). Polymarket market id.
  - `negRisk` (optional/detected). Detected in handler or delegated service code.
  - `offset` (optional/detected). Zero-based pagination offset.
  - `order` (optional/detected). Detected in handler or delegated service code.
  - `resolutionSource` (optional/detected). Detected in handler or delegated service code.
- Response: success comment(s): `OK`.

### ANY /api/v2/reference/markets/tags

Handles reference markets tags.

- Handler: `thisProject\api\reference\markets\tags\Select`
- Source: `lib/php/thisProject/api/reference/markets/tags/Select.php`
- Delegates to: `lib/php/thisProject/service/reference/MarketTags.php::search`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `linkedAt` (optional/detected). Detected in handler or delegated service code.
- Response: success comment(s): `OK`.

### ANY /api/v2/reference/markets/tags/view

Gets reference markets tags.

- Handler: `thisProject\api\reference\markets\tags\View`
- Source: `lib/php/thisProject/api/reference/markets/tags/View.php`
- Delegates to: `lib/php/thisProject/service/reference/MarketTags.php::view`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `market_id` (required). Polymarket market id.
  - `tag_id` (required). Polymarket tag id.
- Response: success comment(s): `OK`.
- Notable errors: `Missing market_id or tag_id`; `reference market tag not found`.

### ANY /api/v2/reference/markets/tokens

Handles reference markets tokens.

- Handler: `thisProject\api\reference\markets\tokens\Select`
- Source: `lib/php/thisProject/api/reference/markets/tokens/Select.php`
- Delegates to: `lib/php/thisProject/service/reference/MarketTokens.php::search`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `token_id` (optional/detected). Polymarket token id.
- Response: success comment(s): `OK`.

### ANY /api/v2/reference/markets/tokens/view

Gets reference markets tokens.

- Handler: `thisProject\api\reference\markets\tokens\View`
- Source: `lib/php/thisProject/api/reference/markets/tokens/View.php`
- Delegates to: `lib/php/thisProject/service/reference/MarketTokens.php::view`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `token_id` (required). Polymarket token id.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
- Response: success comment(s): `OK`.
- Notable errors: `Missing token_id`.

### ANY /api/v2/reference/markets/view

Gets reference markets.

- Handler: `thisProject\api\reference\markets\View`
- Source: `lib/php/thisProject/api/reference/markets/View.php`
- Delegates to: `lib/php/thisProject/service/reference/Markets.php::view`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `market_id` (required). Polymarket market id.
  - `slug` (required). Slug lookup value.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
- Response: success comment(s): `OK`.
- Notable errors: `reference market not found`; `Missing market_id or slug`.

### ANY /api/v2/reference/series

Handles reference series.

- Handler: `thisProject\api\reference\series\Select`
- Source: `lib/php/thisProject/api/reference/series/Select.php`
- Delegates to: `lib/php/thisProject/service/reference/Series.php::search`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `series_id` (optional/detected). Polymarket series id.
- Response: success comment(s): `OK`.

### ANY /api/v2/reference/series/view

Gets reference series.

- Handler: `thisProject\api\reference\series\View`
- Source: `lib/php/thisProject/api/reference/series/View.php`
- Delegates to: `lib/php/thisProject/service/reference/Series.php::view`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `series_id` (required). Polymarket series id.
  - `slug` (required). Slug lookup value.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
- Response: success comment(s): `OK`.
- Notable errors: `reference series not found`; `Missing series_id or slug`.

### ANY /api/v2/reference/tags

Handles reference tags.

- Handler: `thisProject\api\reference\tags\Select`
- Source: `lib/php/thisProject/api/reference/tags/Select.php`
- Delegates to: `lib/php/thisProject/service/reference/Tags.php::search`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `forceHide` (optional/detected). Detected in handler or delegated service code.
  - `forceShow` (optional/detected). Detected in handler or delegated service code.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
  - `isCarousel` (optional/detected). Detected in handler or delegated service code.
  - `tag_id` (optional/detected). Polymarket tag id.
- Response: success comment(s): `OK`.

### ANY /api/v2/reference/tags/view

Gets reference tags.

- Handler: `thisProject\api\reference\tags\View`
- Source: `lib/php/thisProject/api/reference/tags/View.php`
- Delegates to: `lib/php/thisProject/service/reference/Tags.php::view`
- Auth: no explicit auth gate detected in route/handler
- Detected request fields:
  - `slug` (required). Slug lookup value.
  - `tag_id` (required). Polymarket tag id.
  - `id` (optional/detected). Record identifier. Many handlers accept this as the primary lookup key.
- Response: success comment(s): `OK`.
- Notable errors: `reference tag not found`; `Missing tag_id or slug`.
