Bity Exchange API

Name: Bity Exchange API API
Brand: Bity Exchange
Availability: InStock

★ Only Publicly Available OpenAPI DocumentFinanceBankingoauth214 EndpointsREST

For Agents

Get crypto-fiat exchange quotes, place orders, and track fills on Bity's Swiss crypto exchange.

Connect the Bity Exchange API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Bity Exchange API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Install Jentic One Beta (Self-Hosted)

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

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 Bity Exchange API API.

List supported currencies for crypto and fiat pairs

Estimate a single order to retrieve the indicative rate before committing

Estimate multiple orders in a batch for portfolio-style pricing

Place an order to convert between crypto and fiat assets

GET STARTED

Start building with Bity Exchange API API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI document for Bity Exchange API, keeping it validated and agent-ready.

Bity Exchange is a Swiss crypto-fiat exchange API for getting quotes, placing orders, and tracking the lifecycle of crypto-to-fiat and fiat-to-crypto trades. The spec covers currency lookups, single and multiple order estimates, order creation and cancellation, and bank-transfer QR-bill generation for Swiss settlement. Agents use it to obtain pricing, execute orders, and reconcile bank transfers in CHF, EUR, and supported crypto pairs.

Use Cases

Patterns agents use Bity Exchange API API for, with concrete tasks.

★ Crypto-to-fiat off-ramp

A treasury agent moves crypto into a Swiss bank account by placing a sell order on Bity. The agent estimates the order, creates it, and then monitors the order status until the fiat leg settles to the recipient bank account, all without manually using the Bity web app.

Estimate selling 0.5 BTC to CHF via /orders/estimate, create the order via POST /orders with the bank-account payout details, then poll /orders/{order_uuid} until status is 'executed'.

Fiat-to-crypto on-ramp with QR-bill

A retail agent helps a Swiss customer buy crypto by placing a fiat-to-crypto order and returning the Swiss QR-bill. The customer scans the QR-bill in their banking app, the bank transfer arrives at Bity, and Bity executes the conversion to the customer's crypto wallet.

Create an order to buy 0.1 BTC with CHF on Bity, then call /orders/{order_uuid}/bank_transfer_qr_bill to retrieve the QR-bill payload for the customer.

Multi-pair quote dashboard

A trading dashboard wants live quotes across several pairs at once. The integration agent calls /orders/estimate/multiple with a batch of pairs and amounts, then renders the indicative rates side by side for the user — much faster than calling the single-estimate endpoint per pair.

Call POST /orders/estimate/multiple with a batch of three pairs (BTC/CHF, ETH/CHF, BTC/EUR) and 1-unit input amounts, then return the rates as a table.

AI agent crypto desk via Jentic

A treasury AI assistant integrated through Jentic accepts natural-language instructions like 'sell 0.2 BTC into CHF when the rate is above 60k' and converts them into Bity estimate plus order calls. Jentic isolates the OAuth tokens so the assistant never holds the raw client credentials.

Use Jentic to search for 'estimate a bity crypto order', load the operation, and return an estimate for selling 0.2 BTC into CHF.

Key Endpoints

14 endpoints — bity exchange is a swiss crypto-fiat exchange api for getting quotes, placing orders, and tracking the lifecycle of crypto-to-fiat and fiat-to-crypto trades.

METHOD

PATH

DESCRIPTION

GET

/currencies

List supported currencies

GET

/currencies/{currency_code}

Retrieve a single currency

POST

/orders/estimate

Estimate a single order

POST

/orders/estimate/multiple

Estimate multiple orders in a batch

POST

/orders

Create an order

GET

/orders/{order_uuid}

Retrieve a specific order

GET

/orders/{order_uuid}/bank_transfer_qr_bill

Generate a Swiss QR-bill for an order

POST

/orders/{order_uuid}/cancel

Cancel a placed order

GET

/currencies

List supported currencies

GET

/currencies/{currency_code}

Retrieve a single currency

POST

/orders/estimate

Estimate a single order

POST

/orders/estimate/multiple

Estimate multiple orders in a batch

POST

/orders

Create an order

Why though Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

Bity OAuth client credentials are stored encrypted in the Jentic vault (MAXsystem). Agents receive scoped tokens at execution time — raw client secrets never enter the agent's context or transcripts.

Intent-based discovery

Agents search by intent (e.g., 'estimate a crypto order' or 'place a Bity trade') and Jentic returns the matching Bity operation with its input schema, so the agent calls the right endpoint without spec browsing.

Time to first call

Direct Bity integration: 2-3 days for OAuth wiring, estimate-then-create flow, and QR-bill handling. Through Jentic: under 1 hour — search, load schema, execute.

Related APIs

Alternatives and complements available in the Jentic catalogue.

Alternative

Kraken

Global crypto exchange with deep order books and broad pair coverage

Choose Kraken when the use case needs a wider set of pairs and deeper liquidity than Bity's Swiss-focused offering.

Alternative

Binance

World's largest crypto exchange by volume with extensive pair coverage

Choose Binance when you need maximum liquidity and pair diversity, accepting that it does not natively settle to Swiss banks like Bity does.

Alternative

Bitstamp

European crypto exchange with EUR pairs and bank settlement

Choose Bitstamp when EUR settlement is the priority and Swiss QR-bill payment is not required.

Complementary

CoinMarketCap

Provides market data and reference prices for sanity-checking exchange quotes

Use CoinMarketCap alongside Bity when an agent needs to compare a Bity estimate to a market reference price before committing an order.

FAQs

Specific to using Bity Exchange API API through Jentic.

What authentication does the Bity Exchange API use?

Bity uses OAuth 2.0 with three flows in the spec: bity_account_client_oauth, bity_account_oauth, and client_oauth. Through Jentic, OAuth tokens are stored encrypted in the MAXsystem vault and exchanged for scoped credentials at call time, so the raw client secret never reaches the agent.

Can I get a price estimate before placing an order on Bity?

Yes. POST /orders/estimate returns a quote for a single pair, and POST /orders/estimate/multiple returns quotes for a batch in one call. Use these before calling POST /orders to commit a trade.

How do I generate a Swiss QR-bill for a Bity order?

Once an order is created, call GET /orders/{order_uuid}/bank_transfer_qr_bill to retrieve the QR-bill payload. The customer can then scan it in any Swiss banking app to send the fiat leg of the transfer.

What are the rate limits for the Bity Exchange API?

The OpenAPI spec does not publish explicit rate limits. Bity enforces per-client throttling at the gateway, so agents should handle 429 responses with backoff and respect any Retry-After header returned.

How do I place a crypto-fiat order through Jentic?

Run pip install jentic, search for 'place a bity exchange order', load the POST /orders operation, and execute it with the input and output currencies and amount. Jentic supplies the input schema so the agent can place the order without spec browsing.

Can I cancel a Bity order after creating it?

Yes, while it is still cancellable. POST /orders/{order_uuid}/cancel cancels the order before the fiat leg settles. Once funds have moved, cancellation is no longer possible.