Finance API - Venly Finance

The Finance API lets you onboard and verify parties, open accounts, assign bank deposit rails, generate blockchain wallets, and move money in both directions — fiat in, fiat out, and crypto transfers — through a single RESTful API.

Base URLs

Environment	URL
Production	`https://api.venlyfinance.com/v1`
Staging	`https://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"
  }'

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.

Data model

Every Finance API resource hangs off a party. Parties hold accounts; accounts hold wallets, virtual bank accounts, and pay-out routes. Wallets are the crypto entry point, virtual bank accounts bring fiat in, and pay-out routes send fiat back out. New here? Start with Getting started for the party → account → verification → bank rails flow, read the data model in depth, or follow the full Integration Walkthrough.

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 bank deposit rails for EUR SEPA and USD ACH pay-ins.

Identity Verification

Mint hosted KYC/KYB links, or forward a verification you already completed.

Wallets

Generate blockchain wallets for crypto settlement across supported chains.

Transfers

Execute fiat and crypto transfers between accounts.

Fiat-to-Crypto Payment Sessions

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

Pay-outs

Send crypto from an account wallet and pay a bank beneficiary in fiat.

Payout Bank Accounts

Allow-list beneficiary bank accounts as pay-out destinations.

Supported Assets

Discover which chains and assets your tenant can settle in.

Permits

Manage EIP-712 permit signatures for token approvals.

Allowances

Query token allowances for wallets.

Webhooks

Receive asynchronous events instead of polling for them.

Next Steps

Getting Started

Create a party, open an account, and get verified — with managed and self-custody examples.

Integration Walkthrough

The full end-to-end flow, from onboarding to settling a transfer.

Onboarding & verification

KYC, KYB, and the two routes to getting a party verified.

Authentication

Token exchange, refresh patterns, and environment URLs.

Support

Visit venlyfinance.com/contact to reach our team.

​Base URLs

​Authentication

​Idempotency, pagination, versioning

​Data model

​Resources

Parties

Accounts

Virtual Bank Accounts

Identity Verification

Wallets

Transfers

Fiat-to-Crypto Payment Sessions

Pay-outs

Payout Bank Accounts

Supported Assets

Permits

Allowances

Webhooks

​Next Steps

Getting Started

Integration Walkthrough

Onboarding & verification

Authentication

​Support

Base URLs

Authentication

Idempotency, pagination, versioning

Data model

Resources

Next Steps

Support