Skip to main content

Welcome to Mueve

A powerful currency exchange API service for seamless USD transactions with real-time rates, automated commission calculation, and secure payment processing.

Get StartedAPI Reference
JWT Authentication
Real-time Exchange Rates
Dynamic Commissions
Secure Transactions

Quick Start

Get started with Mueve in just a few steps

1

Register your account

Create a new account by sending a POST request to the registration endpoint with your name, email, and password.
cURL
curl -X POST http://localhost:3001/api/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "John Doe",
    "email": "[email protected]",
    "password": "secure_password"
  }'
2

Authenticate and get your token

Login with your credentials to receive a JWT token for authenticated requests.
cURL
curl -X POST http://localhost:3001/api/login \
  -H "Content-Type: application/json" \
  -d '{
    "email": "[email protected]",
    "password": "secure_password"
  }'

{
  "message": "Login exitoso",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "user": {
    "id": 1,
    "name": "John Doe",
    "email": "[email protected]"
  }
}
3

Get current exchange rate

Fetch the current USD exchange rate to bolivares.
cURL
curl http://localhost:3001/api/rate
4

Create your first transaction

Create a buy or sell transaction with the current rate.
cURL
curl -X POST http://localhost:3001/api/transactions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_JWT_TOKEN" \
  -d '{
    "transaction_type": "Comprar",
    "amount_usd": 50,
    "rate_bs": 36.50,
    "payment_reference": "ABC123456",
    "type_pay": "Zelle",
    "recipient_account": "[email protected]"
  }'

Explore by Topic

Dive deeper into specific areas of the API

Authentication

Learn about JWT-based authentication, registration, and login flows.

Exchange Rates

Understand how real-time rates are managed with Redis caching.

Transactions

Create and track buy/sell transactions with automatic commission calculation.

Commissions

Learn how dynamic commission rates are calculated based on transaction amounts.

Key Features

Everything you need for currency exchange operations

Secure Authentication

JWT-based authentication with bcrypt password hashing ensures your transactions are secure.

Real-time Rates

Redis-cached exchange rates with MySQL persistence provide fast, reliable rate information.

Smart Commissions

Automatic commission calculation based on transaction amount with transparent pricing tiers.

Payment Validation

Built-in payment reference validation prevents duplicate transactions and ensures data integrity.

Ready to get started?

Set up your first currency exchange transaction in minutes with our comprehensive API documentation and guides.

View Quickstart Guide