Volcano API
๐Ÿš€ API Endpoints

๐Ÿ’ธ Transaction Management

Transaction records and payment processing endpoints. 11 endpoints available.

๐ŸŽฏ Quick Stats

๐Ÿ“Š Methods

  • ๐Ÿ” GET: 11 endpoints

๐Ÿ” Authentication

All endpoints in this section use the same authentication methods. Choose one:

๐Ÿ”‘ Bearer Token (Recommended)

For user session authentication

Add to request headers:

Authorization: Bearer YOUR_TOKEN

๐Ÿ”ง API Key

For server-side authentication

Add to request headers:

X-API-KEY: YOUR_API_KEY

โš ๏ธ Important: Do not use both authentication methods simultaneously in the same request.

๐Ÿ”— Endpoints Overview

MethodEndpointDescription
๐Ÿ” GET/transaction/card/{cardId}/listGet card transactions list
๐Ÿ” GET/transaction/card/{cardId}/exportExport card transactions to Excel
๐Ÿ” GET/transaction/3ds/{cardId}/listGet 3DS logs list
๐Ÿ” GET/transaction/card/{transactionId}Get card transaction by ID
๐Ÿ” GET/transaction/card/relatedGet related transactions by card transaction
๐Ÿ” GET/transaction/crypto/{accountId}/listGet crypto transactions list
๐Ÿ” GET/transaction/crypto/listGet all crypto transactions list
๐Ÿ” GET/transaction/crypto/{transactionId}Get crypto transaction by ID
๐Ÿ” GET/transaction/fiat/{accountId}/listGet fiat transactions list
๐Ÿ” GET/transaction/fiat/listGet all fiat transactions list
๐Ÿ” GET/transaction/fiat/{transactionId}Get fiat transaction by ID

๐Ÿ“– Detailed Documentation

Get card transactions list

GET/transaction/card/{cardId}/list
Full URL
https://api.market.decenctype.com/transaction/card/{cardId}/list

๐ŸŽฏ Path Parameters

  • cardId (string) - โœ… Required: Card ID

๐Ÿ“‹ Query Parameters

ParameterTypeRequiredDescription
sortFieldstringโŒๆŽ’ๅบๅญ—ๆฎต
sortstringโŒๆŽ’ๅบๆ–นๅผ
pagenumberโŒ้กต็ ๏ผˆไปŽ1ๅผ€ๅง‹๏ผ‰
pageSizenumberโŒๆฏ้กตๆกๆ•ฐ
typestringโŒTransaction type
statusstringโŒTransaction status
startDatestringโŒStart date (็คบไพ‹: 2023-01-01 00:00:00)
endDatestringโŒEnd date (็คบไพ‹: 2023-01-01 00:00:00)
showAllbooleanโŒShow all transactions, notice that this field will only work if exact time range was provided

Description: Get card transactions list

Operation ID: getCardTransactions

Response Status:

  • โœ… 200: Return card transactions list

๐Ÿ“‹ Response Examples

response.json
1{
2 "items": [
3 {
4 "transactionId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
5 "type": "AUTHORIZATION",
6 "amount": 100.5,
7 "currency": "USD",
8 "amountCleared": 95.75,
9 "currencyCleared": "USD",
10 "taxes": 5.25,
11 "status": "PENDING",
12 "reviewStatus": "PENDING",
13 "timestamp": "2023-12-01T10:30:00Z",
14 "timestampCleared": "2023-12-01T12:00:00Z",
15 "fiatAmount": 100.5,
16 "fiatCurrency": "USD",
17 "fiatExchangeRate": 1
18 }
19 ],
20 "meta": "example-meta"
21}

๐Ÿ“ Example Request

curl -X GET "https://api.market.decenctype.com/transaction/card/example-id/list" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json"

Export card transactions to Excel

GET/transaction/card/{cardId}/export
Full URL
https://api.market.decenctype.com/transaction/card/{cardId}/export

๐ŸŽฏ Path Parameters

  • cardId (string) - โœ… Required: Card ID

๐Ÿ“‹ Query Parameters

ParameterTypeRequiredDescription
sortFieldstringโŒๆŽ’ๅบๅญ—ๆฎต
sortstringโŒๆŽ’ๅบๆ–นๅผ
pagenumberโŒ้กต็ ๏ผˆไปŽ1ๅผ€ๅง‹๏ผ‰
pageSizenumberโŒๆฏ้กตๆกๆ•ฐ
typestringโŒTransaction type
statusstringโŒTransaction status
startDatestringโŒStart date (็คบไพ‹: 2023-01-01 00:00:00)
endDatestringโŒEnd date (็คบไพ‹: 2023-01-01 00:00:00)
showAllbooleanโŒShow all transactions, notice that this field will only work if exact time range was provided

Description: Export card transactions to Excel

Operation ID: exportCardTransactions

Response Status:

  • โœ… 200: Excel file download

๐Ÿ“ Example Request

curl -X GET "https://api.market.decenctype.com/transaction/card/example-id/export" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json"

Get 3DS logs list

GET/transaction/3ds/{cardId}/list
Full URL
https://api.market.decenctype.com/transaction/3ds/{cardId}/list

๐ŸŽฏ Path Parameters

  • cardId (string) - โœ… Required: Card ID

๐Ÿ“‹ Query Parameters

ParameterTypeRequiredDescription
sortFieldstringโŒๆŽ’ๅบๅญ—ๆฎต
sortstringโŒๆŽ’ๅบๆ–นๅผ
pagenumberโŒ้กต็ ๏ผˆไปŽ1ๅผ€ๅง‹๏ผ‰
pageSizenumberโŒๆฏ้กตๆกๆ•ฐ
typestringโŒTransaction type
statusstringโŒTransaction status
startDatestringโŒStart date (็คบไพ‹: 2023-01-01 00:00:00)
endDatestringโŒEnd date (็คบไพ‹: 2023-01-01 00:00:00)
showAllbooleanโŒShow all transactions, notice that this field will only work if exact time range was provided

Description: Get 3DS logs list

Operation ID: get3DSLogs

Response Status:

  • โœ… 200: Return 3DS logs list

๐Ÿ“‹ Response Examples

response.json
1{
2 "items": [
3 {
4 "initiateActionId": "8c2b6635-2b42-4600-8d78-8bd0a610fbf1",
5 "cardId": "01292d5b-5ee4-4502-bb84-9b69623baad4",
6 "transactionAmount": 7650,
7 "transactionTimestamp": "2025-02-21T11:10:17.616Z",
8 "status": "PENDING",
9 "merchantId": "merchant-uuid-123"
10 }
11 ],
12 "meta": "example-meta"
13}

๐Ÿ“ Example Request

curl -X GET "https://api.market.decenctype.com/transaction/3ds/example-id/list" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json"

Get card transaction by ID

GET/transaction/card/{transactionId}
Full URL
https://api.market.decenctype.com/transaction/card/{transactionId}

๐ŸŽฏ Path Parameters

  • transactionId (string) - โœ… Required: Transaction ID

Description: Get card transaction by ID

Operation ID: getCardTransactionById

Response Status:

  • โœ… 200: Return card transaction details
  • โŒ 404: Transaction not found

๐Ÿ“‹ Response Examples

response.json
1{
2 "transactionId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
3 "networkTransactionId": "NETS_TX_123456789",
4 "type": "AUTHORIZATION",
5 "cardId": "123e4567-e89b-12d3-a456-426614174000",
6 "amount": 100.5,
7 "currency": "USD",
8 "amountCleared": 95.75,
9 "currencyCleared": "USD",
10 "taxes": 5.25,
11 "status": "PENDING",
12 "reviewStatus": "PENDING",
13 "timestamp": "2023-12-01T10:30:00Z",
14 "timestampCleared": "2023-12-01T12:00:00Z",
15 "details": {
16 "merchant": "Amazon",
17 "location": "Online"
18 },
19 "snapshot": {
20 "balance_before": 1000,
21 "balance_after": 900
22 },
23 "fiatAmount": 100.5,
24 "fiatCurrency": "USD",
25 "fiatExchangeRate": 1,
26 "cryptoAmount": 0.12345678,
27 "cryptoCurrency": "BTC",
28 "cryptoExchangeRate": 45000.5
29}

๐Ÿ“ Example Request

curl -X GET "https://api.market.decenctype.com/transaction/card/example-id" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json"

GET/transaction/card/related
Full URL
https://api.market.decenctype.com/transaction/card/related

๐Ÿ“‹ Query Parameters

ParameterTypeRequiredDescription
transactionIdstringโœ…Transaction ID (็คบไพ‹: tid_123456789)
networkTransactionIdstringโŒNetwork transaction ID (required if transaction_id does not start with tid_) (็คบไพ‹: NETS_TX_123456789)

Description: Get related transactions by card transaction

Operation ID: getRelatedTransactions

Response Status:

  • โœ… 200: Return related transactions list
  • โŒ 400: Bad request - missing required parameters
  • โŒ 404: Original transaction not found

๐Ÿ“‹ Response Examples

response.json
1[
2 {
3 "transactionId": "example-id",
4 "cardId": "example-id",
5 "type": "example-type",
6 "status": "example-status",
7 "amount": 1,
8 "currency": "example-currency",
9 "amountCleared": 1,
10 "currencyCleared": "example-currencyCleared",
11 "timestamp": "2024-01-01T12:00:00Z",
12 "timestampCleared": "2024-01-01T12:00:00Z",
13 "reviewStatus": "example-reviewStatus",
14 "networkTransactionId": "example-id",
15 "details": {},
16 "relatedIndex": 1,
17 "source": "example-source",
18 "mcc": {}
19 }
20]

๐Ÿ“ Example Request

curl -X GET "https://api.market.decenctype.com/transaction/card/related" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json"

Get crypto transactions list

GET/transaction/crypto/{accountId}/list
Full URL
https://api.market.decenctype.com/transaction/crypto/{accountId}/list

๐ŸŽฏ Path Parameters

  • accountId (string) - โœ… Required: Crypto account ID

๐Ÿ“‹ Query Parameters

ParameterTypeRequiredDescription
sortFieldstringโŒๆŽ’ๅบๅญ—ๆฎต
sortstringโŒๆŽ’ๅบๆ–นๅผ
pagenumberโŒ้กต็ ๏ผˆไปŽ1ๅผ€ๅง‹๏ผ‰
pageSizenumberโŒๆฏ้กตๆกๆ•ฐ
typestringโŒTransaction type
statusstringโŒTransaction status
startDatestringโŒStart date (็คบไพ‹: 2023-01-01 00:00:00)
endDatestringโŒEnd date (็คบไพ‹: 2023-01-01 00:00:00)
showAllbooleanโŒShow all transactions, notice that this field will only work if exact time range was provided

Description: Get crypto transactions list

Operation ID: getCryptoTransactions

Response Status:

  • โœ… 200: Return crypto transactions list

๐Ÿ“‹ Response Examples

response.json
1{
2 "items": [
3 {
4 "transactionId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
5 "accountId": "123e4567-e89b-12d3-a456-426614174000",
6 "type": "DEPOSIT",
7 "amount": 0.5,
8 "currency": "BTC",
9 "status": "PENDING",
10 "timestamp": "2023-12-01T10:30:00Z"
11 }
12 ],
13 "meta": "example-meta"
14}

๐Ÿ“ Example Request

curl -X GET "https://api.market.decenctype.com/transaction/crypto/example-id/list" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json"

Get all crypto transactions list

GET/transaction/crypto/list
Full URL
https://api.market.decenctype.com/transaction/crypto/list

๐Ÿ“‹ Query Parameters

ParameterTypeRequiredDescription
sortFieldstringโŒๆŽ’ๅบๅญ—ๆฎต
sortstringโŒๆŽ’ๅบๆ–นๅผ
pagenumberโŒ้กต็ ๏ผˆไปŽ1ๅผ€ๅง‹๏ผ‰
pageSizenumberโŒๆฏ้กตๆกๆ•ฐ
typestringโŒTransaction type
statusstringโŒTransaction status
startDatestringโŒStart date (็คบไพ‹: 2023-01-01 00:00:00)
endDatestringโŒEnd date (็คบไพ‹: 2023-01-01 00:00:00)
showAllbooleanโŒShow all transactions, notice that this field will only work if exact time range was provided

Description: Get all crypto transactions list

Operation ID: getAllCryptoTransactions

Response Status:

  • โœ… 200: Return all crypto transactions list

๐Ÿ“‹ Response Examples

response.json
1{
2 "items": [
3 {
4 "transactionId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
5 "accountId": "123e4567-e89b-12d3-a456-426614174000",
6 "type": "DEPOSIT",
7 "amount": 0.5,
8 "currency": "BTC",
9 "status": "PENDING",
10 "timestamp": "2023-12-01T10:30:00Z"
11 }
12 ],
13 "meta": "example-meta"
14}

๐Ÿ“ Example Request

curl -X GET "https://api.market.decenctype.com/transaction/crypto/list" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json"

Get crypto transaction by ID

GET/transaction/crypto/{transactionId}
Full URL
https://api.market.decenctype.com/transaction/crypto/{transactionId}

๐ŸŽฏ Path Parameters

  • transactionId (string) - โœ… Required: Transaction ID

Description: Get crypto transaction by ID

Operation ID: getCryptoTransactionById

Response Status:

  • โœ… 200: Return crypto transaction details
  • โŒ 404: Transaction not found

๐Ÿ“‹ Response Examples

response.json
1{
2 "transactionId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
3 "accountId": "123e4567-e89b-12d3-a456-426614174000",
4 "type": "DEPOSIT",
5 "amount": 0.5,
6 "currency": "BTC",
7 "orderId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
8 "status": "PENDING",
9 "timestamp": "2023-12-01T10:30:00Z",
10 "details": {
11 "txHash": "0x1234567890abcdef",
12 "blockNumber": 12345678,
13 "gasUsed": 21000
14 }
15}

๐Ÿ“ Example Request

curl -X GET "https://api.market.decenctype.com/transaction/crypto/example-id" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json"

Get fiat transactions list

GET/transaction/fiat/{accountId}/list
Full URL
https://api.market.decenctype.com/transaction/fiat/{accountId}/list

๐ŸŽฏ Path Parameters

  • accountId (string) - โœ… Required: Fiat account ID

๐Ÿ“‹ Query Parameters

ParameterTypeRequiredDescription
sortFieldstringโŒๆŽ’ๅบๅญ—ๆฎต
sortstringโŒๆŽ’ๅบๆ–นๅผ
pagenumberโŒ้กต็ ๏ผˆไปŽ1ๅผ€ๅง‹๏ผ‰
pageSizenumberโŒๆฏ้กตๆกๆ•ฐ
typestringโŒTransaction type
statusstringโŒTransaction status
startDatestringโŒStart date (็คบไพ‹: 2023-01-01 00:00:00)
endDatestringโŒEnd date (็คบไพ‹: 2023-01-01 00:00:00)
showAllbooleanโŒShow all transactions, notice that this field will only work if exact time range was provided

Description: Get fiat transactions list

Operation ID: getFiatTransactions

Response Status:

  • โœ… 200: Return fiat transactions list

๐Ÿ“‹ Response Examples

response.json
1{
2 "items": [
3 {
4 "transactionId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
5 "accountId": "123e4567-e89b-12d3-a456-426614174000",
6 "type": "DEPOSIT",
7 "amount": 100.5,
8 "currency": "USD",
9 "status": "PENDING",
10 "timestamp": "2023-12-01T10:30:00Z"
11 }
12 ],
13 "meta": "example-meta"
14}

๐Ÿ“ Example Request

curl -X GET "https://api.market.decenctype.com/transaction/fiat/example-id/list" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json"

Get all fiat transactions list

GET/transaction/fiat/list
Full URL
https://api.market.decenctype.com/transaction/fiat/list

๐Ÿ“‹ Query Parameters

ParameterTypeRequiredDescription
sortFieldstringโŒๆŽ’ๅบๅญ—ๆฎต
sortstringโŒๆŽ’ๅบๆ–นๅผ
pagenumberโŒ้กต็ ๏ผˆไปŽ1ๅผ€ๅง‹๏ผ‰
pageSizenumberโŒๆฏ้กตๆกๆ•ฐ
typestringโŒTransaction type
statusstringโŒTransaction status
startDatestringโŒStart date (็คบไพ‹: 2023-01-01 00:00:00)
endDatestringโŒEnd date (็คบไพ‹: 2023-01-01 00:00:00)
showAllbooleanโŒShow all transactions, notice that this field will only work if exact time range was provided

Description: Get all fiat transactions list

Operation ID: getAllFiatTransactions

Response Status:

  • โœ… 200: Return all fiat transactions list

๐Ÿ“‹ Response Examples

response.json
1{
2 "items": [
3 {
4 "transactionId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
5 "accountId": "123e4567-e89b-12d3-a456-426614174000",
6 "type": "DEPOSIT",
7 "amount": 100.5,
8 "currency": "USD",
9 "status": "PENDING",
10 "timestamp": "2023-12-01T10:30:00Z"
11 }
12 ],
13 "meta": "example-meta"
14}

๐Ÿ“ Example Request

curl -X GET "https://api.market.decenctype.com/transaction/fiat/list" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json"

Get fiat transaction by ID

GET/transaction/fiat/{transactionId}
Full URL
https://api.market.decenctype.com/transaction/fiat/{transactionId}

๐ŸŽฏ Path Parameters

  • transactionId (string) - โœ… Required: Transaction ID

Description: Get fiat transaction by ID

Operation ID: getFiatTransactionById

Response Status:

  • โœ… 200: Return fiat transaction details
  • โŒ 404: Transaction not found

๐Ÿ“‹ Response Examples

response.json
1{
2 "transactionId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
3 "accountId": "123e4567-e89b-12d3-a456-426614174000",
4 "type": "DEPOSIT",
5 "amount": 100.5,
6 "currency": "USD",
7 "orderId": "01ARZ3NDEKTSV4RRFFQ69G5FAV",
8 "status": "PENDING",
9 "timestamp": "2023-12-01T10:30:00Z",
10 "details": {
11 "bankAccount": "XXXX-1234",
12 "reference": "REF123456",
13 "memo": "Monthly salary deposit"
14 }
15}

๐Ÿ“ Example Request

curl -X GET "https://api.market.decenctype.com/transaction/fiat/example-id" \\
  -H "Authorization: Bearer YOUR_TOKEN" \\
  -H "Content-Type: application/json"