{
  "openapi": "3.0.1",
  "info": {
    "title": "Rug Pull Risk Scorer",
    "description": "Normalize authorized or licensed token risk records into provenance-linked review rows with stable identity, freshness, visible gaps, human actions, and current-run settlement. Zero external source requests or automated business decisions.",
    "version": "0.2",
    "x-build-id": "rLBHgfuff8pM2dIcW"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/zinin~rug-pull-scorer/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-zinin-rug-pull-scorer",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/zinin~rug-pull-scorer/runs": {
      "post": {
        "operationId": "runs-sync-zinin-rug-pull-scorer",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/zinin~rug-pull-scorer/run-sync": {
      "post": {
        "operationId": "run-sync-zinin-rug-pull-scorer",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "properties": {
          "schemaVersion": {
            "title": "Contract version",
            "enum": [
              "2.0"
            ],
            "type": "string",
            "description": "Use the current closed input contract version.",
            "default": "2.0"
          },
          "authorization": {
            "title": "Rights confirmation",
            "enum": [
              "I confirm I may process and commercially use these submitted records."
            ],
            "type": "string",
            "description": "Confirm that you may process and commercially use every submitted record.",
            "default": "I confirm I may process and commercially use these submitted records."
          },
          "sourceContext": {
            "title": "Source context",
            "enum": [
              "buyer_owned_export",
              "owner_authorized_export",
              "licensed_commercial_feed",
              "other_authorized_export"
            ],
            "type": "string",
            "description": "Describe why the structured export is authorized for this processing.",
            "default": "buyer_owned_export"
          },
          "batchName": {
            "title": "Batch name",
            "pattern": "\\S",
            "minLength": 1,
            "maxLength": 80,
            "type": "string",
            "description": "Choose a non-sensitive label for this evidence-review batch.",
            "default": "rug-pull-scorer-evidence-review"
          },
          "freshnessHours": {
            "title": "Freshness threshold (hours)",
            "minimum": 1,
            "maximum": 8760,
            "type": "integer",
            "description": "Mark evidence older than this threshold as stale for human review.",
            "default": 168
          },
          "records": {
            "title": "Authorized token risk records",
            "minItems": 1,
            "maxItems": 100,
            "type": "array",
            "description": "Submit bounded structured records with stable identity, provenance, licence context, and changes made.",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "required": [
                "sourceRecordId",
                "title",
                "url",
                "sourceName",
                "sourceUrl",
                "sourceLicense",
                "sourceRetrievedAt",
                "changesMade",
                "attributes"
              ],
              "properties": {
                "sourceRecordId": {
                  "title": "Source record ID",
                  "description": "Stable identifier from the authorized source export.",
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "pattern": "\\S"
                },
                "title": {
                  "title": "Record title",
                  "description": "Buyer-supplied title preserved for review.",
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 300,
                  "pattern": "\\S"
                },
                "summary": {
                  "title": "Record summary",
                  "description": "Optional bounded buyer-supplied summary.",
                  "type": "string",
                  "nullable": true,
                  "maxLength": 700
                },
                "entityName": {
                  "title": "Entity name",
                  "description": "Optional buyer-supplied entity or subject label.",
                  "type": "string",
                  "nullable": true,
                  "maxLength": 300
                },
                "category": {
                  "title": "Category",
                  "description": "Optional buyer-supplied category label.",
                  "type": "string",
                  "nullable": true,
                  "maxLength": 100
                },
                "occurredAt": {
                  "title": "Occurred at",
                  "description": "Optional buyer-supplied UTC event time.",
                  "type": "string",
                  "nullable": true,
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,9})?Z$"
                },
                "url": {
                  "title": "Record URL",
                  "description": "Credential-free HTTPS provenance URL recorded but never fetched.",
                  "type": "string",
                  "pattern": "^https://"
                },
                "sourceName": {
                  "title": "Source name",
                  "description": "Buyer-supplied name of the owned, authorized, or licensed export.",
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200,
                  "pattern": "\\S"
                },
                "sourceUrl": {
                  "title": "Source URL",
                  "description": "Credential-free HTTPS source reference recorded but never fetched.",
                  "type": "string",
                  "pattern": "^https://"
                },
                "sourceLicense": {
                  "title": "Source licence",
                  "description": "Buyer-supplied rights or licence statement for commercial processing.",
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 700,
                  "pattern": "\\S"
                },
                "sourceRetrievedAt": {
                  "title": "Source retrieved at",
                  "description": "Buyer-supplied UTC time when the structured export was obtained.",
                  "type": "string",
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,9})?Z$"
                },
                "changesMade": {
                  "title": "Changes made",
                  "description": "Describe normalization or transformations already applied to the record.",
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 500,
                  "pattern": "\\S"
                },
                "attributes": {
                  "title": "Product attributes",
                  "description": "Product-specific buyer-supplied fields preserved without external verification.",
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "token": {
                      "title": "Token",
                      "description": "Buyer-supplied token value; preserved without external verification.",
                      "type": "string",
                      "nullable": true,
                      "maxLength": 500
                    },
                    "symbol": {
                      "title": "Symbol",
                      "description": "Buyer-supplied symbol value; preserved without external verification.",
                      "type": "string",
                      "nullable": true,
                      "maxLength": 500
                    },
                    "riskLabel": {
                      "title": "Risk Label",
                      "description": "Buyer-supplied risk label value; preserved without external verification.",
                      "type": "string",
                      "nullable": true,
                      "maxLength": 500
                    },
                    "riskScore": {
                      "title": "Risk Score",
                      "description": "Buyer-supplied risk score value; preserved without external verification.",
                      "type": "number",
                      "nullable": true
                    },
                    "isHoneypot": {
                      "title": "Is Honeypot",
                      "description": "Buyer-supplied is honeypot value; preserved without external verification.",
                      "type": "boolean",
                      "nullable": true
                    },
                    "confidence": {
                      "title": "Confidence",
                      "description": "Buyer-supplied confidence value; preserved without external verification.",
                      "type": "string",
                      "nullable": true,
                      "maxLength": 500
                    },
                    "buyTax": {
                      "title": "Buy Tax",
                      "description": "Buyer-supplied buy tax value; preserved without external verification.",
                      "type": "number",
                      "nullable": true
                    },
                    "sellTax": {
                      "title": "Sell Tax",
                      "description": "Buyer-supplied sell tax value; preserved without external verification.",
                      "type": "number",
                      "nullable": true
                    },
                    "liquidityUsd": {
                      "title": "Liquidity Usd",
                      "description": "Buyer-supplied liquidity usd value; preserved without external verification.",
                      "type": "number",
                      "nullable": true
                    },
                    "checksSkipped": {
                      "title": "Checks Skipped",
                      "description": "Buyer-supplied checks skipped value; preserved without external verification.",
                      "type": "array",
                      "maxItems": 20,
                      "items": {
                        "type": "string",
                        "maxLength": 200
                      }
                    },
                    "riskFlags": {
                      "title": "Risk Flags",
                      "description": "Buyer-supplied risk flags value; preserved without external verification.",
                      "type": "array",
                      "maxItems": 20,
                      "items": {
                        "type": "string",
                        "maxLength": 200
                      }
                    }
                  }
                }
              }
            },
            "default": [
              {
                "sourceRecordId": "demo-token-001",
                "title": "Example token risk evidence",
                "summary": "Submitted risk observations normalized for analyst review; not investment advice.",
                "entityName": "0x0000000000000000000000000000000000000001",
                "category": "token-risk",
                "occurredAt": "2026-08-01T10:00:00.000Z",
                "url": "https://exports.example.com/token/demo-001",
                "sourceName": "Licensed token risk export",
                "sourceUrl": "https://exports.example.com/token",
                "sourceLicense": "Buyer confirms commercial processing rights for the submitted evidence.",
                "sourceRetrievedAt": "2026-08-01T10:00:00.000Z",
                "changesMade": "Numeric values normalized; no on-chain or provider request made.",
                "attributes": {
                  "token": "0x0000000000000000000000000000000000000001",
                  "symbol": "DEMO",
                  "riskLabel": "review",
                  "riskScore": 55,
                  "isHoneypot": null,
                  "confidence": "buyer_asserted",
                  "buyTax": null,
                  "sellTax": null,
                  "liquidityUsd": 250000,
                  "checksSkipped": [
                    "live_simulation"
                  ],
                  "riskFlags": [
                    "source_not_verified"
                  ]
                }
              }
            ]
          },
          "tokens": {
            "title": "Legacy tokens (migration only)",
            "minItems": 1,
            "maxItems": 100,
            "type": "array",
            "description": "Retained for compatibility. No source request is made; this mode emits one free migration diagnostic.",
            "items": {
              "type": "string",
              "minLength": 1,
              "maxLength": 100,
              "pattern": "\\S"
            }
          },
          "chainId": {
            "title": "Legacy chainId (migration only)",
            "minimum": 1,
            "maximum": 1000000,
            "type": "integer",
            "description": "Retained for compatibility. No source request is made; this mode emits one free migration diagnostic."
          },
          "maxConcurrency": {
            "title": "Legacy maxConcurrency (migration only)",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Retained for compatibility. No source request is made; this mode emits one free migration diagnostic."
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}