Skip to main content

​
API Reference

The Spice Flow API provides endpoints for transaction submission and intent execution. All endpoints use JSON for request and response bodies.

​
Authentication

The API uses EIP-7702 authorization objects and signature-based authentication for transaction submission and intent execution.

​
Endpoints Overview

MethodEndpointDescription
POST/transaction/submitSubmit a cross-chain transaction with intent authorization
POST/intent/{intentId}/execute/{stepId}Execute a specific intent step and return results
GET/intent/{intentId}/step/{stepId}/statusGet status of a specific intent step and auto-advance on completion

​
Response Format

All API responses follow this format: 
{
  "success": boolean,
  "data": object | null,
  "error": { "message": string } | null
}

​
Error Handling

The API returns these HTTP status codes:
  • 200 - Success
  • 400 - Bad Request (missing or invalid parameters)
  • 404 - Not Found (intent step not found on status endpoint)
  • 500 - Internal Server Error

​
Endpoints

POST /transaction/submit

Submit a cross-chain transaction with intent authorization

POST /intent/{id}/execute/{stepId}

Execute a specific intent step and return results

GET /intent/{id}/step/{stepId}/status

Get intent step status (created/executing/success/reverted) and auto-advance