free (Free), hobby (Basic), indie (Growth), and pro (Pro). The /rates and /v2/crypto collections include plan; individual resources and other operations do not necessarily include it. Access to a rate and access to its metadata are separate decisions.
Fields in /rates and /rates/{id}
change_24h_pct and vs_official_pct can be null when no comparable point exists. fetched_at is in the collection root for every plan; an individual rate includes it from Growth. The conditional omission of stale_after_sec on Venezuelan rates follows V1. These field rules apply to rate responses: GET /v2/fx/convert retains stale and staleness_sec even on Free.
When a Venezuelan rate is restricted, Free sees only { "id": "..." } in the collection; Basic sees id, market, type, name, quote, and available: false; Growth also sees its description, tags, and required_plan. A descriptor contains no price or update time. The individual request returns 402 feature_not_in_plan.
The same rate on each plan
These objects illustrate theco-trm row in GET /v2/fx/CO/rates with the same source data and request instant. Values are illustrative. Free and Basic omit bid and ask when the source does not publish them; Growth and Pro serialize them as null.
Free:
Operations by plan
The
/v2/crypto collection shows descriptors to Free and Basic; an individual rate requires Growth. Basic has the same V2 route permissions as Free but receives the additional fields above and its own retention and limits. History retention is 3 days on Free, 90 on Basic, 180 on Growth, and 365 on Pro; source availability can be shorter. See rate limits for quotas and request speed, shared between V1 and V2.
Countries and markets
Outside Venezuela, all published and approved rates are available from Free. Venezuela keeps its restrictions: PayPal and Zelle from Growth; Syklo, Yadio, Zoom, and Western Union from Growth; cash (ve-cash) and border (ve-cucuta) from Pro.