These docs are for v2.0. Click to read the latest docs for v3.0.

Get user balance history

Fetch your balance history, an overview of sales, purchases and commissions.

🚧

The Market API will be discontinued, in Q3 2024 we will be sunsetting this product

Request Endpoint: reference

GET /user/credits/{currency}/history
ParameterParam TypeDescriptionData TypeMandatory
currencyPathThe currency to filter byString✅

Example Request:

GET https://api.venly.market/user/credits/USDC/history

Response Body:

📘

Gross: The total amount of the offer
Net: The value that impacts your balance
Fees: The difference between gross and net. Fees that are taken by the market and the collection/contract owner

{ "success": true, "result": [ { "date": "2021-06-22T19:44:35.896220", "userId": "fd5a4ee7-2cf8-4f33-8978-3649bc447482", "type": "DEPOSIT", "reference": { "id": "2367d75e-7e52-45e1-98b7-3ac6ded9e7f1", "type": "ORDER" }, "gross": 1.00, "net": 1.00, "fees": [] }, { "date": "2021-06-15T20:59:05.609988", "userId": "fd5a4ee7-2cf8-4f33-8978-3649bc447482", "type": "DEPOSIT", "reference": { "id": "935870c1-82d5-4f8a-a869-61af6367cda9", "type": "ORDER" }, "gross": 100, "net": 100, "fees": [] }, { "date": "2021-06-15T20:57:04.647446", "userId": "fd5a4ee7-2cf8-4f33-8978-3649bc447482", "type": "DEPOSIT", "reference": { "id": "e95e4717-b720-4560-984b-8847ef37b641", "type": "ORDER" }, "gross": 10, "net": 10, "fees": [] }, { "date": "2021-06-09T15:14:16.335428", "userId": "fd5a4ee7-2cf8-4f33-8978-3649bc447482", "type": "SELL", "reference": { "id": "a71940cf-18cc-4289-bcad-ddbbfe2b94bf", "type": "OFFER" }, "gross": 1, "net": 0.88, "fees": [ { "type": "MARKET_FEE", "percentage": 2.0, "amount": -0.02 }, { "type": "CONTRACT_OWNER_FEE", "percentage": 10.0, "amount": -0.10 } ] }, { "date": "2021-06-03T13:24:56.787113", "userId": "fd5a4ee7-2cf8-4f33-8978-3649bc447482", "type": "DEPOSIT", "reference": { "id": "c8a9929e-086d-466f-975c-24dccdc16f78", "type": "ORDER" }, "gross": 25, "net": 25, "fees": [] }, { "date": "2021-06-03T12:55:32.066130", "userId": "fd5a4ee7-2cf8-4f33-8978-3649bc447482", "type": "SELL", "reference": { "id": "f1685c66-2ae9-40b6-ba0b-fc613567fb43", "type": "OFFER" }, "gross": 1.2555, "net": 1.0955, "fees": [ { "type": "CONTRACT_OWNER_FEE", "percentage": 10.4, "amount": -0.13 }, { "type": "MARKET_FEE", "percentage": 2.4, "amount": -0.03 } ] }, { "date": "2021-06-03T12:49:44.472909", "userId": "fd5a4ee7-2cf8-4f33-8978-3649bc447482", "type": "SELL", "reference": { "id": "a8fb5ce7-3053-4bd3-af1a-9d5df5caf280", "type": "OFFER" }, "gross": 25, "net": 22.00, "fees": [ { "type": "CONTRACT_OWNER_FEE", "percentage": 10.0, "amount": -2.50 }, { "type": "MARKET_FEE", "percentage": 2.0, "amount": -0.50 } ] }, { "date": "2021-06-03T12:45:22.301144", "userId": "fd5a4ee7-2cf8-4f33-8978-3649bc447482", "type": "PURCHASE", "reference": { "id": "ead1f572-820c-44b7-b5bd-06ee8ac3f0fd", "type": "OFFER" }, "gross": -14.25, "net": -14.25, "fees": [] }, { "date": "2021-06-03T12:38:05.753383", "userId": "fd5a4ee7-2cf8-4f33-8978-3649bc447482", "type": "PURCHASE", "reference": { "id": "85149572-dfae-465f-b2d5-dad666c57487", "type": "OFFER" }, "gross": -14, "net": -14, "fees": [] }, { "date": "2021-06-03T12:22:45.753397", "userId": "fd5a4ee7-2cf8-4f33-8978-3649bc447482", "type": "PURCHASE", "reference": { "id": "71b35b5b-c9c7-44f2-b986-34161f97dce2", "type": "OFFER" }, "gross": -5, "net": -5, "fees": [] } ] }

Did this page help you?