RugShield Solana risk API reference

Paid Solana checks

• POST /v1/tx-guard: checks an unsigned Solana transaction before signing; returns ALLOW, WARN or BLOCK without signing or broadcasting.
• GET /v1/token-risk/{address}: RugShield's own risk flags for a Solana token mint.
• GET /v1/risk-panel/{mint}: runs compatible risk advisors in parallel for a Solana token mint and returns separate consensus and available RugShield flags. The signed request prepays the exact quote and returns HTTP 202 with a job handle. Poll for free; no second signed request or payment is required. Failed paid analysis needs support review; no automatic refund.

Solana token and transaction analysis; x402 payment uses USDC on configured Base or Solana payment networks.

Free agent discovery: own-check token trial (default 10 calls per minute per temporary connection identity; shared cache up to 120 seconds), OpenAPI schema, Base and Solana payment client setup, agent guide, x402 manifest, advisor catalog, API directory metadata.

Understand each next call

agent_guidance.request_example describes the recommended NEXT action using type, executable, explanation, effects.payment, effects.analysis, payment_proof_required and new_authorization_allowed. Incomplete templates require your actual inputs; do not submit them unchanged. An original-request recovery may settle its ORIGINAL authorization; it is not guaranteed zero-cost. A manual or none example prescribes no automatic API request.

Payment and analysis have separate explanations under agent_guidance.payment and agent_guidance.analysis. Legacy charged:null means an unconfirmed charge outcome, not no charge. No background reconciliation service is available; request support review if a saved pending state persists.

• GET /health: free liveness/configuration; does not inspect database or job health.
• GET /v1/advisors: free public advisor options and prices; no advisor calls.
• GET /v1/trial/token-risk/{actual_token_mint}: free own-code analysis or cached data; replace the mint template.
• GET /v1/jobs/{server_returned_job_id}: free status/result retrieval; no settlement or analysis restart.
• POST /v1/jobs/{server_returned_job_id}/retry: one eligible failed token/transaction retry; server-enforced, free, not available for panels and not a refund.