Oanda Forex Trading by Apoth3osis

Name: Oanda Forex Trading
Brand: Apoth3osis
SKU: 695bcfa7fd8fabfb3ce3dd6a
Price: 0.02 USD
Availability: InStock

Oanda Forex Trading

Connector

Available ActionsEach successful request consumes credits as outlined below.

get_price^2crget_candles^2crget_account_summary^2crget_positions^2crget_trades^2crget_pending_orders^2crplace_market_order^2crplace_limit_order^2crplace_stop_order^2crmodify_order^2crcancel_order^2crclose_position^2crclose_trade^2cr

Details

OANDA Forex is a comprehensive foreign exchange trading interface that connects AI agents and automation workflows to OANDA's REST v20 API for real-time currency trading and market data access. It provides a simplified action-based abstraction over OANDA's trading platform, supporting both practice accounts for paper trading and live accounts for real money transactions. Market data capabilities include fetching real-time bid and ask prices with spread calculations for single or multiple currency pairs, as well as historical candlestick data across 21 granularities ranging from 5-second intervals to monthly bars with up to 5000 candles per request. Account management functions retrieve balance, margin, net asset value, unrealized and realized profit and loss, open trade counts, and pending order status. The trading engine supports market orders for immediate execution, limit orders for price-targeted entries, and stop orders for breakout or momentum strategies, all with optional take profit and stop loss levels attached at order creation. Position and order management includes viewing open positions and trades, modifying pending order parameters, canceling unfilled orders, and closing positions either by instrument or by individual trade ID. It is highly recommended that you perform extensive testing with demo accounts before placing any live orders.

Use Cases

Forex trading automation, currency trading bot, FX trading API, OANDA API integration, foreign exchange automation, algorithmic forex trading, automated currency trading, forex market data, real-time forex prices, currency pair quotes, bid ask spread, EUR USD trading, GBP JPY trading, forex candlestick data, OHLC data retrieval, historical forex data, forex price history, candlestick charting data, forex account management, trading account balance, margin monitoring, unrealized PnL tracking, open position monitoring, trade management, pending order management, market order execution, limit order placement, stop order trading, take profit automation, stop loss automation, forex risk management, close forex position, close trade by ID, cancel pending order, modify order price, paper trading forex, practice account trading, live forex trading, forex backtesting data, currency pair analysis, forex spread monitoring, multi-currency pricing, forex portfolio tracking, margin available check, forex transaction history, AI forex trading, LLM trading integration, automated FX strategy, forex webhook automation, currency arbitrage data

Credentials

OANDA API Key *

Create a key in your OANDA account settings (choose the one that matches your selected environment).

api key

OANDA Account Number *

Your OANDA account number for the selected environment.

text

Environment *

Choose whether to connect to the practice or live environment.

select

Manage credentials in your dashboard.

Actions(13)

get_price^2cr2 params

Get current bid/ask pricing for one or more currency pairs. Returns bid, ask, spread, timestamp, and tradeability status.

instrumentstring

Single trading instrument/currency pair in OANDA format (e.g., 'EUR_USD', 'GBP_JPY'). Provide instrument or instruments.

instrumentsarray

List of trading instruments for batch pricing (e.g., ['EUR_USD', 'GBP_USD', 'USD_JPY']). Provide instrument or instruments.

Array of: string

get_candles^2cr3 params(2 required)

Get historical candlestick (OHLCV) data for a single instrument across 21 granularities from 5-second to monthly bars.

instrumentrequiredstring

Currency pair in OANDA format (e.g., 'EUR_USD').

granularityrequiredstring

Candle time granularity. Seconds: S5, S10, S15, S30. Minutes: M1, M2, M4, M5, M10, M15, M30. Hours: H1, H2, H3, H4, H6, H8, H12. Other: D (daily), W (weekly), M (monthly).

Values:

S5S10S15S30M1M2M4M5M10M15M30H1H2H3H4H6H8H12DWM

countinteger

Number of candles to retrieve (default: 100, max: 5000).

Default: 100

Range: 1 - 5000

get_account_summary^2cr0 params

Get account overview including balance, margin, NAV, unrealized/realized P&L, and open trade/position/order counts. Credentials provided automatically.

No parameters for this action.

get_positions^2cr0 params

Get all currently open positions with instrument, long/short units, average prices, and unrealized/realized P&L.

No parameters for this action.

get_trades^2cr0 params

Get all currently open trades with trade ID, instrument, units, entry price, unrealized/realized P&L, margin used, and attached order IDs.

No parameters for this action.

get_pending_orders^2cr0 params

Get all pending (unfilled) orders with order ID, type, instrument, units, price, time-in-force, and attached conditions.

No parameters for this action.

place_market_order^2cr5 params(2 required)

Execute a trade immediately at the current market price. Positive units = buy/long, negative units = sell/short.

instrumentrequiredstring

Currency pair (e.g., 'EUR_USD').

unitsrequiredinteger

Number of units to trade. Positive = buy/long, negative = sell/short. Example: 10000 to buy, -5000 to sell.

take_profit_pricenumber

Take profit price level. Automatically creates a take profit order on fill.

stop_loss_pricenumber

Stop loss price level. Cannot be used with stop_loss_distance.

stop_loss_distancenumber

Stop loss as price distance instead of absolute price. Cannot be used with stop_loss_price.

place_limit_order^2cr6 params(3 required)

Place an order to execute when price reaches a specified level or better. Remains active until filled or cancelled (GTC).

instrumentrequiredstring

Currency pair (e.g., 'EUR_USD').

unitsrequiredinteger

Number of units. Positive = buy, negative = sell.

pricerequirednumber

The limit price at which to execute.

take_profit_pricenumber

Take profit price to attach on fill.

stop_loss_pricenumber

Stop loss price to attach on fill. Cannot be used with stop_loss_distance.

stop_loss_distancenumber

Stop loss distance to attach on fill. Cannot be used with stop_loss_price.

place_stop_order^2cr6 params(3 required)

Place an order that triggers when price reaches a specified level. Useful for breakout strategies. Remains active until triggered or cancelled (GTC).

instrumentrequiredstring

Currency pair (e.g., 'USD_JPY').

unitsrequiredinteger

Number of units. Positive = buy, negative = sell.

pricerequirednumber

The trigger price for the stop order.

take_profit_pricenumber

Take profit price to attach on fill.

stop_loss_pricenumber

Stop loss price to attach on fill. Cannot be used with stop_loss_distance.

stop_loss_distancenumber

Stop loss distance to attach on fill. Cannot be used with stop_loss_price.

modify_order^2cr5 params(1 required)

Modify a pending order's price, units, or trailing stop distance. Automatically detects order type and applies appropriate modification.

order_idrequiredstring

The order ID to modify (get from get_pending_orders).

pricenumber

New price level for limit/stop/take-profit/stop-loss orders.

unitsinteger

New unit amount for limit/stop orders.

trailing_stop_distancenumber

New trailing distance for trailing stop loss orders.

stop_loss_distancenumber

New stop loss distance for stop loss orders. Cannot be used with price for stop loss modifications.

cancel_order^2cr1 param(1 required)

Cancel a pending (unfilled) order by its ID.

order_idrequiredstring

The order ID to cancel (get from get_pending_orders).

close_position^2cr1 param(1 required)

Close the entire position (both long and short sides) for a specific instrument. Returns details of closed sides and total P&L.

instrumentrequiredstring

Currency pair to close (e.g., 'EUR_USD').

close_trade^2cr1 param(1 required)

Close a specific individual trade by its ID. Returns closing price, units closed, and realized P&L.

trade_idrequiredstring

The trade ID to close (get from get_trades).

Connect Your Agent In 5 Min

Use hosted MCP first, or install the local STDIO fallback when your client requires a command

Hosted Streamable HTTPS

Use the hosted endpoint directly in clients that support remote MCP. Store your Bearer token in the client config or secret field.

Endpoint: https://api.agentpmt.com/mcp
Authorization: Bearer <AGENTPMT_BEARER_TOKEN>

Full connection guide

Local STDIO Fallback

Use the local router for Claude Code, Codex, Cursor, Zed, and other clients that require a command-based MCP server. The router forwards requests to the hosted endpoint and does not execute tools locally.

npm install -g @agentpmt/mcp-routeragentpmt-setup

curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ********" \
  -d '{
    "product_id": "695bcfa7fd8fabfb3ce3dd6a",
    "parameters": {
      "action": "get_price"
    }
  }'

import requests
import json

url = "https://api.agentpmt.com/products/purchase"

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ********"
}

data = {
    "product_id": "695bcfa7fd8fabfb3ce3dd6a",
    "parameters": {
        "action": "get_price"
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.status_code)
print(response.json())

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "695bcfa7fd8fabfb3ce3dd6a",
  parameters: {
    "action": "get_price"
  }
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(data)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

const axios = require('axios');

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "695bcfa7fd8fabfb3ce3dd6a",
  parameters: {
    "action": "get_price"
  }
};

axios.post(url, data, { headers })
  .then(response => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch(error => {
    console.error("Error:", error.message);
  });

Login to view your API and budget keys. The example above uses placeholder values. Sign in to see personalized code with your bearer token.

Usage Instructions

Usage guidance provided directly by the developer for this product.

Oanda Forex Trading - Tool Instructions

Overview

Trade forex currencies and access real-time market data through the OANDA platform. This tool supports live and practice trading environments, covering market data retrieval, account management, order placement, and position/trade management. Credentials are provided automatically when connected.

Instrument Format

Currency pairs use underscore-separated format: EUR_USD, GBP_JPY, USD_CAD, AUD_NZD, etc.

Actions

get_price

Get current bid/ask pricing for one or more currency pairs.

Required fields (at least one):

instrument (string) - Single currency pair, e.g. EUR_USD
instruments (array of strings) - Multiple currency pairs for batch pricing

Returns bid, ask, spread, timestamp, and whether the instrument is currently tradeable.

Example:

{
  "action": "get_price",
  "instruments": ["EUR_USD", "GBP_USD", "USD_JPY"]
}

get_candles

Get historical candlestick (OHLCV) data for a single instrument.

Required fields:

instrument (string) - Currency pair, e.g. EUR_USD
granularity (string) - Time interval per candle. Options: S5, S10, S15, S30 (seconds), M1, M2, M4, M5, M10, M15, M30 (minutes), H1, H2, H3, H4, H6, H8, H12 (hours), D (daily), W (weekly), M (monthly)

Optional fields:

count (integer) - Number of candles to retrieve. Default: 100. Range: 1-5000.

Returns open, high, low, close, volume, and timestamp for each candle.

Example:

{
  "action": "get_candles",
  "instrument": "EUR_USD",
  "granularity": "H1",
  "count": 50
}

get_account_summary

Get account overview including balance, margin, and profit/loss information.

Required fields: None (credentials are provided automatically).

Returns balance, NAV, unrealized P&L, realized P&L, margin used, margin available, open trade count, open position count, and pending order count.

Example:

{
  "action": "get_account_summary"
}

get_positions

Get all currently open positions.

Required fields: None.

Returns a list of open positions with instrument, long/short units, average prices, and unrealized/realized P&L for each side.

Example:

{
  "action": "get_positions"
}

get_trades

Get all currently open trades with details.

Required fields: None.

Returns trade ID, instrument, units, entry price, unrealized/realized P&L, margin used, open time, and any attached take-profit or stop-loss order IDs.

Example:

{
  "action": "get_trades"
}

get_pending_orders

Get all pending (unfilled) orders.

Required fields: None.

Returns order ID, type, instrument, units, price, time-in-force, and any attached take-profit or stop-loss conditions.

Example:

{
  "action": "get_pending_orders"
}

place_market_order

Execute a trade immediately at the current market price.

Required fields:

instrument (string) - Currency pair, e.g. EUR_USD
units (integer) - Number of units. Positive = buy/long, negative = sell/short. Example: 10000 to buy, -5000 to sell.

Optional fields:

take_profit_price (number) - Automatically attach a take-profit order at this price
stop_loss_price (number) - Automatically attach a stop-loss order at this price
stop_loss_distance (number) - Stop loss as a price distance instead of absolute price (cannot use both stop_loss_price and stop_loss_distance)

Example - Buy with risk management:

{
  "action": "place_market_order",
  "instrument": "EUR_USD",
  "units": 10000,
  "take_profit_price": 1.0950,
  "stop_loss_price": 1.0850
}

Example - Sell (short):

{
  "action": "place_market_order",
  "instrument": "GBP_USD",
  "units": -5000
}

place_limit_order

Place an order to execute when the price reaches a specified level or better. The order remains active until filled or cancelled.

Required fields:

instrument (string) - Currency pair
units (integer) - Positive = buy, negative = sell
price (number) - The limit price at which to execute

Optional fields:

take_profit_price (number) - Take-profit price to attach on fill
stop_loss_price (number) - Stop-loss price to attach on fill
stop_loss_distance (number) - Stop-loss distance to attach on fill

Example:

{
  "action": "place_limit_order",
  "instrument": "EUR_USD",
  "units": 10000,
  "price": 1.0800,
  "take_profit_price": 1.0900,
  "stop_loss_price": 1.0750
}

place_stop_order

Place an order that triggers when the price reaches a specified level. Useful for breakout strategies. The order remains active until triggered or cancelled.

Required fields:

instrument (string) - Currency pair
units (integer) - Positive = buy, negative = sell
price (number) - The trigger price

Optional fields:

take_profit_price (number) - Take-profit price to attach on fill
stop_loss_price (number) - Stop-loss price to attach on fill
stop_loss_distance (number) - Stop-loss distance to attach on fill

Example:

{
  "action": "place_stop_order",
  "instrument": "USD_JPY",
  "units": 5000,
  "price": 150.50,
  "stop_loss_distance": 0.50
}

modify_order

Modify the price, units, or trailing stop distance of an existing pending order. The tool automatically detects the order type and applies the appropriate modification.

Required fields:

order_id (string) - The order ID to modify (get from get_pending_orders)

Optional fields (at least one required for limit/stop/market-if-touched orders):

price (number) - New price level
units (integer) - New unit amount

For trailing stop loss orders:

trailing_stop_distance (number) - New trailing distance (required)

For stop loss orders:

price (number) - New stop loss price, OR
stop_loss_distance (number) - New stop loss distance

Example:

{
  "action": "modify_order",
  "order_id": "12345",
  "price": 1.0825
}

cancel_order

Cancel a pending order.

Required fields:

order_id (string) - The order ID to cancel (get from get_pending_orders)

Example:

{
  "action": "cancel_order",
  "order_id": "12345"
}

close_position

Close the entire position (both long and short sides) for a specific instrument.

Required fields:

instrument (string) - Currency pair to close, e.g. EUR_USD

Returns details of closed long/short sides and total profit/loss.

Example:

{
  "action": "close_position",
  "instrument": "EUR_USD"
}

close_trade

Close a specific individual trade by its ID.

Required fields:

trade_id (string) - The trade ID to close (get from get_trades)

Returns the closing price, units closed, and realized profit/loss.

Example:

{
  "action": "close_trade",
  "trade_id": "67890"
}

Common Workflows

Check prices then trade:

get_price to see current bid/ask for your target pair
place_market_order to enter at market, or place_limit_order to set a target entry

Monitor and manage positions:

get_account_summary to check overall account health
get_positions to see all open positions
get_trades to see individual trade details and IDs
close_trade or close_position to exit

Manage pending orders:

get_pending_orders to list all unfilled orders
modify_order to adjust price or size
cancel_order to remove an order

Technical analysis:

get_candles with desired granularity and count to pull historical OHLCV data
Analyze trends, support/resistance, or other patterns

Important Notes

Units direction: Positive units = buy/long, negative units = sell/short
Stop loss options: Use either stop_loss_price (absolute price) or stop_loss_distance (relative distance), never both
Practice vs Live: The environment is configured through your connected credentials. Practice uses simulated funds; live uses real money.
Market hours: Forex markets are open 24/5 (Sunday evening to Friday evening UTC). Prices may not be tradeable outside these hours.
Order persistence: Limit and stop orders use Good-Til-Cancelled (GTC) by default and remain active until filled or manually cancelled.
Price values: All prices must be positive numbers.

Frequently Asked Questions

How do I connect this tool to an external agent?

You can install the local MCP server by opening a terminal and running:

Install commands

npm install -g @agentpmt/mcp-router
agentpmt-setup

This will connect you to local agents like Claude Code, Windsurf, Grok Build, Cursor, etc.

Alternatively you can connect to the hosted version with this config block, no installation required:

Hosted MCP config

{
  "mcpServers": {
    "agentpmt": {
      "type": "streamable-http",
      "url": "https://api.agentpmt.com/mcp",
      "headers": {
        "Authorization": "Bearer <AGENTPMT_BEARER_TOKEN>",
        "x-instance-metadata": "{\"client\":\"generic-mcp\",\"platform\":\"remote\"}"
      }
    }
  }
}

View MCP Connection Instructions for more details.

How does an external agent use this tool?

After the external agent is connected to an Agent Group that can use this tool, paste this prompt into the agent:

Agent prompt

Call the AgentPMT-Tool-Search-and-Execution tool with action 'get_schema' and tool_id 695bcfa7fd8fabfb3ce3dd6a ("Oanda Forex Trading"). Then call the same tool with action 'call_tool', tool_id 695bcfa7fd8fabfb3ce3dd6a, and the parameters needed for my request.

The agent should fetch the tool schema first, collect the required parameters for your request, and then call the tool through AgentPMT.

Oanda Forex Trading

Available ActionsEach successful request consumes credits as outlined below.

Details

Use Cases

Credentials

Actions(13)

Connect Your Agent In 5 Min

Hosted Streamable HTTPS

Local STDIO Fallback

Credit-Based Access Using AgentAddress

Direct x402 Payment

Usage Instructions

Oanda Forex Trading - Tool Instructions

Overview

Instrument Format

Actions

get_price

get_candles

get_account_summary

get_positions

get_trades

get_pending_orders

place_market_order

place_limit_order

place_stop_order

modify_order

cancel_order

close_position

close_trade

Common Workflows

Important Notes

Frequently Asked Questions

How do I connect this tool to an external agent?

How does an external agent use this tool?

Looking for help integrating AI into your business? Set up a free consultation.