List Stablecoin Transactions
curl --request GET \
--url https://api.stateset.com/v1/stablecoin/transactions \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.stateset.com/v1/stablecoin/transactions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.stateset.com/v1/stablecoin/transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.stateset.com/v1/stablecoin/transactions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.stateset.com/v1/stablecoin/transactions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.stateset.com/v1/stablecoin/transactions")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.stateset.com/v1/stablecoin/transactions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"transactions": [
{
"id": "txn_abc123def456",
"type": "transfer",
"transaction_hash": "A1B2C3D4E5F6G7H8I9J0K1L2M3N4O5P6Q7R8S9T0",
"from": "stateset1qypqxpq9qcrsszg2pvxq6rs0zqg3yyc5lzv7xu",
"to": "stateset1abcdefghijklmnopqrstuvwxyz123456789012",
"amount": {
"denom": "ssusd",
"amount": "500000000",
"display_amount": "500.00 ssUSD",
"usd_value": "500.00"
},
"fees": {
"network_fee": "0.01",
"processing_fee": "0.00"
},
"status": "confirmed",
"block_height": 1234567,
"memo": "Payment for invoice #INV-2024-001",
"metadata": {
"invoice_id": "inv_123456",
"order_id": "ord_789012"
},
"created_at": "2024-01-15T09:30:00Z",
"confirmed_at": "2024-01-15T09:30:05Z"
},
{
"id": "txn_xyz789uvw012",
"type": "issue",
"transaction_hash": "B2C3D4E5F6G7H8I9J0K1L2M3N4O5P6Q7R8S9T0U1",
"from": null,
"to": "stateset1qypqxpq9qcrsszg2pvxq6rs0zqg3yyc5lzv7xu",
"amount": {
"denom": "ssusd",
"amount": "10000000000",
"display_amount": "10,000.00 ssUSD",
"usd_value": "10000.00"
},
"fees": {
"network_fee": "0.50",
"processing_fee": "10.00"
},
"status": "confirmed",
"block_height": 1234500,
"memo": "Merchant funding",
"metadata": {
"reference_id": "ISS-2024-001234",
"source_type": "bank_wire"
},
"created_at": "2024-01-14T14:20:00Z",
"confirmed_at": "2024-01-14T14:20:10Z"
}
],
"pagination": {
"total": 156,
"limit": 20,
"offset": 0,
"has_more": true
}
}
List Stablecoin Transactions
Retrieve stablecoin transaction history with filtering and pagination
GET
/
v1
/
stablecoin
/
transactions
List Stablecoin Transactions
curl --request GET \
--url https://api.stateset.com/v1/stablecoin/transactions \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.stateset.com/v1/stablecoin/transactions"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.stateset.com/v1/stablecoin/transactions', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.stateset.com/v1/stablecoin/transactions",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.stateset.com/v1/stablecoin/transactions"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.stateset.com/v1/stablecoin/transactions")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.stateset.com/v1/stablecoin/transactions")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"transactions": [
{
"id": "txn_abc123def456",
"type": "transfer",
"transaction_hash": "A1B2C3D4E5F6G7H8I9J0K1L2M3N4O5P6Q7R8S9T0",
"from": "stateset1qypqxpq9qcrsszg2pvxq6rs0zqg3yyc5lzv7xu",
"to": "stateset1abcdefghijklmnopqrstuvwxyz123456789012",
"amount": {
"denom": "ssusd",
"amount": "500000000",
"display_amount": "500.00 ssUSD",
"usd_value": "500.00"
},
"fees": {
"network_fee": "0.01",
"processing_fee": "0.00"
},
"status": "confirmed",
"block_height": 1234567,
"memo": "Payment for invoice #INV-2024-001",
"metadata": {
"invoice_id": "inv_123456",
"order_id": "ord_789012"
},
"created_at": "2024-01-15T09:30:00Z",
"confirmed_at": "2024-01-15T09:30:05Z"
},
{
"id": "txn_xyz789uvw012",
"type": "issue",
"transaction_hash": "B2C3D4E5F6G7H8I9J0K1L2M3N4O5P6Q7R8S9T0U1",
"from": null,
"to": "stateset1qypqxpq9qcrsszg2pvxq6rs0zqg3yyc5lzv7xu",
"amount": {
"denom": "ssusd",
"amount": "10000000000",
"display_amount": "10,000.00 ssUSD",
"usd_value": "10000.00"
},
"fees": {
"network_fee": "0.50",
"processing_fee": "10.00"
},
"status": "confirmed",
"block_height": 1234500,
"memo": "Merchant funding",
"metadata": {
"reference_id": "ISS-2024-001234",
"source_type": "bank_wire"
},
"created_at": "2024-01-14T14:20:00Z",
"confirmed_at": "2024-01-14T14:20:10Z"
}
],
"pagination": {
"total": 156,
"limit": 20,
"offset": 0,
"has_more": true
}
}
This endpoint provides a comprehensive view of stablecoin transactions including issuances, redemptions, transfers, and burns.
Authentication
This endpoint requires a valid API key withstablecoin:read permissions.
Authorization: Bearer YOUR_API_KEY
Query Parameters
Filter transactions by address (as sender or recipient)
Filter by transaction type: “issue”, “redeem”, “transfer”, “burn”
Filter by status: “pending”, “confirmed”, “failed”
Filter by stablecoin denomination (e.g., “ssusd”)
Start date for transaction range (ISO 8601 format)
End date for transaction range (ISO 8601 format)
Minimum transaction amount (in smallest unit)
Maximum transaction amount (in smallest unit)
Number of results per page (max: 100, default: 20)
Pagination offset
Sort order: “asc” or “desc” (default: “desc”)
Response
Array of transaction objects
Show Transaction Object
Show Transaction Object
Unique transaction identifier
Transaction type: “issue”, “redeem”, “transfer”, “burn”
Blockchain transaction hash
Sender address (null for issuances)
Recipient address (null for redemptions/burns)
Transaction status
Block height of confirmation
Transaction memo/note
Additional transaction metadata
ISO 8601 timestamp
ISO 8601 timestamp of confirmation
{
"transactions": [
{
"id": "txn_abc123def456",
"type": "transfer",
"transaction_hash": "A1B2C3D4E5F6G7H8I9J0K1L2M3N4O5P6Q7R8S9T0",
"from": "stateset1qypqxpq9qcrsszg2pvxq6rs0zqg3yyc5lzv7xu",
"to": "stateset1abcdefghijklmnopqrstuvwxyz123456789012",
"amount": {
"denom": "ssusd",
"amount": "500000000",
"display_amount": "500.00 ssUSD",
"usd_value": "500.00"
},
"fees": {
"network_fee": "0.01",
"processing_fee": "0.00"
},
"status": "confirmed",
"block_height": 1234567,
"memo": "Payment for invoice #INV-2024-001",
"metadata": {
"invoice_id": "inv_123456",
"order_id": "ord_789012"
},
"created_at": "2024-01-15T09:30:00Z",
"confirmed_at": "2024-01-15T09:30:05Z"
},
{
"id": "txn_xyz789uvw012",
"type": "issue",
"transaction_hash": "B2C3D4E5F6G7H8I9J0K1L2M3N4O5P6Q7R8S9T0U1",
"from": null,
"to": "stateset1qypqxpq9qcrsszg2pvxq6rs0zqg3yyc5lzv7xu",
"amount": {
"denom": "ssusd",
"amount": "10000000000",
"display_amount": "10,000.00 ssUSD",
"usd_value": "10000.00"
},
"fees": {
"network_fee": "0.50",
"processing_fee": "10.00"
},
"status": "confirmed",
"block_height": 1234500,
"memo": "Merchant funding",
"metadata": {
"reference_id": "ISS-2024-001234",
"source_type": "bank_wire"
},
"created_at": "2024-01-14T14:20:00Z",
"confirmed_at": "2024-01-14T14:20:10Z"
}
],
"pagination": {
"total": 156,
"limit": 20,
"offset": 0,
"has_more": true
}
}
Error Codes
| Code | Description |
|---|---|
400 | Invalid query parameters |
401 | Unauthorized - Invalid API key |
429 | Rate limit exceeded |
500 | Internal server error |
Code Examples
const axios = require('axios');
async function getTransactionHistory(params) {
try {
const response = await axios.get(
'https://api.stateset.com/v1/stablecoin/transactions',
{
params: {
address: 'stateset1qypqxpq9qcrsszg2pvxq6rs0zqg3yyc5lzv7xu',
type: 'transfer',
denom: 'ssusd',
start_date: '2024-01-01T00:00:00Z',
limit: 50,
order: 'desc'
},
headers: {
'Authorization': 'Bearer YOUR_API_KEY'
}
}
);
console.log(`Found ${response.data.pagination.total} transactions`);
response.data.transactions.forEach(tx => {
console.log(`${tx.type}: ${tx.amount.display_amount} - ${tx.status}`);
});
return response.data;
} catch (error) {
console.error('Failed to get transactions:', error.response.data);
}
}
import requests
from datetime import datetime, timedelta
def get_transaction_history():
url = "https://api.stateset.com/v1/stablecoin/transactions"
headers = {
"Authorization": "Bearer YOUR_API_KEY"
}
# Get transactions from last 30 days
end_date = datetime.utcnow()
start_date = end_date - timedelta(days=30)
params = {
"address": "stateset1qypqxpq9qcrsszg2pvxq6rs0zqg3yyc5lzv7xu",
"start_date": start_date.isoformat() + "Z",
"end_date": end_date.isoformat() + "Z",
"limit": 100
}
try:
response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
# Calculate totals by type
totals = {}
for tx in data['transactions']:
tx_type = tx['type']
amount = float(tx['amount']['usd_value'])
totals[tx_type] = totals.get(tx_type, 0) + amount
print("Transaction Summary (Last 30 Days):")
for tx_type, total in totals.items():
print(f"{tx_type.capitalize()}: ${total:,.2f}")
return data
except requests.exceptions.RequestException as e:
print(f"Failed to get transactions: {e}")
curl -X GET "https://api.stateset.com/v1/stablecoin/transactions?address=stateset1qypqxpq9qcrsszg2pvxq6rs0zqg3yyc5lzv7xu&type=transfer&limit=20" \
-H "Authorization: Bearer YOUR_API_KEY"
⌘I