Core concepts

Engines, normalization, scoring, and strategies.

Engines (route sources)

Engines fetch candidates. They do not decide “the winner”.

Output-first.

Searches deeper. Optimizes for best output.

Normalized route

All engines return the same route object. This keeps clients provider-agnostic.

For the canonical shape, see Route object schema.

Scoring

Scoring is deterministic. Same inputs produce the same ranking.

Scoring is based on dimensions like output, fees, time, and reliability. See Scoring and strategies for the dimensions and formula.

Strategy

Strategy changes weights only. It does not change engine behavior.

Practical rule:

  • use balanced as a default

  • use safest for large amounts

  • use fastest when time is the primary constraint

circle-info

Avoid mapping “strategy = engine”.

Strategy is a scoring preference. Engines are candidate sources.

Last updated