# Get all transactions for an account
curl -X GET "https://api.finaegis.org/v2/accounts/acct_1234567890/transactions" \
-H "Authorization: Bearer YOUR_API_KEY"
# Get transactions with filters
curl -X GET "https://api.finaegis.org/v2/accounts/acct_1234567890/transactions?\
limit=20&\
page=1&\
type=withdrawal&\
status=completed&\
start_date=2025-01-01T00:00:00Z&\
end_date=2025-01-31T23:59:59Z&\
sort=-created_at" \
-H "Authorization: Bearer YOUR_API_KEY"
Query transactions using natural language -- the AI engine translates to structured filters
v2.8POSTAI
# Query transactions with natural language
curl -X POST https://api.finaegis.org/api/v1/ai/transactions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"query": "Show me all cross-chain transfers over $5000 in the last 7 days that had compliance flags",
"account_id": "acct_1234567890",
"options": {
"include_analytics": true,
"include_risk_scores": true,
"max_results": 50,
"format": "detailed"
}
}'
async function queryTransactionsWithAI(naturalLanguageQuery, accountId) {
try {
const result = await client.ai.transactions({
query: naturalLanguageQuery,
account_id: accountId,
options: {
include_analytics: true,
include_risk_scores: true,
max_results: 50,
format: 'detailed'
}
});
console.log('AI Query Interpretation:');
console.log(` Parsed filters: ${JSON.stringify(result.data.interpreted_query)}`);
console.log(` Confidence: ${result.data.interpretation_confidence}`);
console.log(` Results found: ${result.data.total_results}`);
result.data.transactions.forEach(tx => {
console.log(` ${tx.created_at}: ${tx.type} ${tx.amount} ${tx.currency}`);
console.log(` Status: ${tx.status} | Risk: ${tx.risk_score}`);
if (tx.compliance_flags.length > 0) {
console.log(` Flags: ${tx.compliance_flags.join(', ')}`);
}
});
if (result.data.analytics) {
console.log('\nAnalytics Summary:');
console.log(` Total volume: ${result.data.analytics.total_volume}`);
console.log(` Average amount: ${result.data.analytics.avg_amount}`);
console.log(` Flagged count: ${result.data.analytics.flagged_count}`);
}
return result;
} catch (error) {
console.error('AI query failed:', error.message);
throw error;
}
}
// Natural language transaction search
queryTransactionsWithAI(
'Show me all cross-chain transfers over $5000 in the last 7 days that had compliance flags',
'acct_1234567890'
);
def query_transactions_with_ai(natural_language_query, account_id):
try:
result = client.ai.transactions(
query=natural_language_query,
account_id=account_id,
options={
'include_analytics': True,
'include_risk_scores': True,
'max_results': 50,
'format': 'detailed'
}
)
print(f'AI Query Interpretation:')
print(f' Parsed filters: {result.data.interpreted_query}')
print(f' Confidence: {result.data.interpretation_confidence}')
print(f' Results found: {result.data.total_results}')
for tx in result.data.transactions:
print(f' {tx.created_at}: {tx.type} {tx.amount} {tx.currency}')
print(f' Status: {tx.status} | Risk: {tx.risk_score}')
if tx.compliance_flags:
print(f' Flags: {", ".join(tx.compliance_flags)}')
if result.data.analytics:
print(f'\nAnalytics Summary:')
print(f' Total volume: {result.data.analytics.total_volume}')
print(f' Average amount: {result.data.analytics.avg_amount}')
print(f' Flagged count: {result.data.analytics.flagged_count}')
return result
except Exception as error:
print(f'AI query failed: {error}')
raise
# Natural language transaction search
query_transactions_with_ai(
'Show me all cross-chain transfers over $5000 in the last 7 days that had compliance flags',
'acct_1234567890'
)