gadgethumans-com Token Verdict API

openapi: 3.2.0
info:
  title: Gadgethumans Com Token Verdict API
  version: 1.1.0
  contact:
    name: GadgetHumans
    email: gadgethumans@agentmail.to
  x-guidance: 'Pay-per-call utility API for agents. Every GET route below takes its listed query parameters (first is required) and returns JSON; POST /swish/v1/chat/completions takes an OpenAI-style JSON body (messages[]). Unauthenticated calls receive HTTP 402 with an x402 challenge in the body (v2, accepts[] carries two entries) and the Payment-Required header: pay the accepted USDC amount either on Base (eip155:8453) to its payTo, or on Solana mainnet (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp, USDC) to its payTo, then retry with the X-PAYMENT header carrying the base64 payment payload. MCP clients can instead install https://api.gadgethumans.com/mcp (49 tools). Route index and per-route parameters are in paths[] below.'
  description: 'Operations tagged Token Verdict across 2 of this provider''s published API definitions: gadgethumans-com-openapi.json, gadgethumans-com-openapi2.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.gadgethumans.com
tags:
- name: Token Verdict
paths:
  /token-verdict:
    get:
      summary: Score a Base token's risk before an agent trades it
      description: 'Use before an agent buys, routes to, swaps or holds a Base token: a scored risk verdict - honeypot simulation, buy and sell tax, owner and mint privileges, verified source, liquidity, holder count and 24h volume - with a 0-100 safety score and named red flags. Poll it: echo the returned watch.change_token back as since= to get ONLY the fields that moved (safety score, honeypot, taxes, mint/owner privileges, liquidity, holders, price) - a pre-trade gate to call before every trade.'
      parameters:
      - name: address
        in: query
        required: true
        description: Base mainnet token contract address, 0x plus 40 hex characters
        schema:
          type: string
          example: '0x4200000000000000000000000000000000000006'
          description: Base mainnet token contract address, 0x plus 40 hex characters (required)
      - name: since
        in: query
        required: false
        description: 'Optional: the watch.change_token returned by your previous call. Send it back to receive ONLY the fields that changed since that snapshot (changed: [{field, from, to}], unchanged: true|false) plus a fresh change_token - so an agent can poll this as a pre-trade gate before every trade instead of re-reading the whole verdict.'
        schema:
          type: string
          description: 'Optional: the watch.change_token returned by your previous call. Send it back to receive ONLY the fields that changed since that snapshot (changed: [{field, from, to}], unchanged: true|false) plus a fresh change_token - so an agent can poll this as a pre-trade gate before every trade instead of re-reading the whole verdict. (optional)'
      x-price: $0.010
      x-payment-protocol: x402
      x-payment-info:
        protocols:
        - x402: {}
        - mpp:
            method: evm
            intent: charge
            currency: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
        price:
          mode: fixed
          currency: USD
          amount: '0.010'
        payTo: '0xe6C34b8E58c8BEA609415f4D0C1Ce01Da48F3A34'
        network: eip155:8453
        asset: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
        offers:
        - method: evm
          intent: charge
          amount: '10000'
          currency: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
          chainId: 8453
          payTo: '0xe6C34b8E58c8BEA609415f4D0C1Ce01Da48F3A34'
          description: USDC on Base
        - method: x402
          intent: charge
          amount: '10000'
          currency: '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913'
          chainId: 8453
          payTo: '0xe6C34b8E58c8BEA609415f4D0C1Ce01Da48F3A34'
          description: USDC on Base
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
        '402':
          description: 'Payment Required: x402 exact scheme, USDC on Base'
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
      tags:
      - Token Verdict
      operationId: getTokenVerdict
      x-operation-id-source: derived
    servers:
    - url: https://api.gadgethumans.com
x-refined-from:
- gadgethumans-com-openapi.json
- gadgethumans-com-openapi2.json
x-discovery:
  ownershipProofs:
  - '0xe6C34b8E58c8BEA609415f4D0C1Ce01Da48F3A34'