{
  "openapi": "3.0.1",
  "info": {
    "title": "GMGN CopyTrade Wallet Scraper",
    "description": "Scrape GMGN.ai copytrade wallet leaderboards across Solana, Ethereum, BSC, Base, Tron, and Monad. Extract wallet PnL, win rates, realized profit, transactions, balances, tags, and social profiles. Filter by trader type, sort by any metric. Export JSON, CSV, Excel.",
    "version": "1.0",
    "x-build-id": "5aZPXeDetdHND80bD"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/parsebird~gmgn-copytrade-wallet-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-parsebird-gmgn-copytrade-wallet-scraper",
        "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/parsebird~gmgn-copytrade-wallet-scraper/runs": {
      "post": {
        "operationId": "runs-sync-parsebird-gmgn-copytrade-wallet-scraper",
        "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/parsebird~gmgn-copytrade-wallet-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-parsebird-gmgn-copytrade-wallet-scraper",
        "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",
        "required": [
          "chain"
        ],
        "properties": {
          "chain": {
            "title": "Blockchain",
            "enum": [
              "sol",
              "eth",
              "bsc",
              "base",
              "tron",
              "monad"
            ],
            "type": "string",
            "description": "Blockchain network to scan for copytrade wallets.",
            "default": "sol"
          },
          "traderType": {
            "title": "Trader Type",
            "enum": [
              "all",
              "smart_degen",
              "launchpad_smart",
              "smart_money",
              "kol",
              "fresh_wallet",
              "sniper",
              "top_followed",
              "top_renamed",
              "top_dev",
              "live"
            ],
            "type": "string",
            "description": "GMGN wallet category. Use 'All' for the full leaderboard or pick a smart-money category for a narrower list.",
            "default": "smart_degen"
          },
          "sortBy": {
            "title": "Sort By",
            "enum": [
              "profit_1d",
              "profit_7d",
              "profit_30d",
              "pnl_1d",
              "pnl_7d",
              "pnl_30d",
              "winrate_1d",
              "winrate_7d",
              "winrate_30d",
              "txs_1d",
              "txs_7d",
              "txs_30d",
              "volume_1d",
              "volume_7d",
              "volume_30d",
              "netflow_1d",
              "netflow_7d",
              "netflow_30d",
              "last_active",
              "balance",
              "follow_count",
              "remark_count"
            ],
            "type": "string",
            "description": "Ranking metric to sort wallets by.",
            "default": "profit_7d"
          },
          "sortDirection": {
            "title": "Sort Direction",
            "enum": [
              "desc",
              "asc"
            ],
            "type": "string",
            "description": "Sort order: descending (highest first) or ascending (lowest first).",
            "default": "desc"
          },
          "maxWallets": {
            "title": "Maximum Wallets",
            "minimum": 1,
            "maximum": 500,
            "type": "integer",
            "description": "Maximum number of wallets to scrape. Start low (25) for a quick test, then increase for larger exports.",
            "default": 100
          },
          "min_pnl_7d": {
            "title": "Min 7D PnL (%)",
            "type": "number",
            "description": "Minimum 7-day PnL percentage."
          },
          "max_pnl_7d": {
            "title": "Max 7D PnL (%)",
            "type": "number",
            "description": "Maximum 7-day PnL percentage."
          },
          "min_profit_7d": {
            "title": "Min 7D Profit (USD)",
            "type": "number",
            "description": "Minimum 7-day realized profit in USD."
          },
          "max_profit_7d": {
            "title": "Max 7D Profit (USD)",
            "type": "number",
            "description": "Maximum 7-day realized profit in USD."
          },
          "min_winrate_7d": {
            "title": "Min 7D Win Rate (%)",
            "type": "number",
            "description": "Minimum 7-day win rate percentage (0–100)."
          },
          "max_winrate_7d": {
            "title": "Max 7D Win Rate (%)",
            "type": "number",
            "description": "Maximum 7-day win rate percentage (0–100)."
          },
          "min_txs_7d": {
            "title": "Min 7D Transactions",
            "type": "integer",
            "description": "Minimum 7-day transaction count."
          },
          "max_txs_7d": {
            "title": "Max 7D Transactions",
            "type": "integer",
            "description": "Maximum 7-day transaction count."
          },
          "min_volume_7d": {
            "title": "Min 7D Volume (USD)",
            "type": "number",
            "description": "Minimum 7-day trading volume in USD."
          },
          "max_volume_7d": {
            "title": "Max 7D Volume (USD)",
            "type": "number",
            "description": "Maximum 7-day trading volume in USD."
          },
          "min_netflow_7d": {
            "title": "Min 7D Net Inflow (USD)",
            "type": "number",
            "description": "Minimum 7-day net inflow in USD."
          },
          "max_netflow_7d": {
            "title": "Max 7D Net Inflow (USD)",
            "type": "number",
            "description": "Maximum 7-day net inflow in USD."
          },
          "min_pnl_1d": {
            "title": "Min 1D PnL (%)",
            "type": "number",
            "description": "Minimum 1-day PnL percentage."
          },
          "max_pnl_1d": {
            "title": "Max 1D PnL (%)",
            "type": "number",
            "description": "Maximum 1-day PnL percentage."
          },
          "min_profit_1d": {
            "title": "Min 1D Profit (USD)",
            "type": "number",
            "description": "Minimum 1-day realized profit in USD."
          },
          "max_profit_1d": {
            "title": "Max 1D Profit (USD)",
            "type": "number",
            "description": "Maximum 1-day realized profit in USD."
          },
          "min_winrate_1d": {
            "title": "Min 1D Win Rate (%)",
            "type": "number",
            "description": "Minimum 1-day win rate percentage (0–100)."
          },
          "max_winrate_1d": {
            "title": "Max 1D Win Rate (%)",
            "type": "number",
            "description": "Maximum 1-day win rate percentage (0–100)."
          },
          "min_txs_1d": {
            "title": "Min 1D Transactions",
            "type": "integer",
            "description": "Minimum 1-day transaction count."
          },
          "max_txs_1d": {
            "title": "Max 1D Transactions",
            "type": "integer",
            "description": "Maximum 1-day transaction count."
          },
          "min_volume_1d": {
            "title": "Min 1D Volume (USD)",
            "type": "number",
            "description": "Minimum 1-day trading volume in USD."
          },
          "max_volume_1d": {
            "title": "Max 1D Volume (USD)",
            "type": "number",
            "description": "Maximum 1-day trading volume in USD."
          },
          "min_netflow_1d": {
            "title": "Min 1D Net Inflow (USD)",
            "type": "number",
            "description": "Minimum 1-day net inflow in USD."
          },
          "max_netflow_1d": {
            "title": "Max 1D Net Inflow (USD)",
            "type": "number",
            "description": "Maximum 1-day net inflow in USD."
          },
          "min_pnl_30d": {
            "title": "Min 30D PnL (%)",
            "type": "number",
            "description": "Minimum 30-day PnL percentage."
          },
          "max_pnl_30d": {
            "title": "Max 30D PnL (%)",
            "type": "number",
            "description": "Maximum 30-day PnL percentage."
          },
          "min_profit_30d": {
            "title": "Min 30D Profit (USD)",
            "type": "number",
            "description": "Minimum 30-day realized profit in USD."
          },
          "max_profit_30d": {
            "title": "Max 30D Profit (USD)",
            "type": "number",
            "description": "Maximum 30-day realized profit in USD."
          },
          "min_winrate_30d": {
            "title": "Min 30D Win Rate (%)",
            "type": "number",
            "description": "Minimum 30-day win rate percentage (0–100)."
          },
          "max_winrate_30d": {
            "title": "Max 30D Win Rate (%)",
            "type": "number",
            "description": "Maximum 30-day win rate percentage (0–100)."
          },
          "min_txs_30d": {
            "title": "Min 30D Transactions",
            "type": "integer",
            "description": "Minimum 30-day transaction count."
          },
          "max_txs_30d": {
            "title": "Max 30D Transactions",
            "type": "integer",
            "description": "Maximum 30-day transaction count."
          },
          "min_volume_30d": {
            "title": "Min 30D Volume (USD)",
            "type": "number",
            "description": "Minimum 30-day trading volume in USD."
          },
          "max_volume_30d": {
            "title": "Max 30D Volume (USD)",
            "type": "number",
            "description": "Maximum 30-day trading volume in USD."
          },
          "min_netflow_30d": {
            "title": "Min 30D Net Inflow (USD)",
            "type": "number",
            "description": "Minimum 30-day net inflow in USD."
          },
          "max_netflow_30d": {
            "title": "Max 30D Net Inflow (USD)",
            "type": "number",
            "description": "Maximum 30-day net inflow in USD."
          },
          "min_avg_cost": {
            "title": "Min Average Cost (USD)",
            "type": "number",
            "description": "Minimum average cost per trade in USD."
          },
          "max_avg_cost": {
            "title": "Max Average Cost (USD)",
            "type": "number",
            "description": "Maximum average cost per trade in USD."
          },
          "proxyConfiguration": {
            "title": "Proxy Configuration",
            "type": "object",
            "description": "Proxy settings. Residential proxies are recommended for reliable scraping of GMGN.ai."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}