Skip to main content

​
Welcome to HopNow API

The HopNow API is a secure, scalable platform for business-to-business money movement. Use it to embed multi-currency accounts, automate payouts, and access institutional-grade foreign exchange without building banking infrastructure yourself.

​
What you can do with HopNow API

Account Management

Create and manage customer accounts with multi-currency balance tracking

Money Movement

Process payins and payouts with real-time status tracking

Foreign Exchange

Get competitive FX rates and execute currency conversions

Webhooks

Real-time notifications for all payment and account events

​
Key Features for B2B Platforms

​
🔐 Enterprise Security

  • HMAC Authentication: Industry-standard request signing for maximum security
  • API Key Management: Granular permissions and access control
  • Compliance Ready: Built for regulatory requirements across multiple jurisdictions

​
🌍 Global Reach

  • Multi-Currency Support: Handle transactions in 150+ currencies
  • Virtual Accounts: Generate local banking details for international collections
  • Crypto Integration: Support for major cryptocurrencies via Fireblocks

​
⚡ Developer Experience

  • RESTful Design: Intuitive API following REST principles
  • Comprehensive Webhooks: Real-time event notifications
  • Detailed Documentation: Complete guides with code examples
  • Interactive Testing: Built-in API playground

​
📊 Observability

  • Structured Logging: Complete audit trail for all operations
  • Performance Monitoring: Real-time system performance tracking
  • Error Tracking: Automated error detection and reporting

​
API Overview

Our API is organized around resources representing financial primitives:
  • Customers - The businesses you onboard into HopNow
  • Accounts - Multi-currency balance containers mapped to each customer
  • Transfers - Money movement operations (payins/payouts)
  • FX Quotes - Foreign exchange rate quotes and executions
  • Webhooks - Event-driven notifications

​
Base URLs

HopNow exposes distinct hosts for sandbox testing and production traffic:
  • Sandbox
  • Production
  • Base URL: https://apis-sbx.hopnow.io
  • Rate limits and fake funds for safe experimentation
  • Matches production behavior, including HMAC auth and webhook flows

​
API Versioning

The current API version is v1. All endpoints are prefixed with /v1/. Example endpoint: 
GET https://apis.hopnow.io/v1/customers/{customer_id}/accounts
Replace apis.hopnow.io with apis-sbx.hopnow.io when calling the sandbox.

​
Getting Started

Quick Start Guide

Get up and running in 5 minutes with our step-by-step guide

Authentication Setup

Learn how to authenticate your API requests with HMAC signatures

API Reference

Explore all available endpoints with interactive examples

​
Need Help?

  • Documentation Issues: Contact support for documentation feedback
  • API Support: Email us at [email protected]
Ready to start building? Check out our Quick Start Guide to make your first API call in minutes.