For Agents
Fetch real-time forex and crypto quotes, convert amounts between currencies, and check forex market status using a single API key.
Get started with 1Forge Finance APIs in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"get a live forex quote"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with 1Forge Finance APIs API.
Retrieve live bid, ask, and mid-market prices for forex and crypto currency pairs
Convert a specific amount between any two supported currencies at the current rate
List every currency pair symbol available for real-time quoting
Check whether the forex market is currently open before triggering trading logic
GET STARTED
Use for: Get the current EUR/USD exchange rate, Convert 250 GBP to JPY at the live rate, Check whether the forex market is open right now, Retrieve real-time bid and ask prices for BTCUSD
Not supported: Does not handle order execution, brokerage accounts, historical time-series, or technical indicators — use for live forex and crypto quote lookups and currency conversion only.
Jentic publishes the only available OpenAPI specification for 1Forge Finance APIs, keeping it validated and agent-ready.
Jentic publishes the only available OpenAPI specification for 1Forge Finance APIs, keeping it validated and agent-ready. 1Forge provides real-time forex and cryptocurrency market data through a small set of focused endpoints covering live quotes, currency conversion, supported symbol lists, and forex market status. Agents can pull bid/ask/mid prices for currency pairs such as EUR/USD or BTCUSD, convert specific amounts between currencies on demand, and check whether the forex market is currently open before placing logic. The API is designed for low-friction integration: a single API key authenticates all requests and responses are flat JSON objects.
Inspect remaining API quota and reset window to avoid hitting rate caps
Patterns agents use 1Forge Finance APIs API for, with concrete tasks.
★ Live Forex Pricing for Trading Dashboards
Power a dashboard or trading bot with live bid, ask, and mid-market prices for major forex pairs. The /quotes endpoint accepts a comma-separated list of pairs and returns timestamped quotes in a single round trip, so agents can refresh dozens of pairs without orchestrating multiple calls. Pair this with /market_status to suppress trading actions outside market hours.
Fetch real-time quotes for EURUSD, GBPJPY, and AUDUSD, then check market status and only act if market_is_open is true
On-Demand Currency Conversion
Convert specific amounts between currencies using live rates rather than precomputed daily rates. The /convert endpoint takes from, to, and quantity parameters and returns the exact converted value plus a human-readable text string. This suits checkout, invoicing, and expense-report flows where the user enters an amount and needs an immediate up-to-date result.
Convert 1500 USD to EUR using /convert and return both the numeric value and the human-readable result string
Crypto Quote Lookups
Retrieve live cryptocurrency quotes alongside fiat forex pairs from the same endpoint. 1Forge exposes pairs such as BTCUSD through the standard /symbols and /quotes flow, so an agent can use one client and one auth scheme to cover both asset classes. Useful for portfolio summaries that mix fiat balances and crypto holdings.
Call /symbols, filter for pairs ending in BTCUSD or ETHUSD, then fetch their current quotes via /quotes
Quota-Aware Polling
Avoid plan overruns by checking the /quota endpoint before scheduling polling loops. The response includes quota_used, quota_limit, quota_remaining, and hours_until_reset, so an agent can dynamically adjust poll frequency or pause non-critical refreshes when the remaining budget is low.
Read /quota, compute the safe polling interval as hours_until_reset divided by quota_remaining, and configure the next refresh cycle accordingly
AI Agent Integration via Jentic
An AI agent can ask Jentic for forex pricing operations and Jentic returns the matching 1Forge endpoints with their input schemas. The agent never sees the raw API key — Jentic injects it from the vault at execution time. This lets an agent answer questions like "what is 1000 GBP in JPY right now?" without any per-vendor SDK or credential plumbing.
Use Jentic to search for 'get a live forex quote', load the /quotes operation schema, and execute it for EURUSD
5 endpoints — jentic publishes the only available openapi specification for 1forge finance apis, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/quotes
Get real-time bid, ask, and mid prices for one or more currency pairs
/convert
Convert a specific amount between two currencies at the live rate
/symbols
List every currency pair symbol available for quoting
/market_status
Check whether the forex market is currently open
/quota
Inspect API key quota usage and remaining call budget
/quotes
Get real-time bid, ask, and mid prices for one or more currency pairs
/convert
Convert a specific amount between two currencies at the live rate
/symbols
List every currency pair symbol available for quoting
/market_status
Check whether the forex market is currently open
/quota
Inspect API key quota usage and remaining call budget
Three things that make agents converge on Jentic-routed access.
Credential isolation
Your 1Forge api_key is stored encrypted in the Jentic vault and injected as the api_key query parameter at execution time. The agent receives a scoped session token — the raw API key never enters the prompt or tool-call arguments.
Intent-based discovery
Agents search by intent (e.g. 'convert currency' or 'get a live forex quote') and Jentic returns the matching 1Forge operation with its full input schema, so the agent can call /convert or /quotes correctly without reading vendor docs.
Time to first call
Direct 1Forge integration: half a day for HTTP client, key handling, and quota-aware polling. Through Jentic: under 15 minutes — search, load, execute.
Alternatives and complements available in the Jentic catalogue.
CurrencyAPI
Forex and crypto exchange rate API with historical data support
Choose CurrencyAPI when you need historical exchange rate time series, which 1Forge does not expose.
ExchangeRate-API
Simple fiat exchange rate API with a generous free tier
Choose ExchangeRate-API for fiat-only conversion when crypto pairs and intraday tick precision are not required.
Alpha Vantage
Equities, forex, and crypto data including technical indicators and historical bars
Use Alpha Vantage alongside 1Forge when you also need equities data, technical indicators, or historical OHLC bars beyond live quotes.
Finnhub
Market data API covering stocks, forex, crypto, and company fundamentals
Pair Finnhub with 1Forge when an agent needs company fundamentals, news, or earnings data alongside live forex quotes.
Polygon.io
High-resolution market data for stocks, options, forex, and crypto
Choose Polygon.io when an agent needs tick-level forex or crypto data and websocket streaming, which 1Forge's REST endpoints do not provide.
Specific to using 1Forge Finance APIs API through Jentic.
Why is there no official OpenAPI spec for 1Forge Finance APIs?
1Forge does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call 1Forge Finance APIs via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the 1Forge Finance APIs use?
1Forge uses an API key passed as the api_key query parameter on every request — this is the only security scheme defined in the spec. Through Jentic the key is stored encrypted in the vault and injected at execution time, so the agent's prompt context never contains the raw key.
Can I get live cryptocurrency prices with the 1Forge Finance APIs?
Yes. /symbols returns crypto pairs such as BTCUSD alongside fiat forex pairs, and /quotes accepts those crypto symbols in the pairs parameter to return bid, ask, mid price, and a Unix timestamp — the same shape as fiat quotes.
How do I convert a specific amount between two currencies?
Call GET /convert with from, to, and quantity query parameters (for example from=USD&to=EUR&quantity=1500). The response contains a numeric value field plus a text field with a human-readable conversion string. Through Jentic, search for 'convert currency' and the /convert operation will be returned with its full input schema.
What are the rate limits for the 1Forge Finance APIs?
The spec does not encode plan-specific rate limits, but the /quota endpoint returns quota_used, quota_limit, quota_remaining, and hours_until_reset for the current API key. Call it at the start of a session to size your polling loop and avoid cutoffs.
How do I check if the forex market is open before trading?
Call GET /market_status. The response contains a single market_is_open boolean. Agents typically chain this before /quotes-driven decisioning so trading logic short-circuits cleanly outside market hours instead of acting on stale weekend prices.
How do I call the 1Forge Finance APIs from an AI agent through Jentic?
Install the SDK with pip install jentic, then use the async pattern: client.search(SearchRequest(query='get a live forex quote')) to discover the /quotes operation, client.load(LoadRequest(...)) to fetch its schema, and client.execute(ExecutionRequest(...)) to run it. Jentic handles the api_key injection from your vaulted credential.