Skip to main content

​
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

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

​
Endpoints Overview

​
Actions API

The unified API for creating and executing cross-chain intents.
MethodEndpointDescription
POST/actionsCreate action with intents
GET/actions/:actionIdGet action status
GET/actions/:actionId/intents/:idxGet intent status
GET/POST/actions/:actionId/intents/:idx/steps/:idxGet/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.
MethodEndpointDescription
POST/spicedepositRecord deposit/withdrawal
GET/spicedeposit/:addressGet user balances

Spice Deposits

Record deposits, withdrawals, and query balances

​
Transaction Tracking

Track and verify transactions for specific venues.
MethodEndpointDescription
POST/venue-tx-hashesSave tx hash
GET/venue-tx-hashesQuery tx hashes
GET/venue-tx-hashes/verify/:txHashVerify tx hash

Venue TX Hashes

Track and verify transactions for venues

​
Utility

MethodEndpointDescription
POST/airdrop/:chainId/:tokenIdRequest airdrop
GET/healthHealth 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.
MethodEndpointDescription
POST/transaction/submitSubmit legacy transaction
GET/intent/:id/step/:id/statusGet step status

POST /transaction/submit

Submit a cross-chain transaction (legacy)

GET Step Status

Get intent step status (legacy)