Back to catalog

Oanda · Markets

OANDA / Instrument candles

Historical OHLC candles for one instrument: open, high, low, close, volume and completeness per candle. Choose size, price components and a count (max 5000) or a from and to range. Runs on your own OANDA fxTrade (live) personal access token and OANDA bills nothing for reads. Live host only (api-fxtrade.oanda.com); a practice token does not work here. OANDA's API licence is for the account holder's own use, so only call this with your own token.

Live data

You are looking at the live public catalog.

unverifiedRequest shape unavailableUnverified
Published API evidence
Public metadata only. Response bodies, credentials, and internal review notes are never displayed.

No verification date is claimed. No response capture is claimed.

Request parameters

  • alignmentTimezone query · optional

    Timezone for dailyAlignment, default America/New_York.

  • count query · optional

    Number of candles, default 500. Leave out when from and to are both given.

  • dailyAlignment query · optional

    Hour that starts a daily candle, default 17.

  • from query · optional

    Start time, RFC 3339 or Unix seconds.

  • granularity query · optional

    Candle size: seconds (S), minutes (M1 to M30), hours (H), D day, W week, M month. Default S5.

  • includeFirst query · optional

    Include the candle covering the from time. Default true.

  • price query · optional

    Price components: M mid, B bid, A ask, any combination, e.g. M or BA. Default M.

  • smooth query · optional

    true opens each candle at the previous close.

  • to query · optional

    End time, RFC 3339 or Unix seconds.

  • weeklyAlignment query · optional

    Weekday that starts a weekly candle, default Friday.

No allowlisted official documentation or pricing reference is available.

Sign in to run this operation, inspect live eligibility, and see governed execution and audit evidence. Sign in.