RugShield Trial API
The Trial API from RugShield — 1 operation(s) for trial.
Operations 1
GET
/v1/trial/token-risk/{mint}
Free own-code token risk trial; recurring temporary quota, no payment
#
The Trial API from RugShield — 1 operation(s) for trial.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/getrugshield-com:getrugshield-com-trial-api"
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.
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: 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)