Customer Data APIs

Overview

Bitwave supports a robust ingestion of customer data from custom applications such as exchanges and more. This capability accomplishes two goals - first, collecting customer data for cost basis and gain / loss reporting, and second, collecting commission information for on the books revenue and tax recognition purposes.

Step

Name

Description

0

Generate API Key

Follow the steps outlined in the API Reference to create an API

1

Submit Customer Transactions

There are two types of transactions you can submit from customer standpoint - a trade or a transfer. A transfer implies the movement of coins or fiat into or out of your exchange, and includes any fee information as part of that transaction.

A trade is the exchange of digital assets from one individual to another, or from your exchange to a customer.

2

Fill in cost basis data

In order to generate gain / loss report data, we need to understand the full cost basis history for a customer. In the case where a customer moved assets onto your platform, we need to capture that data

3

Generate reports

The final step on a yearly basis is to generate a customer report. We do this at a particular point in time so that all data is captured.

Customer Data APIs

Endpoint

Schema

TransactionID

Retrieves relevant information regarding transaction based off of a transaction ID

/orgs/{orgId}/customers/-/transactions/{transactionId}

Transactions

Fetches information about the transaction as well as the customer(s) involved

/orgs/{orgId}/customers/{customerId}/transactions

Gain/Loss Report

Executes the Gain/Loss Report and returns a copy of the report

/orgs/{orgId}/customers/{customerId}/reports/gainLossReport

Reports

Returns all the reports for that customer

/orgs/{orgId}/customers/{customerId}/reports