1Forge Finance APIs
★ Only Publicly Available OpenAPI DocumentFinanceBankingapiKey5 EndpointsREST
For Agents
Fetch real-time forex and crypto quotes, convert amounts between currencies, and check forex market status using a single API key.
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. 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.
Install Jentic One Beta
Connect the 1Forge Finance APIs to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the 1Forge Finance APIs, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with 1Forge Finance APIs.
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
Inspect remaining API quota and reset window to avoid hitting rate caps
Use Cases
Patterns agents use 1Forge Finance APIs 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
Key Endpoints
5 endpoints — jentic publishes the only available openapi specification for 1forge finance apis, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
GET
/quotes
Get real-time bid, ask, and mid prices for one or more currency pairs
GET
/convert
Convert a specific amount between two currencies at the live rate
GET
/symbols
List every currency pair symbol available for quoting
GET
/market_status
Check whether the forex market is currently open
GET
/quota
Inspect API key quota usage and remaining call budget
GET
/quotes
Get real-time bid, ask, and mid prices for one or more currency pairs
GET
/convert
Convert a specific amount between two currencies at the live rate
GET
/symbols
List every currency pair symbol available for quoting
GET
/market_status
Check whether the forex market is currently open
GET
/quota
Inspect API key quota usage and remaining call budget
Why Jentic?
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.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using 1Forge Finance APIs 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.
GET STARTED