1Forge Finance APIs

Name: 1Forge Finance APIs
Brand: 1Forge Finance APIs
Availability: InStock

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

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.

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 | sh

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 instance

Jentic 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

GET STARTED

Start building with 1Forge Finance APIs

Explore with Jentic

View OpenAPI Document

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 once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'get a live forex quote' or 'convert one currency to another', and Jentic returns the matching 1Forge operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

Time to first call

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 with Jentic One, the self-hosted execution layer.

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.

Can I limit what my agent is allowed to do with the 1Forge Finance APIs?

Yes. Because you run Jentic One yourself, your own rules decide which 1Forge operations and credentials the agent can touch, and it can call only the ones you grant. The 1Forge endpoints carry symbols and amounts in query parameters rather than a resource id in the path, so you scope access at the operation level: for example, allow live quote lookups (/quotes) and currency conversion (/convert) while leaving out the symbol list (/symbols), market status (/market_status), or the quota check (/quota). Any operation you do not add to the allowed set simply cannot run.