Skip to content
Landed or go aroundEvery response says whether the transaction was accepted, or why it was turned away so you can try again.ERR
Every response says whether the transaction was accepted, or why it was turned away so you can try again.

Response format and error codes

Success Response

json
{
  "status": "accepted",
  "request_id": "550e8400-e29b-41d4-a716-446655440000",
  "signature": "5wH...txSig"
}

The relay returns the transaction signature for immediate confirmation tracking.

Error Responses

Error CodeDescription
tip_missingTransaction does not include a tip to FastRelay wallet
tip_insufficientTip amount below minimum threshold (1,000,000 lamports)
tip_hidden_in_altTransaction uses Address Lookup Table — cannot verify tip
jito_tip_missingBundle has no transfer to a Jito tip account (bundles only)
jito_tip_insufficientJito tip below the 1,000 lamport minimum (bundles only)
simulate_forbiddenThe simulate parameter must be false
invalid_api_keyAPI key not found or invalid
rate_limit_exceededRequest rate limit exceeded for this API key
invalid_transactionTransaction deserialization failed

Error Response Format

json
{
  "status": "rejected",
  "error": "Transaction uses ALT — cannot verify tip"
}