Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.venlyfinance.com/llms.txt

Use this file to discover all available pages before exploring further.

The Finance API lets you onboard parties, open accounts, assign IBANs, generate blockchain wallets, and execute fiat and crypto transfers through a single RESTful API.

​
Base URLs

EnvironmentURL
Productionhttps://api.venlyfinance.com/v1
Staginghttps://api-staging.venlyfinance.com/v1

​
Authentication

All endpoints require a Bearer token in the Authorization header. Obtain one using OAuth2 client credentials: 
curl -X POST https://login.venly.io/auth/realms/VenlyFinance/protocol/openid-connect/token \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "grant_type=client_credentials" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET"
Then pass the token on every request: 
curl -X POST https://api.venlyfinance.com/v1/parties \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "partyType": "INDIVIDUAL",
    "firstName": "Jane",
    "lastName": "Doe",
    "idempotencyKey": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  }'
Tokens expire after 5 minutes. See the Authentication Guide for token refresh patterns.

​
Idempotency, pagination, versioning

Both APIs follow shared conventions for idempotent retries, list pagination, and version stability. See the API Conventions page for the full rules.

​
Resources

Parties

Onboard individuals and organisations. The foundation of every account.

Accounts

Create and manage financial accounts with role-based party access.

Virtual Bank Accounts

Assign IBANs for EUR SEPA pay-ins linked to accounts.

Wallets

Generate blockchain wallets on Base for crypto settlement.

Transfers

Execute fiat and crypto transfers between accounts.

Account-to-Account Transfers

Move funds directly between accounts within the platform.

Fiat-to-Crypto Payment Sessions

Generate pay-in sessions that convert fiat deposits to crypto.

Payment Requests

Create payment requests for account or card provider integrations.

Permits

Manage EIP-712 permit signatures for token approvals.

Allowances

Query token allowances for wallets.

​
Next Steps

Quick Start

Make your first Finance API call in minutes

Authentication

Token exchange, refresh patterns, and environment URLs

​
Support

Contact support@venly.io or visit venlyfinance.com for help.