RugShield Trial API

The Trial API from RugShield — 1 operation(s) for trial.

GitHub OpenAPI

Operations 1

GET /v1/trial/token-risk/{mint} Free own-code token risk trial; recurring temporary quota, no payment #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/getrugshield-com:getrugshield-com-trial-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

getrugshield-com-trial-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: RugShield Parallel Solana Risk Trial API
  description: Parallel risk advisor aggregation and own Solana checks for AI agents; pay per call via x402 USDC on Base or Solana. Read optional agent_guidance for input corrections and next actions. Template/empty-body discovery quotes are not executable purchases; supply actual input and obtain a new quote.
  version: '1.0'
tags:
- name: Trial
paths:
  /v1/trial/token-risk/{mint}:
    get:
      summary: Free own-code token risk trial; recurring temporary quota, no payment
      description: Own Solana advisory checks only, no paid advisors. Ten calls per 60 seconds per temporary connection identity by default, including cached calls. Shared results cached up to 120 seconds by default. NO_FLAGS is not safety. Quota and cache reset on restart; quotas are per process, not per unique agent.
      operationId: getFreeSolanaTokenRiskTrial
      parameters:
      - name: mint
        in: path
        required: true
        schema:
          type: string
          description: Solana token mint in base58; validated as a 32-byte public key before upstream work
          title: Mint
        description: Solana token mint in base58; validated as a 32-byte public key before upstream work
      responses:
        '200':
          description: Useful own-code advisory flags with quota, freshness and optional paid URLs
          content:
            application/json:
              schema:
                type: object
                required:
                - analysis
                - freshness
                - quota
                - upgrade
                properties:
                  analysis:
                    type: object
                    required:
                    - mint
                    - token_name
                    - token_symbol
                    - deployer
                    - verdict
                    - flags
                    - deployer_stats
                    - checks_unavailable
                    - note
                    properties:
                      mint:
                        type: string
                      token_name:
                        type:
                        - string
                        - 'null'
                      token_symbol:
                        type:
                        - string
                        - 'null'
                      deployer:
                        type: string
                      verdict:
                        type: string
                        enum:
                        - RISK_FLAGS
                        - NO_FLAGS
                      flags:
                        type: array
                        items:
                          type: object
                          required:
                          - id
                          - detail
                          properties:
                            id:
                              type: string
                            detail:
                              type: string
                            measured_precision:
                              type: number
                              description: Historical share of flagged tokens labeled rug in a selected cohort; not a prospective guarantee.
                            false_positive_rate:
                              type: number
                              description: Historical share of labeled healthy tokens flagged in a selected cohort; not a prospective guarantee.
                            sample:
                              type: string
                              description: Selected historical evaluation cohort and date; does not establish performance on new tokens.
                            hits:
                              type: array
                              items:
                                type: object
                                required:
                                - signature
                                - fee_lamports
                                - fee_payer
                                - matches
                                properties:
                                  signature:
                                    type:
                                    - string
                                    - 'null'
                                  fee_lamports:
                                    type: integer
                                  fee_payer:
                                    type:
                                    - string
                                    - 'null'
                                  matches:
                                    type: string
                      deployer_stats:
                        anyOf:
                        - type: object
                          required:
                          - tokens_launched
                          - graduation_rate
                          properties:
                            tokens_launched:
                              type: integer
                            graduation_rate:
                              type: number
                        - type: 'null'
                      checks_unavailable:
                        type: array
                        items:
                          type: string
                      note:
                        type: string
                  freshness:
                    type: object
                    required:
                    - observed_at
                    - cache_age_s
                    - cached
                    - cache_ttl_s
                    properties:
                      observed_at:
                        type: string
                        format: date-time
                      cache_age_s:
                        type: number
                      cached:
                        type: boolean
                      cache_ttl_s:
                        type: integer
                  quota:
                    type: object
                    required:
                    - limit
                    - used
                    - remaining
                    - window_s
                    - reset_after_s
                    - retry_after_s
                    properties:
                      limit:
                        type: integer
                      used:
                        type: integer
                      remaining:
                        type: integer
                      window_s:
                        type: integer
                      reset_after_s:
                        type: integer
                      retry_after_s:
                        type: integer
                  upgrade:
                    type: object
                    description: Optional paid route URLs; HTTP402 is quote authority, no automatic payment
                  agent_guidance:
                    type: object
                    description: Optional additive agent instructions; does not replace x402 headers or the original result.
                    properties:
                      code:
                        type: string
                      next_action:
                        type: string
                      payment_status:
                        type: string
                        enum:
                        - settled
                        - not_charged
                        - unknown
                      payment_allowed:
                        type: boolean
                        description: Advisory only; server preflight enforces input validity.
                      instructions:
                        type: array
                        items:
                          type: string
                      examples:
                        type: array
                        items:
                          type: object
                      documentation:
                        type: string
                      schema:
                        type: string
                      request_example:
                        type: object
                        required:
                        - type
                        - executable
                        - explanation
                        - effects
                        - payment_proof_required
                        - new_authorization_allowed
                        description: Recommended NEXT action. A blueprint is not executable until its required original context or actual inputs are supplied. No signing or payment is performed by returning this object.
                        properties:
                          type:
                            type: string
                            enum:
                            - http
                            - mcp
                            - original_context
                            - original_request
                            - manual
                            - none
                          executable:
                            type: boolean
                          explanation:
                            type: string
                          payment_proof_required:
                            type: boolean
                          new_authorization_allowed:
                            type: boolean
                          effects:
                            type: object
                            required:
                            - payment
                            - analysis
                            properties:
                              payment:
                                type: string
                                enum:
                                - none
                                - may_settle_original_authorization
                                - may_settle_reviewed_authorization
                              analysis:
                                type: string
                                enum:
                                - none
                                - read_operation_schema
                                - read_existing_job
                                - request_free_token_analysis
                                - read_advisor_catalog
                                - resume_or_recover_existing_job
                                - start_or_complete_analysis
                                - attempt_free_retry
                          method:
                            type: string
                          url:
                            type: string
                          url_template:
                            type: string
                          requires:
                            type: array
                            items:
                              type: string
                          request_source:
                            type: string
                          body_fields:
                            type: object
                      payment:
                        type: object
                        required:
                        - status
                        - charge_outcome
                        - explanation
                        - next_action
                        properties:
                          status:
                            type: string
                            enum:
                            - not_required
                            - not_started
                            - not_settled
                            - confirmation_pending
                            - settled
                            - reconciliation_required
                            - unconfirmed
                          charge_outcome:
                            type: string
                            enum:
                            - not_applicable
                            - not_charged
                            - charged
                            - unconfirmed
                          explanation:
                            type: string
                          next_action:
                            type: string
                          new_authorization_allowed:
                            type: boolean
                          background_reconciliation_available:
                            type: boolean
                            const: false
                          legacy_charged_note:
                            type: string
                      analysis:
                        type: object
                        required:
                        - status
                        - result_available
                        - explanation
                        properties:
                          status:
                            type: string
                            enum:
                            - not_started
                            - waiting_for_payment
                            - queued
                            - running
                            - processing
                            - completed
                            - failed
                            - review_required
                            - not_reported
                          result_available:
                            type: boolean
                          explanation:
                            type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
                properties:
                  agent_guidance:
                    type: object
                    description: Optional additive agent instructions; does not replace x402 headers or the original result.
                    properties:
                      code:
                        type: string
                      next_action:
                        type: string
                      payment_status:
                        type: string
                        enum:
                        - settled
                        - not_charged
                        - unknown
                      payment_allowed:
                        type: boolean
                        description: Advisory only; server preflight enforces input validity.
                      instructions:
                        type: array
                        items:
                          type: string
                      examples:
                        type: array
                        items:
                          type: object
                      documentation:
                        type: string
                      schema:
                        type: string
                      request_example:
                        type: object
                        required:
                        - type
                        - executable
                        - explanation
                        - effects
                        - payment_proof_required
                        - new_authorization_allowed
                        description: Recommended NEXT action. A blueprint is not executable until its required original context or actual inputs are supplied. No signing or payment is performed by returning this object.
                        properties:
                          type:
                            type: string
                            enum:
                            - http
                            - mcp
                            - original_context
                            - original_request
                            - manual
                            - none
                          executable:
                            type: boolean
                          explanation:
                            type: string
                          payment_proof_required:
                            type: boolean
                          new_authorization_allowed:
                            type: boolean
                          effects:
                            type: object
                            required:
                            - payment
                            - analysis
                            properties:
                              payment:
                                type: string
                                enum:
                                - none
                                - may_settle_original_authorization
                                - may_settle_reviewed_authorization
                              analysis:
                                type: string
                                enum:
                                - none
                                - read_operation_schema
                                - read_existing_job
                                - request_free_token_analysis
                                - read_advisor_catalog
                                - resume_or_recover_existing_job
                                - start_or_complete_analysis
                                - attempt_free_retry
                          method:
                            type: string
                          url:
                            type: string
                          url_template:
                            type: string
                          requires:
                            type: array
                            items:
                              type: string
                          request_source:
                            type: string
                          body_fields:
                            type: object
                      payment:
                        type: object
                        required:
                        - status
                        - charge_outcome
                        - explanation
                        - next_action
                        properties:
                          status:
                            type: string
                            enum:
                            - not_required
                            - not_started
                            - not_settled
                            - confirmation_pending
                            - settled
                            - reconciliation_required
                            - unconfirmed
                          charge_outcome:
                            type: string
                            enum:
                            - not_applicable
                            - not_charged
                            - charged
                            - unconfirmed
                          explanation:
                            type: string
                          next_action:
                            type: string
                          new_authorization_allowed:
                            type: boolean
                          background_reconciliation_available:
                            type: boolean
                            const: false
                          legacy_charged_note:
                            type: string
                      analysis:
                        type: object
                        required:
                        - status
                        - result_available
                        - explanation
                        properties:
                          status:
                            type: string
                            enum:
                            - not_started
                            - waiting_for_payment
                            - queued
                            - running
                            - processing
                            - completed
                            - failed
                            - review_required
                            - not_reported
                          result_available:
                            type: boolean
                          explanation:
                            type: string
        '429':
          description: Temporary quota or global trial capacity reached; Retry-After in seconds
        '400':
          description: Invalid Solana mint; no upstream work
        '404':
          description: No resolvable token analysis
        '503':
          description: Trial identity or upstream unavailable; no charge
      security: []
      tags:
      - Trial
components:
  schemas:
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
x-provenance:
  method: harvested
  publisher: RugShield
  source: https://getrugshield.com/openapi.json
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)