API Reference

17 endpoints with curl examples, request/response payloads, and error codes.

https://api.usestackr.xyz

Testnet: https://testnet.api.usestackr.xyz

API v1 endpoints require your secret API key in the Authorization header. Get your API key from the Stackr Dashboard after signing up.

Authorization: Bearer sk_live_your_api_key_here

Test key (testnet)

sk_test_...

Safe for development. No real money moves.

Live key (mainnet)

sk_live_...

Production. Real USDC on Stellar mainnet.

Never expose your secret key in client-side code. Always make Stackr API calls from your backend server.

Rate limits are per API key, not per IP. Limits depend on your plan:

Free

60 req/min

1,000/month

Pro

300 req/min

50,000/month

Enterprise

Custom

Unlimited

When rate-limited, the server returns 429 Too Many Requests.

Core EndpointsNo authentication required

All errors follow a consistent JSON structure:

{
  "error": "Insufficient balance",
  "code": "INSUFFICIENT_BALANCE",
  "details": "Account has 5.00 USDC, transfer requires 10.00 USDC"
}