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
`POST`	`/spicedeposit`	Record deposit/withdrawal
`GET`	`/spicedeposit/:address`	Get user balances

Spice Deposits

Record deposits, withdrawals, and query balances

Transaction Tracking

Track and verify transactions for specific venues.

Method	Endpoint	Description
`POST`	`/venue-tx-hashes`	Save tx hash
`GET`	`/venue-tx-hashes`	Query tx hashes
`GET`	`/venue-tx-hashes/verify/:txHash`	Verify tx hash

Venue TX Hashes

Track and verify transactions for venues

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 still functional but the Actions API is recommended for new integrations.

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