#Introduction

Finity API is a REST API for moving and managing funds across supported assets. It returns JSON and uses standard HTTP methods and status codes.

#Environments

Use the sandbox to validate your integration before sending live transactions. Keep credentials and tokens out of source control.

#Authentication

Request a token with the client credentials grant:

curl -X POST https://api2.finity.com.co/v0/oauth/token \
  -H 'Content-Type: application/json' \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET"
  }'

Send the returned token on protected requests:

curl https://api2.finity.com.co/v0/account/USD \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

#Choose your next step

• Review the API overview.
• Create an external account before creating a withdrawal order.
• Learn the two-step currency conversion flow.