{
  "openapi": "3.1.0",
  "info": {
    "title": "Nulucre Agents",
    "version": "3.0.0",
    "guidance": "Call GET /reputation/{wallet} for EVM wallet scores. Call GET /reputation/stellar/{gAddress} for Stellar native wallet scores using 8 Horizon signals including claimable balances, Soroban interactions, liquidity pools and spam detection. All endpoints accept 7 currencies via x402.",
    "description": "On-chain credit score for AI agents. Scores EVM wallets 0-100 across 81+ chains and Stellar native G... wallets using 8 Stellar-specific signals via Horizon API. Accepts USDC on Base mainnet plus USDC, EURC, MXNT, NGNT, ARST, BRL on Stellar pubnet via x402.",
    "contact": {
      "url": "https://nulucre.com",
      "email": "info@nulucre.com"
    },
    "x-payment-address": "0xd97C122cB81894213C67Bcc774448955d09915bC",
    "x-payment-network": "base",
    "x-payment-asset": "USDC",
    "x-payment-networks": [
      "base-mainnet",
      "stellar:pubnet"
    ],
    "x-payment-currencies": [
      "USDC",
      "EURC",
      "MXNT",
      "NGNT",
      "ARST",
      "BRL"
    ],
    "x-stellar-scoring-signals": [
      "account_age",
      "transaction_volume",
      "asset_diversity",
      "dex_participation",
      "network_trust",
      "claimable_balance_activity",
      "soroban_contract_interactions",
      "liquidity_pool_participation",
      "spam_detection_penalty"
    ]
  },
  "paths": {
    "/reputation/{wallet}": {
      "get": {
        "summary": "Get wallet reputation score",
        "parameters": [
          {
            "name": "wallet",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "example": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Wallet trust score 0-100",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "wallet": {
                      "type": "string"
                    },
                    "score": {
                      "type": "number"
                    },
                    "status": {
                      "type": "string",
                      "enum": [
                        "TRUSTED",
                        "VERIFIED",
                        "CAUTION",
                        "RISKY",
                        "BLACKLISTED"
                      ]
                    },
                    "breakdown": {
                      "type": "object"
                    },
                    "chains": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "timestamp": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "402": {
            "description": "Payment Required"
          }
        },
        "x-payment-info": {
          "protocols": [
            "x402"
          ],
          "pricingMode": "fixed",
          "price": "0.003"
        }
      }
    },
    "/reputation/signed/{wallet}": {
      "get": {
        "summary": "Get ECDSA signed wallet reputation score",
        "parameters": [
          {
            "name": "wallet",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "example": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Signed wallet trust score with ECDSA proof",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "wallet": {
                      "type": "string"
                    },
                    "score": {
                      "type": "number"
                    },
                    "status": {
                      "type": "string"
                    },
                    "proof": {
                      "type": "object",
                      "properties": {
                        "signature": {
                          "type": "string"
                        },
                        "algorithm": {
                          "type": "string"
                        },
                        "signedBy": {
                          "type": "string"
                        },
                        "verifyAt": {
                          "type": "string"
                        }
                      }
                    },
                    "timestamp": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "402": {
            "description": "Payment Required"
          }
        },
        "x-payment-info": {
          "protocols": [
            "x402"
          ],
          "pricingMode": "fixed",
          "price": "0.01"
        }
      }
    },
    "/verify": {
      "post": {
        "summary": "Verify DeFi TVL claim",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "claim": {
                    "type": "string",
                    "example": "Aave has 12B TVL"
                  },
                  "protocol": {
                    "type": "string",
                    "example": "aave"
                  }
                },
                "required": [
                  "claim"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Verdict ACCURATE MISLEADING or FALSE",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "verdict": {
                      "type": "string",
                      "enum": [
                        "ACCURATE",
                        "MOSTLY_ACCURATE",
                        "INACCURATE",
                        "MISLEADING",
                        "FALSE"
                      ]
                    },
                    "claimedTvl": {
                      "type": "string"
                    },
                    "actualTvl": {
                      "type": "string"
                    },
                    "discrepancy": {
                      "type": "string"
                    },
                    "source": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          },
          "402": {
            "description": "Payment Required"
          }
        },
        "x-payment-info": {
          "protocols": [
            "x402"
          ],
          "pricingMode": "fixed",
          "price": "0.01"
        }
      }
    },
    "/reputation/stellar/{gAddress}": {
      "get": {
        "summary": "Stellar wallet reputation score",
        "description": "Returns 0-100 trust score for native Stellar G... wallet addresses",
        "parameters": [
          {
            "name": "gAddress",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    }
  }
}