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
string
Filter transactions by address (as sender or recipient)
string
Filter by transaction type: “issue”, “redeem”, “transfer”, “burn”
string
Filter by status: “pending”, “confirmed”, “failed”
string
Filter by stablecoin denomination (e.g., “ssusd”)
string
Start date for transaction range (ISO 8601 format)
string
End date for transaction range (ISO 8601 format)
string
Minimum transaction amount (in smallest unit)
string
Maximum transaction amount (in smallest unit)
integer
Number of results per page (max: 100, default: 20)
integer
Pagination offset
string
Sort order: “asc” or “desc” (default: “desc”)
Response
array
Array of transaction objects
Show Transaction Object
Show Transaction Object
string
Unique transaction identifier
string
Transaction type: “issue”, “redeem”, “transfer”, “burn”
string
Blockchain transaction hash
string
Sender address (null for issuances)
string
Recipient address (null for redemptions/burns)
object
object
string
Transaction status
integer
Block height of confirmation
string
Transaction memo/note
object
Additional transaction metadata
string
ISO 8601 timestamp
string
ISO 8601 timestamp of confirmation
object
{
"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