Finrax API Documentation
DashboardResourcesMain
  • Introduction
  • Authorization
    • API Keys Management
    • Signature
    • Code snippets
  • Environments
  • Errors
  • Changelog
  • References
    • Crypto payments
      • 🔒Request crypto payment
      • 🔒Add payment details
      • 🔒Get payment data
      • Fetch deposit amounts metadata
    • Crypto withdrawals
      • Request withdrawal metadata
      • 🔓Get crypto withdrawal approval status
      • 🔒Request crypto withdrawal
        • National Identifier Types
        • Name Identifier Type
    • Wallet Addresses
      • Validate address
    • Businesses
      • 🔒Get business payments
      • 🔒Get business withdrawals
      • 🔒Get business balances
    • Callbacks
      • Deposit received notification
      • Withdrawal broadcast notification
      • Withdrawal approved/rejected notification
    • Currencies & Fees
      • Get all currencies
      • Get exchange rates [crypto to fiat]
      • Get exchange rates [fiat to fiat]
      • Get exchange rates [any currency to any currency]
Powered by GitBook
On this page
  • 2025-01-25
  • 2024-10-19
  • 2024-08-06
  • 2024-07-04
  • 2024-05-29
  • 2024-05-16
  • 2024-04-01
  • 2023-06-16
  • 2023-02-09
  • 2022-09-26
  • 2022-08-21
  • 2022-06-30
  • 2022-05-19
  • 2022-05-09
  • 2021-11-08

Was this helpful?

Changelog

PreviousErrorsNextCrypto payments

Last updated 2 months ago

Was this helpful?

2025-01-25

  • Added a rate matching functionality so that stable crypto coin rates can be exactly 1:1 matched with their fiat backing currency.

2024-10-19

  • Minimum Deposit Processing Amount was introduced to improve the experience in cases where the actual deposit amount is lower than the amount which can effectively be processed.

2024-08-06

  • Businesses can now choose which specific network they want to allow for any of the deposit currencies. This applies to currencies where multiple deposit networks are supported. Read more about it on our .

2024-07-04

  • Added the ability to configure which party is responsible for covering the on-chain fees when sending out a settlement. This can be configured once for all withdrawals created from a given business on each individual withdrawal. Find out more .

2024-05-29

  • Added the ability to require an approval from a second user before sending out a withdrawal. This configuration is made once for each organisation and applies to all subsequently sent withdrawals. For a detailed step-by-step breakdown, please visit our .

2024-05-16

  • Solana has been added as supported network for crypto withdrawals and deposit for USDC. Furthermore we also added SOL as deposit and withdrawal currency.

2024-04-01

2023-06-16

2023-02-09

2022-09-26

List of currencies and their supported deposit networks

Currency
Network

USDC

Ethereum chain (ETH), Binance Smart Chain (BSC) and Tron Chain (TRX)

ETH

Ethereum chain (ETH) and Binance Smart Chain (BSC)

BTC

BTC

BCH

BCH

LTC

LTC

XRP

XRP

XLM

XLM

LINK

ETH

2022-08-21

    • MAIN is no longer a valid value for the network field instead, use one of the values described on the Request crypto withdrawal page.

    • Added a new field maxAmount to the response. It will hold the maximum amount that can be withdrawn in the respective cryptocurrency.

List of currencies and their old/new supported withdrawal networks

Currency
Supported networks (From 2022-08-15)
Supported networks (To 2022-08-15)

BTC

BTC

MAIN

BCH

BCH

MAIN

ETH

ETH, BSC

MAIN, BSC

LINK

ETH

MAIN, BSC

LTC

LTC

MAIN

USDC

ETH, BSC, TRX

not supported

XLM

XLM

MAIN

XRP

XRP

MAIN

2022-06-30

Reducing the list of supported currencies

  • Finrax will cease processing (deposits and withdrawals) of the following currencies as of 2022-07-15:

Basic Attention Token (BAT),
Bancor (BNT),
Civic (CVC),
Enjin Coin (ENJ),
Mithril (MITH),
Metal (MTL),
OmiseGo (OMG),
Augur (REP)

Reason for delisting is low processing volumes and low liquidity on the markets.

2022-05-19

    • New supported network - TRX

2022-05-09

    • New optional field for the request body - network

    • New field in the response body - network

    • New endpoint that provides metadata for all supported cryptocurrencies

    • We are deprecating the old endpoint and introducing a new one:

      • POST /api/v1/addresses/validate is being Deprecated

      • GET /api/v1/currency/:withdrawalCurrency/network/:network/address/:address/valid - New

    • New endpoint that provides rates for currencies(fiat and crypto) and supports comma-separated values.

2021-11-08

    • New status -BLOCKED

    • New field - txAddressOwner

    • New status - BLOCKED

    • New fields - addressOwner, sourceRiskEntities, destinationRiskEntities

Added the withdrawal approvals feature allowing admin users to have additional control over crypto withdrawals by manually approving or rejecting them. Further details can be found under .

Adding statuses to deposits in payments. Changes to the response are visible under .

Adding a network field as a mandatory one to the post request for . Currencies and networks pairs available are the same as for our .

Introducing deposits through side chains. To take advantage of this new feature changes should be made to either the or the payload.

Changes to the accepted values for the network field for

Added a maximum amount the can be withdrawaln depending on the network and the respective cryptocurrency. Information can be found in the .

Different response fields when sending . For payments with LTC as their depositCurrency the response will only include a walletAddress field. We are removing the ltc3Addressfield and changing the address type that is returned in the walletAddress.

Changes to our .

The changes to network names that are described on the page will also take affect here (see table below and ).

Changes to the network field in the endpoint

request body and response body

request body and response body

Deprecating the . It is replaced by the new .

for any currency

request body

response

guide page
here
guide page
Withdrawal approvals
Get payment data
whitelisted address creation
withdrawals
Request crypto payment
Add payment details
crypto withdrawals
metadata endpoint
payment details
metadata endpoint
validate address
Withdrawal
Withdrawal
Get cryptocurrency metadata
withdrawal and on-chain fees endpoint
metadata endpoint
Exchange rates
Withdrawal callback
Get business withdrawals
crypto withdrawals
Validate address
example response