Fuze HQ
API docs by Redocly

Fuze Documentation (0.0.7)

Download OpenAPI specification:

E-mail: engineering@fuze.finance License: Apache 2.0 Terms of Service

Fuze Documentation

user

Update Acl for a user

Update acl for a user. (Requires READWRITE permission for ACL and user)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
string
object

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "barbara_allen",
  • "modules": {
    }
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": "OK"
}

Create a new User

Create a new User by providing orgUserId. (Requires READWRITE permissions for User)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
One of
orgUserId
required
string

Org user id

userType
required
string
Value: "CONSUMER"

Type of User

kyc
required
boolean

KYC details of the User passed to API

tnc
required
boolean

User acceptance of TnC

kycData
object or null

KYC data

Responses

Request samples

Content type
application/json
Example
{
  • "orgUserId": "johndoe123",
  • "userType": "CONSUMER",
  • "kyc": true,
  • "tnc": true,
  • "kycData": { }
}

Response samples

Content type
application/json
Example
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Get User by orgUserId

Get User by orgUserId provided at creation time. (Requires READ permission on user)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "barabara_allen"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    }
}

Freeze User

Freeze a user by passing orgUserId. Once done, further operations on the user will be rejected. (Requires READWRITE permission on User)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "barabara_allen"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Fetch balances of a user

Fetch a summary of balances for a user. (Requires READ permission for User)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

Org user id

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "johndoe123"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

Unfreeze Account

Unfreeze an account by passing orgUserId. (Requires READWRITE permission on User)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

Org user id

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "johndoe123"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Fetch all users for your org

Fetch all users for your org. (Requires READ permissions for Org.)

Authorizations:
ApiKeyAuth
query Parameters
pageNumber
integer

offset of the page. Default is 0.

pageSize
integer

number of records to fetch in a page. Default is 50.

userType
string

Type os user (example : consumer, employee).

search
string

search on the basis of name/email.

status
string

status of the user (inactive, active)

sort
string

sorting the response with direction (example: status:ASC, name:DESC). If no direction is mentioned, ASC will be considered by default

header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": [
    ],
  • "error": null
}

Edits a already present User

Edits a already present user by providing orgUserId. (Requires READWRITE permissions for User)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

Org user id

tnc
boolean

User acceptance of TnC

modules
object

Permissions enabled for the user

loginAllowedFrom
string or null

Allowed login from

loginAllowedTo
string or null

Allowed login to

kycData
object or null

KYC data

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "johndoe123",
  • "tnc": true,
  • "modules": { },
  • "loginAllowedFrom": "14:00:00",
  • "loginAllowedTo": "23:00:00",
  • "kycData": { }
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": "OK"
}

Delete a user

Delete a user by providing orgUserId. (Requires READWRITE permissions for User)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "barabara_allen"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

adcb

Get accounts for the user

Get accounts for the user. (Requires READWRITE permission for adcb)

Authorizations:
UserAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
object (GetAccountsBody)

Responses

Request samples

Content type
application/json
{ }

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": null
}

Get default account for the user

Get default account for the user. (Requires READWRITE permission for adcb)

Authorizations:
UserAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
object (GetDefaultAccountBody)

Responses

Request samples

Content type
application/json
{ }

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": null
}

initiate fund transfer for the user

initiate fund transfer for the user. (Requires READWRITE permission for adcb)

Authorizations:
UserAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
object (InitiateFundTransferBody)

Responses

Request samples

Content type
application/json
{ }

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": null
}

apikms

Generate API key pair

Requires READWRITE permission for APIKMS

Authorizations:
UserAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
access
required
integer

3 - READWRITE, 2 - WRITE, 1 - READ

expirySeconds
required
integer
ipWhitelist
Array of strings

Responses

Request samples

Content type
application/json
{
  • "access": 3,
  • "expirySeconds": 999999999999,
  • "ipWhitelist": [
    ]
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

Fetch API key pair

Requires READWRITE permission for APIKMS

Authorizations:
UserAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
apiKey
required
string

Responses

Request samples

Content type
application/json
{
  • "apiKey": "MCowDuMmyApiKey"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

List API key pairs

Requires READWRITE permission for APIKMS

Authorizations:
UserAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": [
    ],
  • "error": null
}

Delete API key pair

Requires READWRITE permission for APIKMS

Authorizations:
UserAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
apiKey
required
string

Responses

Request samples

Content type
application/json
{
  • "apiKey": "MCowDuMmyApiKey"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": "OK",
  • "error": null
}

Rotate API key pair

Requires READWRITE permission for APIKMS

Authorizations:
UserAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
apiKey
required
string

Responses

Request samples

Content type
application/json
{
  • "apiKey": "MCowDuMmyApiKey"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

asset

Fetch symbols of your org

Fetch supported assets with which you can make trades. Requires READ permissions for Org.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

Fetch assets for your org

Get asset metadata that you can use in your app. Requires READ permissions for Org.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

audit

Get audit details for your org.

Get an audit trail of events(user creation, policy changes etc.) tied to your orgId. Requires READ permissions for Audit.

Authorizations:
ApiKeyAuth
query Parameters
entityType
string

entity to fetch the audit details for. Example: Orders

pageNumber
integer

offset of the page. Default is 0.

pageSize
integer

number of records to fetch in a page. Default is 50.

search
string

search on the basis of name/email.

fromDate
string

used for date range. should be in YYYY-MM-DD

toDate
string

used for date range. should be in YYYY-MM-DD

header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

bank

Create an entry in the thirdParty table

Create an entry in the thirdParty table. (Requires READWRITE permission for Bank)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
string
name
string
type
string

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "test@test.com",
  • "name": "TESTNAME",
  • "type": "SELF"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": "SUCCESS"
}

deletes an entry in the third party table

deletes an entry in the third party table. (Requires READWRITE permission for bank)

Authorizations:
ApiKeyAuth
path Parameters
thirdPartyUuid
required
string

thirdPartyUuid which needs to be deleted

header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": "SUCCESS"
}

fetch all the third parties for the org

fetch all the third parties for the org. (Requires READWRITE permission for bank)

Authorizations:
ApiKeyAuth
query Parameters
status
string

status of each invoice. Example: PAID

pageNumber
integer

offset of the page. Default is 0.

pageSize
integer

number of records to fetch in a page. Default is 50.

fromDate
string

used for date range. should be in YYYY-MM-DD

toDate
string

used for date range. should be in YYYY-MM-DD

header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

Create an fiat account for the third party

Create an fiat account for the third party. (Requires READWRITE permission for Bank)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
thirdPartyUuid
string
accountNumner
string
bankSwiftCode
string
iban
string
bankCode
string
currency
string
paymentMethod
string

Responses

Request samples

Content type
application/json
{
  • "thirdPartyUuid": "aasdasd-asdasd-asdads",
  • "accountNumner": "123123",
  • "bankSwiftCode": "ABCDXXXXXX",
  • "iban": "AE12314ADA312312",
  • "bankCode": "002",
  • "currency": "AED",
  • "paymentMethod": "SWIFT"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": "SUCCESS"
}

deletes an entry in the third party account table

deletes an entry in the third party account table. (Requires READWRITE permission for bank)

Authorizations:
ApiKeyAuth
path Parameters
clientIdentifier
required
string

third party account clientIdentifier which needs to be deleted

header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": "SUCCESS"
}

Create a crypto wallet entry for the third-party

Create a crypto wallet entry for the third-party. (Requires READWRITE permission for Bank)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
thirdPartyUuid
string
asset
string
address
string
chain
string
network
string

Responses

Request samples

Content type
application/json
{
  • "thirdPartyUuid": "aasdasd-asdasd-asdads",
  • "asset": "ETH",
  • "address": "ASDASD123123ASDAS",
  • "chain": "ETH",
  • "network": "ETHEREUM"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": "SUCCESS"
}

deletes an entry in the third party wallet table

deletes an entry in the third party wallet table. (Requires READWRITE permission for bank)

Authorizations:
ApiKeyAuth
path Parameters
thirdPartyWalletUuid
required
string

third party wallet uuid which needs to be deleted

header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": "SUCCESS"
}

Create a crypto wallet entry for the third-party

Create a crypto wallet entry for the third-party. (Requires READWRITE permission for Bank)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
clientIdentifier
required
string

Unique identifier for the client

address
required
string

Wallet address of the external party

asset
required
string

Asset for the wallet

chain
required
string

Blockchain for the wallet

memo
string or null

Memo for the wallet

walletType
required
string

Type of the wallet

nickname
required
string

Nickname for the wallet

Responses

Request samples

Content type
application/json
{
  • "clientIdentifier": "sherlock_holmes",
  • "address": "0x5B6f2822b0b235700Bd736A00D666e2531252A7E",
  • "asset": "ETH",
  • "chain": "ETHEREUM",
  • "memo": "memo",
  • "walletType": "CUSTODIAL",
  • "nickname": "nickname"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

base

Fetch notifications for a user

Fetch a list of notifications for a user. (Requires READ permission for User)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
pageNumber
integer <int32>
pageSize
integer <int32>
fromDate
string <date>
toDate
string <date>

Responses

Request samples

Content type
application/json
{
  • "pageNumber": 1,
  • "pageSize": 1,
  • "fromDate": "2023-03-02",
  • "toDate": "2023-03-02"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

custody

estimates the fee for a new transaction

estimates the fee for a new transaction

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
asset
string
chain
string

Responses

Request samples

Content type
application/json
{
  • "asset": "ETH",
  • "chain": "ETHEREUM"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Get supported assets in custody

Get supported assets in custody (Requires READ permission on custody)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Get custody details of an org for asset and chain

Get custody details of an org for asset and chain (Requires READ permission on custody)

Authorizations:
ApiKeyAuth
path Parameters
asset
required
string

asset for which custody of org needs to be fetched

chain
required
string

chain of the asset for which custody of org needs to be fetched

header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Get custody details of an org for asset

Get custody details of an org for asset (Requires READ permission on custody)

Authorizations:
ApiKeyAuth
path Parameters
asset
required
string

asset for which custody of org needs to be fetched

header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

enables asset in custody for user

enables asset in custody for user. (Requires READWRITE permission on custody)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
orgUserId
string
asset
string
chain
string

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "string",
  • "asset": "ETH",
  • "chain": "ETHEREUM"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

fetches custody transactions for a user

fetches custody transactions for a user. (Requires READ permission on custody)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
orgUserId
string
asset
string
chain
string
custodyType
string
Enum: "SEGREGATED" "OMNIBUS"
status
string
entry
string
Enum: "DEPOSIT" "WITHDRAWAL"

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "string",
  • "asset": "ETH",
  • "chain": "ETHEREUM",
  • "custodyType": "SEGREGATED",
  • "status": [
    ],
  • "entry": "DEPOSIT"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

fetches a custody transaction for a user by transactionId

fetches a custody transaction for a user. (Requires READ permission on custody)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
orgUserId
string
transactionId
number

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "barbara_allen",
  • "transactionId": 11
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

fetches whitelisted external addresses for a user

fetches whitelisted external addresses for a user. (Requires READWRITE permission on custody)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
orgUserId
string
asset
string
chain
string

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "string",
  • "asset": "ETH",
  • "chain": "ETHEREUM"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

create a whitelisted external wallet

create a whitelisted external wallet. (Requires READWRITE permission on custody)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
string or null
notabeneExternalCounterpartyVaspDid
string or null
nickname
string
address
string
memo
string or null
asset
string
chain
string
walletType
string
provider
string

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "orgUserId",
  • "notabeneExternalCounterpartyVaspDid": "did:ethr:0x5B6f2822b0b235700Bd736A00D666e2531252A7E",
  • "nickname": "nickname",
  • "address": "0x5B6f2822b0b235700Bd736A00D666e2531252A7E.",
  • "memo": "12345",
  • "asset": "ETH",
  • "chain": "ETHEREUM",
  • "walletType": "CUSTODIAL",
  • "provider": "0x5B6f2822b0b235700Bd736A00D666e2531252A7E"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

check if the address is valid

check if the address is valid

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
address
string
chain
string

Responses

Request samples

Content type
application/json
{
  • "address": "0x5B6f2822b0b235700Bd736A00D666e2531252A7E",
  • "chain": "ETHEREUM"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

delete external wallet

deletes an external wallet of a user by its id

Authorizations:
ApiKeyAuth
path Parameters
id
required
string

id which needs to be deleted

header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": "OK"
}

Checks if an external wallet already exists for an org

Create a crypto deposit wallet for the third party. (Requires READWRITE permission for Bank)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
address
string
asset
string
chain
string
memo
string

Responses

Request samples

Content type
application/json
{
  • "address": "0x5B6f2822b0b235700Bd736A00D666e2531252A7E",
  • "asset": "ETH",
  • "chain": "ETHEREUM",
  • "memo": "fakememo"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": "OK"
}

finance

Gets all the accounts for the org

Gets all the accounts for the org

Authorizations:
UserAuth

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

add a bank account

add a bank account. (Requires READWRITE permission for finance)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
beneficiaryName
string
bankName
string
bankCountry
string
currency
string
accountNumber
string
transferDetails
string

Responses

Request samples

Content type
application/json
{
  • "beneficiaryName": "Account1",
  • "bankName": "ENBD",
  • "bankCountry": "UAE",
  • "currency": "AED",
  • "accountNumber": "account1",
  • "transferDetails": "{swiftcode : \"swiftBank\"}"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

delete a bank account

delete a bank account. (Requires READWRITE permission for finance)

Authorizations:
ApiKeyAuth
path Parameters
accountId
required
string

accountId of the account that needs to be deleted

header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

initiate a transaction to a fiat bank account.

initiate a transaction to a fiat bank account. (Requires READWRITE permission for finance)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
accountId
integer
txnId
string
amount
integer
transactionType
string (BankTransferType)
Enum: "DEPOSIT" "WITHDRAW" "SETTLEMENT"
currency
string
fundingAmount
integer
fundingCurrency
string

Responses

Request samples

Content type
application/json
{
  • "accountId": 10,
  • "txnId": "Txn1",
  • "amount": 1,
  • "transactionType": "DEPOSIT",
  • "currency": "AED",
  • "fundingAmount": 1,
  • "fundingCurrency": "AED"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": [
    ],
  • "error": null
}

list of all fiat transactions.

list of all fiat transactions. (Requires READ permissions for Finance.)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
pageNumber
integer
pageSize
integer
orgUserId
string
type
string (BankTransferType)
Enum: "DEPOSIT" "WITHDRAW" "SETTLEMENT"
status
string (BankTransferStatus)
Enum: "PENDING" "COMPLETED" "CANCELED" "EXPIRED"
fromDate
string
toDate
string
fuzeReferenceId
string

Responses

Request samples

Content type
application/json
{
  • "pageNumber": 1,
  • "pageSize": 2,
  • "orgUserId": "barbara_allen",
  • "type": "DEPOSIT",
  • "status": "PENDING",
  • "fromDate": "2024-03-03",
  • "toDate": "2024-03-04",
  • "fuzeReferenceId": "12345-1312314-12312312"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": [
    ],
  • "error": null
}

Get current balance for the account

Get current balance for the account. (Requires READ permissions for finance.)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

Gets all the fuze maintained accounts for the org

Gets all the fuze maintained accounts for the org

Authorizations:
UserAuth

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

Gets all the fuze target accounts for the org

Gets all the fuze target accounts for the org

Authorizations:
UserAuth

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

get all orders for an org

Returns the created orders for the org. (Requires READ permission on finance.)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
pageNumber
integer
pageSize
integer
fromDate
string
toDate
string
transactionType
string
sort
string

Responses

Request samples

Content type
application/json
{
  • "pageNumber": 1,
  • "pageSize": 2,
  • "fromDate": "2023-08-22",
  • "toDate": "2023-08-23",
  • "transactionType": "BUY",
  • "sort": "createdAt:DESC"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

export orders for an org

Exports the orders for the org. (Requires READ permission on finance.)

Authorizations:
UserAuth
Request Body schema: application/json
required
fromDate
required
string
toDate
required
string
orgUserId
string
status
string
side
string
sort
string

Responses

Request samples

Content type
application/json
{
  • "fromDate": "2023-08-22",
  • "toDate": "2023-08-23",
  • "orgUserId": "orgUserId",
  • "status": "OPEN,CLOSED",
  • "side": "BUY,SELL",
  • "sort": "createdAt:DESC"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": "OK"
}

get fx rate between two currencies

get fx rate between two currencies. (Requires READ permission on finance.)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
fromCurrency
string
toCurrency
string

Responses

Request samples

Content type
application/json
{
  • "fromCurrency": "USD",
  • "toCurrency": "AED"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": 3,
  • "error": null
}

Cancels the transaction

Cancels the transaction

Authorizations:
UserAuth
Request Body schema: application/json
required
referenceId
string
transactionStatus
string
transactionType
string

Responses

Request samples

Content type
application/json
{
  • "referenceId": "asdf1234",
  • "transactionStatus": "CANCELED",
  • "transactionType": "DEPOSIT"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": "OK"
}

swap between two currencies for same org

swap between two currencies for same org. (Requires READWRITE permission for finance)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
fromCurrency
string
fromAmount
integer
toCurrency
string
toAmount
integer

Responses

Request samples

Content type
application/json
{
  • "fromCurrency": "USD",
  • "fromAmount": 100,
  • "toCurrency": "AED",
  • "toAmount": 367
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": "OK"
}

kyc

Get upload link to upload individual kyc file

Get upload link to upload individual kyc file

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
string
fileName
string
docCategory
string (DocCategory)
Enum: "IDENTITY_FRONT" "IDENTITY_BACK" "ADDRESS" "EDD" "LIVELINESS" "W9" "FATCA" "OTHER"
docSubCategory
string or null
docDescription
string

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "jim@dundermifflin.com",
  • "fileName": "JimHalpertPassport.pdf",
  • "docCategory": "IDENTITY_FRONT",
  • "docSubCategory": "Passport",
  • "docDescription": "This is the passport of Jim Halpert."
}

Response samples

Content type
application/json
{}

Get upload status of kyc files

Get upload status of kyc files

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
string

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "barabara_allen"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Get edd tracker entries for an org

Get edd tracker entries for an org

Authorizations:
UserAuth
Request Body schema: application/json
required
pageNumber
integer <int32>
pageSize
integer <int32>
fromDate
string
toDate
string
status
string (EddStatus)
Enum: "PENDING" "COMPLETED"

Responses

Request samples

Content type
application/json
{
  • "pageNumber": 1,
  • "pageSize": 2,
  • "fromDate": "2024-03-03",
  • "toDate": "2024-03-04",
  • "status": "PENDING"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

Update edd tracker entry

Update edd tracker entry

Authorizations:
UserAuth
Request Body schema: application/json
required
uuid
string
orgUserId
string
status
required
string

Responses

Request samples

Content type
application/json
{
  • "uuid": "4acc9473-e0cd-4106-b388-1d3e44dd86cf",
  • "orgUserId": "barbara_allen",
  • "status": "COMPLETED"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": "OK"
}

Fetch kyc files for an org and user

Fetch kyc files for an org and user

Authorizations:
UserAuth
Request Body schema: application/json
required
orgUserId
string

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "FUZE01234"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

Update kyc file for an org and user

Update kyc file for an org and user

Authorizations:
UserAuth
Request Body schema: application/json
required
orgUserId
string
uuid
string

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "FUZE01234",
  • "uuid": "f1a74abc-9d39-45fd-ab7c-cf816cba2e02"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": "OK"
}

Delete a kyc file for an org and user

Delete a kyc file for an org and user

Authorizations:
UserAuth
Request Body schema: application/json
required
orgUserId
string
uuid
string

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "FUZE01234",
  • "uuid": "f1a74abc-9d39-45fd-ab7c-cf816cba2e02"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": "OK"
}

loyalty

buy/sell loyalty points

reward tokens, or sell rewarded tokens. (Requires READWRITE permissions for loyalty).

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string
symbol
required
string
quoteQuantity
required
number

quoteQuantity is the local currency amount you want to buy or sell crypto for. Eg: If if you want to buy 1000 AED worth of BTC, you’ll have quoteQuantity 1000 on BTC_AED. If you’re selling 1000 AED quoteQuantity of BTC, quoteQuantity is 1000. Not quantity should be zero in both cases.

operation
required
string
Enum: "BUY" "SELL"
type
string (OrderType)
Enum: "MARKET" "LIMIT"
clientOrderId
string

this is an idempotency key to avoid duplicate orders due to network failures

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "barabara_allen",
  • "symbol": "ETH_AED",
  • "quoteQuantity": 1000,
  • "operation": "BUY",
  • "type": "MARKET",
  • "clientOrderId": "unique-uuid"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

fetch the details of a particular order

Returns the details of a particular order. (Requires READ permission on Loyalty.)

Authorizations:
ApiKeyAuth
path Parameters
orderId
required
string

orderId of the order for which details needs to be fetched

header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

oauth

Generate OAuth Access Token

Returns an accessToken for the given clientId, clientSecret and scope.

Authorizations:
JWT
Request Body schema: -
required
grantType
required
string
Value: "client_credentials"

The OAuth 2.0 grant type. Must be client_credentials.

clientId
required
string

The client ID issued to the client during the registration process.

clientSecret
required
string

The client secret issued to the client during the registration process.

scope
string

The scope of the access token to be requested. Space separated MODULE:PERMISSION values (eg. <module_1>:<permission_1> <module_2>:<permission_2> ... <module_n>:<permission_n>)

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

Test oauth endpoint

Echoes back the request body if oauth middleware is successful

Authorizations:
JWT

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

Wallet

Create internal wallet

Create internal wallet. Requires READWRITE permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

Unique identifier of the user.

counterPartyId
string or null

Unique identifier of the counterparty.

required
object

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "sherlock_holmes",
  • "counterPartyId": "123e4567-ea9b-12d3-a456-426614174000",
  • "walletDetails": {
    }
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Get internal wallet

Get internal wallet. Requires READ permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

Unique identifier of the user.

walletId
required
string

Unique identifier of the wallet.

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "sherlock_holmes",
  • "walletId": "123e4567-e89b-12d3-a456-426614174000"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

List internal wallets

List internal wallets. Requires READ permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

Unique identifier of the user.

counterPartyId
string or null

Unique identifier of the counterparty.

walletId
string

Unique identifier of the wallet.

currency
string

Currency of the wallet.

chain
string

Blockchain of the wallet.

pageNumber
number

Page number for pagination.

pageSize
number

Size of the page for pagination.

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "sherlock_holmes",
  • "counterPartyId": "123e4567-ea9b-12d3-a456-426614174000",
  • "walletId": "123e4567-ea9b-12d3-a456-426614174000",
  • "currency": "USDC",
  • "chain": "ETHEREUM",
  • "pageNumber": 0,
  • "pageSize": 50
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

List wallet currencies

List wallet currencies. Requires READ permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

Create external wallet

Create external wallet. Requires READWRITE permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

Unique identifier of the user.

counterPartyId
required
string

Unique identifier of the counterparty.

walletId
required
string

Unique identifier of the wallet.

required
object

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "sherlock_holmes",
  • "counterPartyId": "123e4567-ea9b-12d3-a456-426614174000",
  • "walletId": "123e4567-ea9b-12d3-a456-426614174000",
  • "walletDetails": {
    }
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Get external wallet

Get external wallet. Requires READ permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

Unique identifier of the user.

walletId
required
string

Unique identifier of the wallet.

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "sherlock_holmes",
  • "walletId": "123e4567-e89b-12d3-a456-426614174000"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

List external wallets

List external wallets. Requires READ permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

Unique identifier of the user.

walletId
string

Unique identifier of the wallet.

currency
string

Currency of the wallet.

chain
string

Blockchain of the wallet.

pageNumber
number

Page number for pagination.

pageSize
number

Size of the page for pagination.

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "sherlock_holmes",
  • "walletId": "123e4567-ea9b-12d3-a456-426614174000",
  • "currency": "USDC",
  • "chain": "ETHEREUM",
  • "pageNumber": 1,
  • "pageSize": 10
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

Account

Create internal account

Create internal account. Requires READWRITE permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

Unique identifier of the user.

required
object

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "sherlock_holmes",
  • "accountDetails": {
    }
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Get internal account

Get internal account. Requires READ permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

Unique identifier of the user.

accountId
required
string

Unique identifier of the account.

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "sherlock_holmes",
  • "accountId": "123e4567-e89b-12d3-a456-426614174000"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

List internal accounts

List internal accounts. Requires READ permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

Unique identifier of the user.

accountId
string

Unique identifier of the account.

currency
string

Currency of the account.

pageNumber
number

Page number for pagination.

pageSize
number

Size of the page for pagination.

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "sherlock_holmes",
  • "accountId": "123e4567-e89b-12d3-a456-426614174000",
  • "currency": "USD",
  • "pageNumber": 1,
  • "pageSize": 10
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

List account currencies

List account currencies. Requires READ permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

Create external account

Create external account. Requires READWRITE permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

Unique identifier of the user.

counterPartyId
required
string

Unique identifier of the counterparty.

accountId
required
string

Unique identifier of the account.

required
object

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "sherlock_holmes",
  • "counterPartyId": "123e4567-ea9b-12d3-a456-426614174000",
  • "accountId": "123e4567-ea9b-12d3-a456-426614174000",
  • "accountDetails": {
    }
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

List external accounts

List external accounts. Requires READ permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

Unique identifier of the user.

accountId
string

Unique identifier of the account.

currency
string

Currency of the account.

pageNumber
number

Page number for pagination.

pageSize
number

Size of the page for pagination.

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "sherlock_holmes",
  • "accountId": "123e4567-ea9b-12d3-a456-426614174000",
  • "currency": "USD",
  • "pageNumber": 1,
  • "pageSize": 10
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

Get external account

Get external account. Requires READ permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

Unique identifier of the user.

accountId
required
string

Unique identifier of the account.

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "sherlock_holmes",
  • "accountId": "123e4567-ea9b-12d3-a456-426614174000"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Counter Party

Create counter-party

Create counter-party. Requires READWRITE permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

Unique identifier of the user.

counterPartyId
required
string

Unique identifier of the counterparty.

name
required
string

Name of the counterparty.

email
required
string

Email of the counterparty.

type
required
string
Enum: "FIRST_PARTY" "THIRD_PARTY"

Type of the counter party.

required
object

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "sherlock_holmes",
  • "counterPartyId": "123e4567-ea9b-12d3-a456-426614174000",
  • "name": "Sherlock Holmes",
  • "email": "sherlockholmes@baker.st",
  • "type": "FIRST_PARTY",
  • "kycData": {
    }
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Get counter-party

Get counter-party. Requires READ permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

Unique identifier of the user.

counterPartyId
required
string

Unique identifier of the counterparty.

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "sherlock_holmes",
  • "counterPartyId": "123e4567-ea9b-12d3-a456-426614174000"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

List counter-parties

List counter-parties. Requires READ permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

Unique identifier of the user.

type
string
Enum: "FIRST_PARTY" "THIRD_PARTY"

Type of the counter party.

status
string
Enum: "ACTIVE" "INACTIVE" "PENDING" "ON_HOLD"

Status of the counterparty.

email
string

Email of the counterparty.

counterPartyId
string

Unique identifier of the counterparty.

pageNumber
number

Page number for pagination.

pageSize
number

Size of the page for pagination.

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "sherlock_holmes",
  • "type": "FIRST_PARTY",
  • "status": "ACTIVE",
  • "email": "sherlockholmes@baker.st",
  • "counterPartyId": "123e4567-ea9b-12d3-a456-426614174000",
  • "pageNumber": 1,
  • "pageSize": 10
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

User

Create user

Create user. Requires READWRITE permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

Unique identifier of the user.

firstName
required
string

First name of the user.

lastName
required
string

Last name of the user.

email
required
string

Email of the user.

userType
required
string
Enum: "CONSUMER" "EMPLOYEE" "RESERVED"

Type of the user.

required
object

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "sherlock_holmes",
  • "firstName": "Sherlock",
  • "lastName": "Holmes",
  • "email": "sherlockholmes@baker.st",
  • "userType": "CONSUMER",
  • "kycData": {
    }
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Get user

Get user. Requires READ permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

Unique identifier of the user.

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "sherlock_holmes"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

List users

List users. Requires READ permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
pageNumber
number

Page number for pagination.

pageSize
number

Size of the page for pagination.

orgUserId
string

Unique identifier of the user.

email
string

Email of the user.

userType
string
Enum: "CONSUMER" "EMPLOYEE" "RESERVED"

Type of the user.

userStatus
string
Enum: "PENDING" "ACTIVE" "INACTIVE" "DELETED"

Status of the user.

Responses

Request samples

Content type
application/json
{
  • "pageNumber": 1,
  • "pageSize": 10,
  • "orgUserId": "sherlock_holmes",
  • "email": "sherlockholmes@baker.st",
  • "userType": "CONSUMER",
  • "userStatus": "ACTIVE"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

Order

Create quote

Create quote. Requires READWRITE permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

Unique identifier of the user.

symbol
required
string

The trading pair symbol for the quote.

operation
required
string
Enum: "BUY" "SELL"

The operation type for the quote.

quantity
number

The crypto amount for the quote.

quoteQuantity
number

The fiat amount for the quote.

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "sherlock_holmes",
  • "symbol": "USDC_USD",
  • "operation": "BUY",
  • "quantity": 100,
  • "quoteQuantity": 101
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Create order

Create order. Requires READWRITE permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

Unique identifier of the user.

clientOrderId
string

Unique identifier for the order.

symbol
required
string

The trading pair symbol for the order.

operation
required
string
Enum: "BUY" "SELL"

The operation type for the order.

type
string
Enum: "RFQ" "LIMIT" "MARKET" "STOPLOSS"

The type of the order.

quantity
number

The crypto amount for the order.

quoteQuantity
number

The fiat amount for the order.

price
number

The conversion rate between the two currencies.

kind
string
Enum: "GOOD_TILL_CANCEL" "GOOD_TILL_WEEK" "GOOD_TILL_DAY" "IMMEDIATE_OR_CANCEL" "FILL_OR_KILL" "GOOD_TILL_DATE"

The kind of the order.

expiryDate
string <date-time>

The expiry date of the order.

slippage
number

The slippage for the order.

quoteId
number

The unique identifier of the quote.

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "sherlock_holmes",
  • "clientOrderId": "order_123456",
  • "symbol": "USDC_USD",
  • "operation": "BUY",
  • "type": "RFQ",
  • "quantity": 100,
  • "quoteQuantity": 101,
  • "price": 1.01,
  • "kind": "GOOD_TILL_DAY",
  • "expiryDate": "2023-10-01T00:00:00Z",
  • "slippage": 0.5,
  • "quoteId": 123456
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Get order

Get order. Requires READ permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

Unique identifier of the user.

orderId
required
number

The unique identifier of the order.

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "sherlock_holmes",
  • "orderId": 123456
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

List orders

List orders. Requires READ permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

Unique identifier of the user.

status
string
Enum: "OPEN" "COMPLETED" "CANCELLED" "REJECTED"

Status of the order.

pageNumber
required
integer <int32>
pageSize
required
integer <int32>

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "sherlock_holmes",
  • "status": "OPEN",
  • "pageNumber": 1,
  • "pageSize": 10
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

Transfer

Create internal transfer

Create internal transfer. Requires READWRITE permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
transferId
string

The ID of the transfer.

required
object
required
object

Responses

Request samples

Content type
application/json
{
  • "transferId": "123e4567-ea9b-12d3-a456-426614174000",
  • "from": {
    },
  • "to": {
    }
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Create external transfer

Create external transfer. Requires READWRITE permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
required
object
required
object or object
transferId
required
string

The ID of the transfer.

Responses

Request samples

Content type
application/json
{
  • "from": {
    },
  • "to": {
    },
  • "transferId": "123e4567-ea9b-12d3-a456-426614174000"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Get a transfer

Get a transfer. Requires READ permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

The ID of the user in the organization.

currency
required
string

The currency of the transfer.

transferId
required
string

The ID of the transfer.

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "sherlock_holmes",
  • "currency": "USDC",
  • "transferId": "123e4567-ea9b-12d3-a456-426614174000"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

List transfers

List transfers. Requires READ permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string

The ID of the user in the organization.

currency
required
string

The currency of the transfer.

transferId
string

The ID of the transfer.

pageNumber
integer <int32>
pageSize
integer <int32>

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "sherlock_holmes",
  • "currency": "USDC",
  • "transferId": "123e4567-ea9b-12d3-a456-426614174000",
  • "pageNumber": 1,
  • "pageSize": 10
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

Payment

List currencies

List currencies. Requires READ permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

Miscellaneous

List countries

List countries. Requires READ permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

Get conversion rate

Get conversion rate. Requires READ permission for OpenLoop.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
required
object
required
object

Responses

Request samples

Content type
application/json
{
  • "from": {
    },
  • "to": {
    }
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

org

Fetch balance of your org

Fetch token balances of your org. Requires READ permissions for Org.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

otc

create an otc order for the user

Returns the created order along with details. (Requires READWRITE permission on OTC.)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
One of
orgUserId
required
string
symbol
required
string
quoteQuantity
required
number

quoteQuantity is the local currency amount you want to buy or sell crypto for. Eg: If if you want to buy 1000 AED worth of BTC, you’ll have quoteQuantity 1000 on BTC_AED. If you’re selling 1000 AED quoteQuantity of BTC, quoteQuantity is 1000. Not quantity should be zero in both cases.

operation
required
string
Enum: "BUY" "SELL"
type
string (OrderType)
Enum: "MARKET" "LIMIT"
clientOrderId
string

this is an idempotency key to avoid duplicate orders due to network failures

Responses

Request samples

Content type
application/json
Example
{
  • "orgUserId": "barabara_allen",
  • "symbol": "ETH_AED",
  • "quoteQuantity": 1000,
  • "operation": "BUY",
  • "type": "MARKET",
  • "clientOrderId": "unique-uuid"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

get all orders for a user

Returns the created orders for the user. (Requires READ permission on OTC.)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string
pageNumber
integer <int32>
pageSize
integer <int32>
fromDate
string <date>
toDate
string <date>
status
string
productType
string

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "barbara_allen",
  • "pageNumber": 1,
  • "pageSize": 1,
  • "fromDate": "2023-03-02",
  • "toDate": "2023-03-02",
  • "status": "OPEN",
  • "productType": "LOYALTY"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": [
    ],
  • "error": null
}

fetch the details of a particular order

Returns the details of a particular order. (Requires READ permission on OTC.)

Authorizations:
ApiKeyAuth
path Parameters
orderId
required
string

orderId of the order for which details needs to be fetched

header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

generate a quote for the user

Returns the quote. Either quantity or quoteQuantity must be provided, but not both. (Requires WRITE permission on OTC.)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
One of
quantity
required
number
orgUserId
string
symbol
string
operation
string

Responses

Request samples

Content type
application/json
{
  • "quoteQuantity": 200,
  • "orgUserId": "barabara_allen",
  • "symbol": "ETH_AED",
  • "operation": "BUY"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

Paginated query to fetch multiple orders by orderIds for an org

Returns list of orders for the org. (Requires READ permission on Trading.)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
pageNumber
integer <int32>
pageSize
integer <int32>
orderIds
required
Array of integers

Responses

Request samples

Content type
application/json
{
  • "pageNumber": 1,
  • "pageSize": 2,
  • "orderIds": [
    ]
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": [
    ],
  • "error": null
}

report

get all CAS for an Org

Returns the CAS statements for the org.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
pageNumber
integer <int32>
pageSize
integer <int32>
fromDate
string <date>
toDate
string <date>

Responses

Request samples

Content type
application/json
{
  • "pageNumber": 1,
  • "pageSize": 1,
  • "fromDate": "2023-03-02",
  • "toDate": "2023-03-02"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": [
    ],
  • "error": null
}

Fetch all successful transactions for an org for given orgSettlementId

Fetches all successful transactions for an org against a given orgSettlementId. Note: Pagination is applicable only for json response.

Authorizations:
ApiKeyAuth
Request Body schema: application/json
required
orgSettlementId
string
toJson
boolean
pageNumber
number or null
pageSize
number or null

Responses

Request samples

Content type
application/json
{
  • "orgSettlementId": "95606754-8c6e-45b7-b7e4-1ae9ccffb31f",
  • "toJson": true,
  • "pageNumber": 0,
  • "pageSize": 50
}

Response samples

Content type
{
  • "code": 200,
  • "data": [
    ],
  • "error": null
}

Send consolidated settlement report for an org via email for a given time period

Sends consolidated settlement report for an org via email for a given time period

Authorizations:
JWT
Request Body schema: application/json
required
from
string
to
string
orgUserId
string
orgId
integer

Responses

Request samples

Content type
application/json
{
  • "from": "2023-05-01",
  • "to": "2023-05-31",
  • "orgUserId": "user_1",
  • "orgId": 135
}

Response samples

Content type
application/csv
{
  "code": 200,
  "error": null,
  "data": "Your request to send transactions via email is registered successfully"
}

payment

Request invoice by a customer

Request invoice by a customer. (Requires READWRITE permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
targetOrgUuid
required
string
currency
required
string
amount
required
number
idempotencyKey
string
notes
string

Responses

Request samples

Content type
application/json
{
  • "targetOrgUuid": "ABC123123",
  • "currency": "USD",
  • "amount": 100,
  • "idempotencyKey": "asbasda",
  • "notes": "test test"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

Generate upload link to upload invoice file

Generate upload link to upload invoice file. (Requires READWRITE permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
fileName
required
string
orgId
number or null
entityName
string or null

Responses

Request samples

Content type
application/json
{
  • "fileName": "example.pdf",
  • "orgId": 1,
  • "entityName": "INVOICES"
}

Response samples

Content type
application/json
{}

Generate download link for an invoice file

Generate download link for an invoice file

Authorizations:
UserAuth
Request Body schema: application/json
required
invoiceId
required
number <int32>

Responses

Request samples

Content type
application/json
{
  • "invoiceId": 1
}

Response samples

Content type
application/json
{}

Fetch invoice for a customer

Fetch invoice for a customer. (Requires READ permission for Payment)

Authorizations:
ApiKeyAuth
path Parameters
invoiceId
required
string

invoiceId for which the api needs to be called

header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

Cancel invoice for a customer

Cancel invoice for a customer. (Requires READ permission for Payment)

Authorizations:
ApiKeyAuth
path Parameters
invoiceId
required
string

invoiceId for which the api needs to be called

header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
reason
string

Responses

Request samples

Content type
application/json
{
  • "reason": "Customer rejected the buy"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": "SUCCESS"
}

Get all invoices for a customer

Get all invoices for a customer. (Requires READ permission for Payment)

Authorizations:
ApiKeyAuth
query Parameters
status
string

status of each invoice. Example: PAID

pageNumber
integer

offset of the page. Default is 0.

pageSize
integer

number of records to fetch in a page. Default is 50.

fromDate
string

used for date range. should be in YYYY-MM-DD

toDate
string

used for date range. should be in YYYY-MM-DD

header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

Request payment by a customer

Request payment by a customer. (Requires READWRITE permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string
symbol
required
string
quantity
required
number

quantity is how much you’re buying or selling. Eg: If you’re buying 0.01 BTC, the quantity is 0.01. If you’re selling 0.01 BTC, quantity is 0.01.

operation
required
string
Enum: "BUY" "SELL"
quoteId
string

generated quote id for the crypto to fiat leg

invoiceId
string

invoice that the client is paying

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "barabara_allen",
  • "symbol": "ETH_AED",
  • "quantity": 0.01,
  • "operation": "BUY",
  • "quoteId": "unique-uuid",
  • "invoiceId": "unique-uuid"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": "SUCCESS"
}

Search in the address book

Search in the address book. (Requires READWRITE permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
email
string
name
string

Responses

Request samples

Content type
application/json
{
  • "email": "test@test.com",
  • "name": "test"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Create an entry in the address book

Create an entry in the address book. (Requires READWRITE permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
email
string
name
string

Responses

Request samples

Content type
application/json
{
  • "email": "test@test.com",
  • "name": "TESTNAME"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Delete from the address book

Delete from the address book. (Requires READWRITE permission for Payment)

Authorizations:
ApiKeyAuth
path Parameters
addressBookId
required
string

addressBookId which needs to be deleted

header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": "SUCCESS"
}

Get all payouts for a dealer

Get all payouts for a dealer. (Requires READ permission for Payment)

Authorizations:
ApiKeyAuth
query Parameters
status
string

status of each invoice. Example: PAID

pageNumber
integer

offset of the page. Default is 0.

pageSize
integer

number of records to fetch in a page. Default is 50.

fromDate
string

used for date range. should be in YYYY-MM-DD

toDate
string

used for date range. should be in YYYY-MM-DD

header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

Get earnings for a dealer

Get earnings for a dealer. (Requires READ permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Get invoice file from AWS S3 bucket

Get invoice file from AWS S3 bucket

Authorizations:
UserAuth
query Parameters
bucket
required
string

name of the S3 bucket.

key
required
string

key for the object in the bucket.

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Create a property

Create a property. (Requires READWRITE permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
name
string
businessName
string
beneficiaryName
string
bankName
string
bankCountry
string
transferDetails
string

Responses

Request samples

Content type
application/json
{
  • "name": "Property Name",
  • "businessName": "A123TZ456",
  • "beneficiaryName": "Beneficiary Name",
  • "bankName": "ENBD",
  • "bankCountry": "UAE",
  • "transferDetails": "{\"iban\": \"IBAN01234\"}"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Fetch the list of properties

Fetch the list of properties. (Requires READWRITE permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

Create an invoice for a property

Create an invoice for a property. (Requires READWRITE permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
targetOrgUuid
required
string
currency
required
string
amount
required
number
idempotencyKey
string
notes
string

Responses

Request samples

Content type
application/json
{
  • "targetOrgUuid": "ABC123123",
  • "currency": "USD",
  • "amount": 100,
  • "idempotencyKey": "asbasda",
  • "notes": "test test"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

Create third-party for payment gateway

Create third-party for payment gateway. (Requires READWRITE permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
email
required
string
type
required
string
Enum: "FIRST_PARTY" "THIRD_PARTY"
clientIdentifier
required
string
required
object

Responses

Request samples

Content type
application/json
{
  • "email": "sherlockholmes@baker.st",
  • "type": "THIRD_PARTY",
  • "clientIdentifier": "SH123456",
  • "kycData": {
    }
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Get third party details for the clientIdentifier

Get third party details for the clientIdentifier. (Requires READ permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
clientIdentifier
required
string

Responses

Request samples

Content type
application/json
{
  • "clientIdentifier": "SH123456"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Get third-party list for payment gateway

Get third-party list for payment gateway. (Requires READWRITE permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
pageNumber
integer <int32>
pageSize
integer <int32>

Responses

Request samples

Content type
application/json
{
  • "pageNumber": 1,
  • "pageSize": 1
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

Create a crypto deposit wallet for the third party

Create a crypto deposit wallet for the third party. (Requires READWRITE permission for Bank)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
clientIdentifier
required
string
symbol
required
string
chain
required
string

Responses

Request samples

Content type
application/json
{
  • "clientIdentifier": "sherlockholmes",
  • "symbol": "USDC_AED",
  • "chain": "ETHEREUM"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Get the list of crypto deposit wallets for the third party

Get the list of crypto deposit wallets for the third party. (Requires READWRITE permission for Bank)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

Create a payin for a third party

Create a payin for a third party. (Requires READWRITE permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
clientIdentifier
required
string
symbol
required
string
chain
required
number
quantity
required
number
clientOrderId
string

Responses

Request samples

Content type
application/json
{
  • "clientIdentifier": "sherlockholmes",
  • "symbol": "USDC_USD",
  • "chain": "ETHEREUM",
  • "quantity": 123.45,
  • "clientOrderId": "21a0194f-709e-4c62-8590-464ddb9abd8f"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

Get status of a payin for a third party

Get status of a payin for a third party. (Requires READWRITE permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
clientOrderId
required
string

Responses

Request samples

Content type
application/json
{
  • "clientOrderId": "SH123456"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

Get list of payins for a merchant

Get list of payins for a merchant. (Requires READWRITE permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
pageNumber
integer <int32>
pageSize
integer <int32>
fromDate
string <date>
toDate
string <date>
status
string
Enum: "KYC_PENDING" "CREATED" "TXN_CREATED" "INITIATED" "UNDERPAID" "PAID" "OVERPAID" "SETTLED" "CANCELLED" "REJECTED" "QUOTE_EXPIRED"

Responses

Request samples

Content type
application/json
{
  • "pageNumber": 1,
  • "pageSize": 1,
  • "fromDate": "2023-03-02",
  • "toDate": "2023-03-02",
  • "status": "KYC_PENDING"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": [
    ],
  • "error": null
}

Create quote for a payout for a third party

Create quote a payout for a third party. (Requires READWRITE permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
clientIdentifier
required
string
symbol
required
string
operation
string
Enum: "BUY" "SELL"
chain
required
string
quantity
required
number
clientOrderId
string

Responses

Request samples

Content type
application/json
{
  • "clientIdentifier": "sherlockholmes",
  • "symbol": "USDC_USD",
  • "operation": "BUY",
  • "chain": "ETHEREUM",
  • "quantity": 123.45,
  • "clientOrderId": "21a0194f-709e-4c62-8590-464ddb9abd8f"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

Create a payout for a third party

Create a payout for a third party. (Requires READWRITE permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
clientIdentifier
required
string

Unique identifier for the client

address
required
string

Wallet address of the external party

chain
required
string

Blockchain for the wallet

walletType
required
string

Type of the wallet

quoteId
number

Quote ID for the payout

symbol
string

Symbol for the payout

quantity
number

Quantity for the payout

clientOrderId
string

Unique identifier for the payout

Responses

Request samples

Content type
application/json
{
  • "clientIdentifier": "sherlock_holmes",
  • "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f4sk",
  • "chain": "ETHEREUM",
  • "walletType": "CUSTODIAL",
  • "quoteId": 123,
  • "symbol": "USDC_USD",
  • "quantity": 123.45,
  • "clientOrderId": "21a0194f-709e-4c62-8590-464ddb9abd8f"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": "SUCCESS",
  • "error": null
}

Get status of a payout for a third party

Get status of a payout for a third party. (Requires READWRITE permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
clientOrderId
required
string

Responses

Request samples

Content type
application/json
{
  • "clientOrderId": "SH123456"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": "SUCCESS"
}

Get list of payouts for a merchant

Get list of payouts for a merchant. (Requires READWRITE permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
pageNumber
integer <int32>
pageSize
integer <int32>
fromDate
string <date>
toDate
string <date>
status
string
Enum: "KYC_PENDING" "CREATED" "TXN_CREATED" "INITIATED" "UNDERPAID" "PAID" "OVERPAID" "SETTLED" "CANCELLED" "REJECTED" "QUOTE_EXPIRED"

Responses

Request samples

Content type
application/json
{
  • "pageNumber": 1,
  • "pageSize": 1,
  • "fromDate": "2023-03-02",
  • "toDate": "2023-03-02",
  • "status": "KYC_PENDING"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": [
    ],
  • "error": null
}

Validate an address for a given chain

Validate an address for a given chain. (Requires READ permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
address
required
string
chain
required
string

Responses

Request samples

Content type
application/json
{
  • "address": "0x742d35Cc6634C0532925a3b844Bc454e4438f4sk",
  • "chain": "ETHEREUM"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Internal transfer of asset between users

Internal transfer of asset between users. (Requires READWRITE permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
sourceOrgUserId
required
string
destinationOrgUserId
required
string
currency
required
string
quantity
required
number

Responses

Request samples

Content type
application/json
{
  • "sourceOrgUserId": "barbara_allen",
  • "destinationOrgUserId": "barbara_allen_1",
  • "currency": "BTC",
  • "quantity": 0.01
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": "OK"
}

Create third-party for remittance

Create third-party for remittance. (Requires READWRITE permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
name
string
email
string
address
string
nationality
string
country
string
idType
string
idNumber
string
type
string
clientIdentifier
string

Responses

Request samples

Content type
application/json
{
  • "name": "Nick",
  • "email": "nickfury@gmail.com",
  • "address": "1-A, Baker Street",
  • "nationality": "British",
  • "country": "UK",
  • "idType": "EID",
  • "idNumber": "123456789",
  • "type": "ORIGINATOR",
  • "clientIdentifier": "NICK123456"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Create third-party with beneficiary account for remittance

Create third-party with beneficiary account for remittance. (Requires READWRITE permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
name
string
email
string
address
string
nationality
string
country
string
idType
string
idNumber
string
type
string
clientIdentifier
string
object

Responses

Request samples

Content type
application/json
{
  • "name": "Nick",
  • "email": "nickfury@gmail.com",
  • "address": "1-A, Baker Street",
  • "nationality": "British",
  • "country": "UK",
  • "idType": "EID",
  • "idNumber": "123456789",
  • "type": "ORIGINATOR",
  • "clientIdentifier": "NICK123456",
  • "account": {
    }
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Get third party list i.e. originator list

Get third party list i.e. originator list. (Requires READ permission for Payment)

Authorizations:
ApiKeyAuth
Request Body schema: application/json
required
pageNumber
integer <int32>
pageSize
integer <int32>
search
string

Responses

Request samples

Content type
application/json
{
  • "pageNumber": 1,
  • "pageSize": 1,
  • "search": "Nick"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Get third-party for remittance

Get third-party for remittance. (Requires READ permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
clientIdentifier
required
string

Responses

Request samples

Content type
application/json
{
  • "clientIdentifier": "SH123456"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Create an account for the third party

Create an account for the third party. (Requires READWRITE permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
clientIdentifier
string
object
currency
string
country
string
accountType
string

Responses

Request samples

Content type
application/json
{
  • "clientIdentifier": "NICK123456",
  • "accountData": {
    },
  • "currency": "USD",
  • "country": "UK",
  • "accountType": "BANK"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Get third-party account for remittance

Get third-party account for remittance. (Requires READ permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
clientIdentifier
required
string

Responses

Request samples

Content type
application/json
{
  • "clientIdentifier": "SH123456"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Deletes an account for the third party

Deletes an account for the third party. (Requires READWRITE permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
clientIdentifier
required
string

Responses

Request samples

Content type
application/json
{
  • "clientIdentifier": "SH123456"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": "SUCCESS"
}

Create quote for remittance for a third party

Create quote for remittance for a third party. (Requires READWRITE permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
quoteId
number
quantity
number
fromCurrency
string
toCurrency
string

Responses

Request samples

Content type
application/json
{
  • "quoteId": 1,
  • "quantity": 100,
  • "fromCurrency": "AED",
  • "toCurrency": "INR"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Create payment for remittance quote for a third party

Create payment for remittance quote for a third party. (Requires READWRITE permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
quantity
number
quoteId
number

Responses

Request samples

Content type
application/json
{
  • "quantity": 100,
  • "quoteId": 2
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Get payment details for remittance quote for a third party

Get payment details for remittance quote for a third party. (Requires READ permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
uuid
string

Responses

Request samples

Content type
application/json
{
  • "uuid": "SH123456"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Create a payout for a third party

Create a payout for a third party. (Requires READWRITE permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
currency
string
amount
number
clientOrderId
string
uuid
string
purpose
string

Responses

Request samples

Content type
application/json
{
  • "currency": "INR",
  • "amount": 100,
  • "clientOrderId": "21a0194f-709e-4c62-8590-464ddb9abd8f",
  • "uuid": "21a0194f-709e-4c62-8590-464ddb9abd8f",
  • "purpose": "SALARY"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Get payout list for an originator

Get payout list for an originator. (Requires READ permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
pageNumber
integer <int32>
pageSize
integer <int32>
search
string
currency
string
fromDate
string
toDate
string

Responses

Request samples

Content type
application/json
{
  • "pageNumber": 1,
  • "pageSize": 1,
  • "search": "Nick",
  • "currency": "INR",
  • "fromDate": "2023-03-02",
  • "toDate": "2023-03-02"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

Get payout info for an originator

Get payout info for an originator. (Requires READ permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
clientOrderId
required
string

Responses

Request samples

Content type
application/json
{
  • "clientOrderId": "SH123456"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

policy

create policy for the org

create policy for the org. (Requires READWRITE permission for policy)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
string
policyName
string
parameters
object
action
string

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "admin@fuze.finance",
  • "policyName": "ASSET_EXPOSURE",
  • "parameters": { },
  • "action": "ACCEPT"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

delete policy for your org

delete policy for your org. (Requires READWRITE permission for policy)

Authorizations:
ApiKeyAuth
path Parameters
policyId
required
string

policyId of the org that needs to be deleted

header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Fetch policy for your org

Fetch policy for your org. (Requires READ permission for policy)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
string
policyName
string
action
string

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "barbara_allen",
  • "policyName": "ASSET_EXPOSURE",
  • "action": "ACCEPT"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

price

Fetch historical price

Fetches historical prices of a currency pair averaged over a window of 60 seconds. (Requires READ permissions for Price.)

Authorizations:
ApiKeyAuth
query Parameters
symbol
string

The symbol for which historical prices are required

fromTimestampInSecs
number

start time stamp for the history of prices

toTimestampInSecs
number

end time stamp for the history of prices

avgtimeBucketInSecs
number

time bucket for averaging the price points

header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": [
    ]
}

Fetch current price of a symbol

Fetches current price of a currency pair.

Authorizations:
PublicAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
symbol
string
side
string
quantity
number or null
quoteQuantity
number or null

Responses

Request samples

Content type
application/json
{
  • "symbol": "BTC_USD",
  • "side": "BUY",
  • "quantity": 1,
  • "quoteQuantity": 1
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    }
}

Fetch current price of a symbol

Fetches current price of a currency pair. (Requires READ permissions for Price.)

Authorizations:
ApiKeyAuth
path Parameters
symbol
required
string

The symbol for which current price needs to be fetched.

header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    }
}

Fetch candle price for the symbol

Fetches candle price of a currency pair. (Requires READ permissions for Price.)

Authorizations:
ApiKeyAuth
path Parameters
symbol
required
string

The symbol for which candle price needs to be fetched.

header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    }
}

PaymentGateway

Fetches transactions made on the payment link.

Fetches transactions made on the payment link.

Authorizations:
PublicAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
uuid
required
string <uuid> <= 128 characters

UUID of the public payment link.

Responses

Request samples

Content type
application/json
{
  • "uuid": "793da5d5-b971-4d55-af84-3a40fee24e6e"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

Selects asset details for a payment link

Selects asset details for a payment link

Authorizations:
PublicAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
uuid
required
string <uuid> <= 128 characters

UUID of the public payment link.

asset
string

The cryptocurrency asset using which the payment would be made.

chain
string

The blockchain network chain for the asset.

Responses

Request samples

Content type
application/json
{
  • "uuid": "793da5d5-b971-4d55-af84-3a40fee24e6e",
  • "asset": "ETH",
  • "chain": "ETHEREUM"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Returns the quote for a public payment link.

Returns the quote for a public payment link using the provided UUID.

Authorizations:
PublicAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
uuid
required
string <uuid> <= 128 characters

UUID of the public payment link.

Responses

Request samples

Content type
application/json
{
  • "uuid": "793da5d5-b971-4d55-af84-3a40fee24e6e"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": "OK",
  • "error": null
}

Create a third party.

Create a third party. (Requires READWRITE permission for PaymentGateway)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
email
string

Email of third party.

clientIdentifier
string

The client identifier of the third party.

object

Responses

Request samples

Content type
application/json
{
  • "email": "sherlockholmes@baker.st",
  • "clientIdentifier": "sherlock_holmes",
  • "kycData": {
    }
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Get list of payins for a payment link

Get list of payins for a payment link. (Requires READWRITE permission for Payment)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
uuid
string

UUID of payment link.

pageNumber
integer <int32>
pageSize
integer <int32>
fromDate
string <date>
toDate
string <date>
status
string
Enum: "KYC_PENDING" "CREATED" "TXN_CREATED" "INITIATED" "UNDERPAID" "PAID" "OVERPAID" "SETTLED" "CANCELLED" "REJECTED" "QUOTE_EXPIRED"

Responses

Request samples

Content type
application/json
{
  • "uuid": "ff3f899e-04a9-48a0-81e3-547ec5c03a42",
  • "pageNumber": 1,
  • "pageSize": 1,
  • "fromDate": "2023-03-02",
  • "toDate": "2023-03-02",
  • "status": "KYC_PENDING"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": [
    ],
  • "error": null
}

revenue

create revenue policy for the org

create revenue policy for the org. (Requires READWRITE permission for revenue)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string
policyName
required
string
parameters
required
object
action
required
string
Enum: "ACCEPT" "REJECT" "NOTIFY"

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "admin@fuze.finance",
  • "policyName": "ORG_VAT",
  • "parameters": { },
  • "action": "ACCEPT"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Get markup history

Get markup history (Requires READWRITE permission for policy)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
pageNumber
integer
pageSize
integer
orgUserId
string
sort
string

Responses

Request samples

Content type
application/json
{
  • "pageNumber": 1,
  • "pageSize": 2,
  • "orgUserId": "*",
  • "sort": "createdAt:DESC"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}

trading

create a trading order for the user

Returns the created order along with details. (Requires READWRITE permission on Trading.)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
One of
orgUserId
required
string
symbol
required
string
quoteQuantity
required
number

quoteQuantity is the local currency amount you want to buy or sell crypto for. Eg: If if you want to buy 1000 AED worth of BTC, you’ll have quoteQuantity 1000 on BTC_AED. If you’re selling 1000 AED quoteQuantity of BTC, quoteQuantity is 1000. Not quantity should be zero in both cases.

operation
required
string
Enum: "BUY" "SELL"
type
string (OrderType)
Enum: "MARKET" "LIMIT"
clientOrderId
string

this is an idempotency key to avoid duplicate orders due to network failures

Responses

Request samples

Content type
application/json
Example
{
  • "orgUserId": "barabara_allen",
  • "symbol": "ETH_AED",
  • "quoteQuantity": 1000,
  • "operation": "BUY",
  • "type": "MARKET",
  • "clientOrderId": "unique-uuid"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

get all orders for a user

Returns the created orders for the user. (Requires READ permission on Trading.)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
orgUserId
required
string
pageNumber
integer <int32>
pageSize
integer <int32>
fromDate
string <date>
toDate
string <date>
status
string
productType
string

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "barbara_allen",
  • "pageNumber": 1,
  • "pageSize": 1,
  • "fromDate": "2023-03-02",
  • "toDate": "2023-03-02",
  • "status": "OPEN",
  • "productType": "LOYALTY"
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": [
    ],
  • "error": null
}

Paginated query to fetch multiple orders by orderIds for an org

Returns list of orders for the org. (Requires READ permission on Trading.)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
pageNumber
integer <int32>
pageSize
integer <int32>
orderIds
required
Array of integers

Responses

Request samples

Content type
application/json
{
  • "pageNumber": 1,
  • "pageSize": 2,
  • "orderIds": [
    ]
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": [
    ],
  • "error": null
}

fetch the details of a particular order

Returns the details of a particular order. (Requires READ permission on Trading.)

Authorizations:
ApiKeyAuth
path Parameters
orderId
required
string

orderId of the order for which details needs to be fetched

header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

cancel a limit order

Cancels a LIMIT order. (Requires WRITE permission on Trading.)

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
orgUserId
required
string
orderId
required
number

the orderId of the order to cancel

Responses

Request samples

Content type
application/json
{
  • "orgUserId": "barabara_allen",
  • "orderId": 1001
}

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

fetch orders for a given settlementID (orgSettlementID)

Fetches all orders for a given settlementID

Authorizations:
ApiKeyAuth
path Parameters
settlementId
required
string

settlementId for which order needs to be fetched

header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "data": {
    },
  • "error": null
}

webhook

Upsert webhook for an organisation.

Upsert webhook for an organisation. Requires READWRITE permission for Webhook.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number
Request Body schema: application/json
required
url
required
string
secret
required
string

Responses

Request samples

Content type
application/json
{}

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": {
    }
}

Get all webhooks for an organisation.

Get webhook for an organisation. Requires READ permission for Webhook.

Authorizations:
ApiKeyAuth
header Parameters
X-SIGNATURE
required
string
X-TIMESTAMP
required
number

Responses

Response samples

Content type
application/json
{
  • "code": 200,
  • "error": null,
  • "data": [
    ]
}