Oanda Forex Trading

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

Connect Your Agent In 5 Min

Watch the setup guide for your platform

Or Install Locally

STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections. This lightweight connector routes requests to https://api.agentpmt.com/mcp. All tool execution happens in the cloud and the server cannot edit any files on your computer.

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.

This tool supports credit-based access for external agents using AgentAddress identities or standard crypto wallets. External agents should use the External Agent API to buy credits with x402 and invoke this tool.

1. Buy Credits

Purchase credits via x402 payment (500 credit minimum, 100 credits = $1).

# Request payment requirements (returns 402 + PAYMENT-REQUIRED header)
curl -i -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

# Sign the EIP-3009 authorization, then retry with signature header
curl -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -H "PAYMENT-SIGNATURE: <base64-json>" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

2. Create a Session Nonce (nonce used in signed balance/invoke)

curl -s -X POST "https://www.agentpmt.com/api/external/auth/session" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET" }'

3. Invoke This Tool

Sign the message with your wallet (EIP-191 personal-sign), then POST to the invoke endpoint.

# Sign this message (wallet MUST be lowercased):
# agentpmt-external
# wallet:0xyourwallet...
# session:<session_nonce>
# request:<request_id>
# action:invoke
# product:695bcfa7fd8fabfb3ce3dd6a
# payload:<sha256(canonical_json(parameters))>

curl -s -X POST "https://www.agentpmt.com/api/external/tools/695bcfa7fd8fabfb3ce3dd6a/invoke" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_address": "0xYOUR_WALLET",
    "session_nonce": "<session_nonce>",
    "request_id": "invoke-uuid",
    "signature": "0x<signature>",
    "parameters": {
      "action": "your_action",
      "your_param": "value"
    }
  }'

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).

Usage Instructions

Usage guidance provided directly by the developer for this product.

Oanda Forex Trading - Tool Instructions

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

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.

About The Developer

Apoth3osis

★15 stars

Joined Agent Payment: August 14, 2025

We build tools that enable AI agents to excel in the mathematical realm.

Our small team develops experimental and unique solutions in the AI arena, with a strong focus on modular computing for agentic applications and custom model deployment. We have handled projects for a variety of applications across many sectors, from algorithmic trading and financial analysis, to molecular simulations and predictions, to habitat and biodiversity monitoring and wildlife conservation.

Oanda Forex Trading

Description