Logo
Rotation Engine

Rotators

Create rotators from saved pools or inline proxies and choose a selection strategy.

Rotators define which proxy sources are available and how the runtime should choose between them.

Rotation Engine Rotators

Rotator Fields

FieldMeaning
NameHuman-readable rotator name.
NotesContext for the source list or use case.
TagsLabels such as rotation, pool, checked, or fallback.
SourcesSaved pools or inline proxy lists.
Selection strategyRound robin, random, or least recently used.
PolicyRuntime behavior attached to the rotator.

Source Types

SourceUse when
Saved poolYou want durable, reusable, tagged source material.
Inline proxiesYou need a quick temporary source that does not belong in a pool yet.

Complete Rotator Definition Fields

FieldDetail
IDStable local rotator identifier.
NameHuman-readable label in lists and runtime snapshots.
NotesContext for source quality, target use, or operational intent.
TagsLabels such as rotation, checked, pool, fallback, or country hints.
SourcesPool-backed sources and inline direct proxy list sources.
Selection strategyRound robin, random, or least recently used.
Policy IDPolicy that controls sessions, health, fallback, and penalties.
TimestampsCreated and updated timestamps for workspace memory.

Legacy primary/fallback pool fields are migrated into source records, and source IDs/names are normalized.

Selection Strategies

StrategyBehavior
Round robinWalk through available proxies in order.
RandomChoose available proxies randomly.
Least recently usedPrefer proxies that have waited longest since last selection.

Source Quality

A rotator can only be as good as its sources. Use pools that have been:

  • checked
  • benchmarked
  • leak-tested when needed
  • cleaned of repeated failures

Use pool sources for long-lived rotators. Inline sources are better for tests or temporary experiments.

On this page