GenTech Labs Paid API

openapi: 3.2.0
info:
  title: GenTech Labs x402 Gateway Paid API
  version: 9.4.1
  description: 'GenTech Labs x402 Gateway — 14 pay-per-call services for AI agents: DeFi intelligence, yield scanning, wallet analysis, agent identity/trust, market data and treasury defense. No account, no API key: an agent pays per call in USD₮0 / USD Coin over x402. 5 settlement rails: xlayer, base, avalanche, algorand, solana. Withheld services are listed under x-withheld WITH their reason rather than advertised.'
  contact:
    email: jordanjones0902@gmail.com
    name: GenTech Labs
    url: https://gentechlabs.net
  x-guidance: '14 pay-per-call services, one path per service under `paths` (a templated route, plus a concrete probeable `examples` URL where we publish one — callers that cannot resolve a template should use the concrete form). treasury_defender (Airdrop & dust-token defense); defi_lp_analytics (DeFi LP pool analysis with efficiency scoring via De); wallet_analysis (Wallet portfolio analysis with token balances and US); agent_discovery (Search the ERC-8004 registry for on-chain AI agents); market_intelligence (Real-time crypto market price data); token_security (Solana token risk scoring and rugcheck analysis (11 ); lineage_guard (Data lineage blast-radius guard); deal_tracker (Game deal tracking, price-watch, and release radar (); agent_research (On-demand AI agent research and analysis); nft_search (NFT collection search across Solana via Magic Eden); score (MSS v2 model strength + sovereignty score (0-850) - ); route (Route across registered model providers with x402 se); providers (List registered model providers in the Sovereign Rou); gas_oracle (Live gas prices (gwei) for Ethereum, Base, Polygon) Unauthenticated calls return HTTP 402 with x402 payment requirements (USD₮0 / USD Coin, payable on 5 settlement rails: xlayer, base, avalanche, algorand, solana). Pay per rail and retry with the x402 authorization header.'
servers:
- url: https://api.gentechlabs.net
security:
- x402: []
tags:
- name: paid
paths:
  /v1/defender/classify/43114/0x8e53ad52980478794bb5b459b7cbdd836975e4cb:
    get:
      summary: 'Airdrop & dust-token defense: classify any token as KNOWN/SUSPICIOUS (homoglyph…'
      operationId: treasury_defender_get
      tags:
      - paid
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.008'
        protocols:
        - x402: {}
      responses:
        '402':
          description: Payment required
        '200':
          description: OK
      parameters:
      - name: chainId
        in: path
        required: true
        schema:
          type: string
        description: Numeric chain id (1 Ethereum, 8453 Base, 42161 Arbitrum)
      - name: token
        in: path
        required: true
        schema:
          type: string
        description: Token symbol or contract address
      x-concrete-example: true
      x-resource-template: /v1/defender/classify/{chainId}/{token}
  /v1/defi/lp/0x7ebff188f2Eba16518C02864589b1403a5d1296a:
    get:
      summary: DeFi LP pool analysis with efficiency scoring via DexScreener
      operationId: defi_lp_analytics_get
      tags:
      - paid
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.002'
        protocols:
        - x402: {}
      responses:
        '402':
          description: Payment required
        '200':
          description: OK
      parameters:
      - name: address
        in: path
        required: true
        schema:
          type: string
        description: EVM wallet or token contract address (0x-prefixed)
      x-concrete-example: true
      x-resource-template: /v1/defi/lp/{address}
  /v1/wallet/portfolio/0x7ebff188f2Eba16518C02864589b1403a5d1296a:
    get:
      summary: Wallet portfolio analysis with token balances and USD valuation
      operationId: wallet_analysis_get
      tags:
      - paid
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.002'
        protocols:
        - x402: {}
      responses:
        '402':
          description: Payment required
        '200':
          description: OK
      parameters:
      - name: address
        in: path
        required: true
        schema:
          type: string
        description: EVM wallet or token contract address (0x-prefixed)
      x-concrete-example: true
      x-resource-template: /v1/wallet/portfolio/{address}
  /v1/agents/search:
    get:
      summary: Search the ERC-8004 registry for on-chain AI agents
      operationId: agent_discovery_get
      tags:
      - paid
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.002'
        protocols:
        - x402: {}
      responses:
        '402':
          description: Payment required
        '200':
          description: OK
      parameters:
      - name: q
        in: query
        required: false
        schema:
          type: string
        description: Free-text search query
      x-concrete-example: true
  /v1/market/price/ETH:
    get:
      summary: Real-time crypto market price data
      operationId: market_intelligence_get
      tags:
      - paid
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.001'
        protocols:
        - x402: {}
      responses:
        '402':
          description: Payment required
        '200':
          description: OK
      parameters:
      - name: symbol
        in: path
        required: true
        schema:
          type: string
        description: Asset symbol or token id to look up (e.g. ETH, BTC, SOL)
      x-concrete-example: true
      x-resource-template: /v1/market/price/{symbol}
  /v1/security/score/EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v:
    get:
      summary: 'Solana token risk scoring and rugcheck analysis (11 factors: honeypot, freeze…'
      operationId: token_security_get
      tags:
      - paid
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.005'
        protocols:
        - x402: {}
      responses:
        '402':
          description: Payment required
        '200':
          description: OK
      parameters:
      - name: address
        in: path
        required: true
        schema:
          type: string
        description: EVM wallet or token contract address (0x-prefixed)
      x-concrete-example: true
      x-resource-template: /v1/security/score/{address}
  /v1/security/score/0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913:
    get:
      summary: 'Solana token risk scoring and rugcheck analysis (11 factors: honeypot, freeze…'
      operationId: getV1SecurityScore0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913
      tags:
      - paid
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.005'
        protocols:
        - x402: {}
      responses:
        '402':
          description: Payment required
        '200':
          description: OK
      parameters:
      - name: address
        in: path
        required: true
        schema:
          type: string
        description: EVM wallet or token contract address (0x-prefixed)
      x-concrete-example: true
      x-resource-template: /v1/security/score/{address}
      x-operation-id-source: normalized
      x-operation-id-original: token_security_get
  /v1/lineage/guard:
    get:
      summary: 'Data lineage blast-radius guard: ''what breaks if I drop/change this table?''…'
      operationId: lineage_guard_get
      tags:
      - paid
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.05'
        protocols:
        - x402: {}
      responses:
        '402':
          description: Payment required
        '200':
          description: OK
      parameters:
      - name: urn
        in: query
        required: false
        schema:
          type: string
        description: Dataset URN identifying the lineage record to trace
      x-concrete-example: true
  /v1/nft/search:
    get:
      summary: NFT collection search across Solana via Magic Eden
      operationId: nft_search_get
      tags:
      - paid
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.002'
        protocols:
        - x402: {}
      responses:
        '402':
          description: Payment required
        '200':
          description: OK
      parameters:
      - name: q
        in: query
        required: false
        schema:
          type: string
        description: Free-text search query
      x-concrete-example: true
  /v1/gas/gas:
    get:
      summary: Live gas prices (gwei) for Ethereum, Base, Polygon.
      operationId: gas_oracle_get
      tags:
      - paid
      x-payment-info:
        price:
          mode: fixed
          currency: USD
          amount: '0.001'
        protocols:
        - x402: {}
      responses:
        '402':
          description: Payment required
        '200':
          description: OK
      parameters: []
      x-concrete-example: true
components:
  securitySchemes:
    x402:
      type: http
      scheme: bearer
      description: 'x402 payment proof. Call without a proof to receive HTTP 402 with payment requirements (USD₮0 / USD Coin, payable on 5 settlement rails: xlayer, base, avalanche, algorand, solana). Pay per rail and retry with the x402 authorization header.'
x-gateway-fallback:
  path: /v1/{service}/{path}
  note: 'Still served for callers that already use it, but NOT advertised: a templated catch-all is not a callable resource. Use the concrete paths in `paths`.'
x-withheld:
- service: deal_tracker
  reason: 'BLOCKED BY POLICY: upstream terms objection 2026-11-01 - pending per-source audit'
- service: agent_research
  reason: 'BLOCKED BY POLICY: no source recovered - cannot be served'
- service: score
  reason: 'NOT_READY: nothing listening on 8087 (ConnectionRefusedError)'
- service: route
  reason: 'NOT_READY: nothing listening on 8087 (ConnectionRefusedError)'
- service: providers
  reason: 'NOT_READY: nothing listening on 8087 (ConnectionRefusedError)'
x-withheld-note: Services in our catalogue that cannot be served at this moment. They are omitted from `paths` rather than advertised, and a call to one is refused with 503 and a reason before any payment challenge is issued.