Endpoints & URLs - Venly Finance

Use staging credentials and URLs during development. Staging calls do not move real funds.

Which host the samples use. Step-by-step tutorials — Quick Start, the Finance API walkthrough and Getting started — use the staging hosts so you can run them as-is. Concept guides and endpoint references use the production hosts. Swap the host for the environment you are targeting; nothing else in the request changes.

Authentication

Both the Fundflow API and Finance API use the same OAuth2 token endpoint:

Environment	URL
Staging	`https://login-staging.venly.io/auth/realms/VenlyFinance/protocol/openid-connect/token`
Production	`https://login.venly.io/auth/realms/VenlyFinance/protocol/openid-connect/token`

Request (application/x-www-form-urlencoded):

Parameter	Value
`grant_type`	`client_credentials`
`client_id`	Your client ID
`client_secret`	Your client secret

Tokens are valid for 5 minutes (300 seconds). See the Authentication guide for refresh patterns.

Fundflow API

Environment	Base URL
Staging	`https://api-fundflow-staging.venly.io/v1`
Production	`https://api-fundflow.venly.io/v1`

Key Fundflow endpoints

Endpoint	Method	Description
`/company`	GET	Verify KYB status
`/ramp-requests`	GET / POST	List or create ramp requests
`/ramp-requests/{id}`	GET	Get ramp request by ID
`/ramp-requests/{id}/approve`	POST	Approve a ramp request
`/ramp-requests/{id}/reject`	POST	Reject a ramp request
`/ramp-requests/{id}/cancel`	POST	Cancel a ramp request
`/ramp-requests/on-ramp/pairs`	GET	Available on-ramp currency pairs
`/ramp-requests/off-ramp/pairs`	GET	Available off-ramp currency pairs
`/fees/calculate`	POST	Calculate fee for a ramp request
`/company-bank-accounts`	GET / POST	Manage company bank accounts
`/company-wallets`	GET / POST	Manage company wallets

Finance API

Environment	Base URL
Staging	`https://api-staging.venlyfinance.com/v1`
Production	`https://api.venlyfinance.com/v1`

Key Finance endpoints

Endpoint	Method	Description
`/parties`	GET / POST	List or create parties
`/parties/{id}`	GET / PATCH / DELETE	Get, update, or delete a party
`/accounts`	GET / POST	List or create accounts
`/accounts/{id}`	GET	Get account details
`/accounts/{id}/party-roles`	GET / POST	List or add party roles on an account
`/parties/{id}/verification`	POST	Mint a hosted KYC/KYB verification link
`/parties/{id}/iv-verification`	GET	Read verification linkage
`/parties/{id}/payout-bank-accounts`	GET / POST	Allow-list pay-out destinations
`/accounts/{id}/wallets`	GET	List wallets for an account
`/accounts/{id}/virtual-bank-accounts`	GET / POST	List or create bank deposit rails
`/accounts/{id}/fiat-to-crypto/payment-sessions`	POST	Create a hosted pay-in session
`/accounts/{id}/payout-routes`	GET / POST	List or create pay-out routes
`/accounts/{id}/payouts`	GET / POST	List or request pay-outs
`/accounts/{id}/transfers`	GET	List transfers for an account
`/accounts/{senderId}/transfers/crypto` · `/fiat`	POST	Create a crypto or fiat transfer
`/webhooks`	GET / POST	List or register webhooks

Relevant Finance API endpoints accept an idempotencyKey field in the request body to prevent duplicate operations on retry. Supply a unique UUID for every new request.

Quick Copy

curl -X POST https://login-staging.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"

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"

​Authentication

​Fundflow API

​Key Fundflow endpoints

​Finance API

​Key Finance endpoints

​Quick Copy

Authentication

Fundflow API

Key Fundflow endpoints

Finance API

Key Finance endpoints

Quick Copy