API Reference - Spice Flow

Authentication

The API uses signature-based authentication. For EIP-7702 mode, you sign authorizations with your wallet. For non-7702 modes, you sign or submit transactions directly.

Response Format

All API responses follow this format:

{
  "success": boolean,
  "data": object | null,
  "error": { "message": string } | null
}

Error Handling

Status	Description
`200/201`	Success
`202`	Accepted (step already processing)
`400`	Bad Request (validation error)
`404`	Not Found
`500`	Internal Server Error

Endpoints Overview

Actions API

The unified API for creating and executing cross-chain intents.

Method	Endpoint	Description
`POST`	`/actions`	Create action with intents
`GET`	`/actions/:actionId`	Get action status
`GET`	`/actions/:actionId/intents/:idx`	Get intent status
`GET/POST`	`/actions/:actionId/intents/:idx/steps/:idx`	Get/Execute step

POST /actions

Create an action with intents for cross-chain execution

GET Action Status

Retrieve action, intent, or step status

POST Execute Step

Execute a specific intent step

Balances & Deposits

Manage user balances for cross-chain transfers.

Method	Endpoint	Description
`GET`	`/wallets/:address/balance`	Get user Spice balances

Spice Deposits

Record deposits, withdrawals, and query balances

Transaction Tracking

Method	Endpoint	Description
`POST`	`/transactions/handle/evm`	Handle a transaction

Handle Transaction

Utility

Method	Endpoint	Description
`POST`	`/airdrop/:chainId/:tokenId`	Request airdrop
`GET`	`/health`	Health check

Airdrop

Request testnet token airdrops

Health Check

Check API server status

Legacy Endpoints

These endpoints are deprecated and not served by the current relayer. Use the Actions API above.

Method	Endpoint	Description
`POST`	`/transaction/submit`	Submit legacy transaction
`GET`	`/intent/:id/step/:id/status`	Get step status

POST /transaction/submit

Submit a cross-chain transaction (legacy)

GET Step Status

Get intent step status (legacy)

​Authentication

​Response Format

​Error Handling

​Endpoints Overview

​Actions API