Lighter

Perpetuals trading on zkLighter via Thirdfy provider actions. CCTP funding, API key signing, and integrator fee readiness.

Category: Trading

Lighter perpetuals are exposed through the governed action catalog under provider lighter. Orders are signed with a Lighter API key through the Thirdfy signer sidecar, not by ERC-7710 Gator grants.

Credential model

LayerModel
Exchange ordersLighter API key (lighter_api_key credential: privateKey, apiKeyIndex 4–254, accountIndex)
FundingCCTP deposit intent from Base, Arbitrum, or Avalanche USDC (minimum 5 USDC)
EVM funding txsMay use agent_wallet for source-chain USDC movement before CCTP
ReadsL1 address or Lighter account index

Discovery

curl "https://api.thirdfy.com/api/v1/agent/actions/catalog"
SurfaceExample
MCPgetProviderActions { provider: "lighter" }
CLIthirdfy-agent lighter or thirdfy-agent actions --provider lighter

Readiness checklist

  • Source-chain USDC funded for CCTP when margin is not already on Lighter.
  • Onboarding complete (complete_lighter_onboarding or setup/status actions).
  • API key registered (create_lighter_api_key then register_lighter_api_key).
  • Integrator approval when Thirdfy partner monetization is active (approve_lighter_integrator). Unfunded integrator treasury returns LIGHTER_INTEGRATOR_ACCOUNT_UNFUNDED and orders proceed without integrator fee attachment.
  • Preflight and delegationStatus before live writes.
  • LIGHTER_SIGNER_URL or LIGHTER_SIGNER_BINARY_PATH configured on the API for signed writes.

Execution lanes

runModeUse
agent_walletSolo managed wallet for automated complete_lighter_onboarding (Base CCTP + Ethereum priority changePubKey)
thirdfy / hybridDelegated user capital with lighter_api_key for order writes

Use explicit place_lighter_perps_order actions. Generic place-perps-order aliases remain Hyperliquid-only in v1.

MCP sequence (summary)

  1. getProviderActions { provider: "lighter" }
  2. get_lighter_funding_status and market discovery reads
  3. Onboarding or get_lighter_setup_status
  4. approve_lighter_integrator when integrator monetization is active and approval is missing
  5. Orders via walletExecute or executeIntent with delegated lighter_api_key

See Thirdfy MCP for the full recommended sequence.

Hosted deploy

Lighter perps templates are on EarnClaw (docs.earnclaw.com). EarnClaw hosts the Hermes runtime; Thirdfy governs execution through the lighter provider.

Related

Allora
Read-only Allora network price inference for BTC, ETH, and SOL. Advisory forecasts via provider allora.
Venue matrix
Category, catalog provider keys, chains, and documentation links for Thirdfy integrations.