API Reference
Common Response Codes
| Code | Meaning |
|---|---|
| 200 | Success — receipt returned |
| 400 | Invalid input or missing fields |
| 401 | Signature invalid or expired timestamp |
| 404 | Unknown event ID or resource not found |
| 429 | Rate limit exceeded |
| 500 | Internal processing error |
MCP Tool Definitions
| Tool | Description |
|---|---|
| species_create_transaction | Creates a transaction such as BUY, SELL, or TRANSFER |
| species_create_listing | Lists SPECIE for sale with fee proof |
| species_get_receipt | Retrieves the human-readable receipt for an eventId |
| species_check_balance | Queries current SPECIE and USDT balances |
| species_estimate_transaction | Estimates fees and total costs |
| species_monitor_transaction | Streams transaction updates in real-time |
Example — Receipt Response
{
"receipt": {
"eventId": "evt-73cd5b7a",
"status": "completed",
"intent": "BUY_TREASURY",
"timestamp": "2025-11-06T19:12:06Z",
"balanceChanges": {
"usr-123": { "species": +1000 },
"treasury": { "species": -1000 }
},
"paymentVerification": {
"provider": "NOWPayments",
"amount": "10 USDT",
"confirmations": 15,
"proof": "npmt_456789"
},
"fees": {
"issuance": "0.01 USDT",
"total": "0.01 USDT"
},
"timeline": {
"received": "2025-11-06T19:12:04Z",
"verified": "2025-11-06T19:12:05Z",
"executed": "2025-11-06T19:12:06Z"
}
}
}Key Takeaways
| Principle | Meaning | Benefit |
|---|---|---|
| One Call | All operations use one endpoint | Minimal integration overhead |
| Every Call Has a Receipt | Each response is signed proof | Built-in audit trail |
| Private by Default | No public ledger | Privacy and sovereignty |
| MCP-Based | Agent-native, model-context protocol | Works with AI and Onli Agents |
| Owner-Only Movement | Only verified owners can move assets | Perfect custody integrity |
| Mathematical Trust | Proof replaces history | Eliminates surveillance |
The Developer's Mantra
Intent. Proof. Receipt.
That's Specie.
Specie isn't built on blockchain — it's built on math, consent, and sovereignty. A protocol where trust doesn't require chains — and value moves only by will.