FETCH402
← Protocol index

Resource / 411

healthy

Stock Trends Market Intelligence.

Ranked Stock Trends signal screener for agent workflows, using trend state, trend persistence, trend maturity, relative performance, and volume signal fields.

Eligibility
probeable
Failures
0
Last quote
2026-08-13 00:15:02 UTC
Last probe
2026-08-13 00:15:02 UTC
Payment requirements / accepts[] 1 options
State Network Scheme Atomic amount Asset payTo / untrusted
active eip155:8453 exact 500000 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913 0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab

All advertised payment options are stored. Base (`eip155:8453`) is the operational network for ranking and canaries; non-Base options remain visible for transparency.

Probe evidence 1 recent
healthy 2026-08-13 00:15:02 UTC GET · HTTP 402 · 358ms · accepts 1 · base 1 ok
Request
GET https://api.stocktrends.com/v1/agent/screener/top
Robots
error
Note
robots_error:{:robots_http_status, 404};http_402;accepts=1;base=1
Accepts fingerprint
4b3492038a6cf3fd487f2f6180b4ff5de5967969279ba311c066f71469e39633

Accepts snapshot

[
  {
    "amount": "500000",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "assetTransferMethod": null,
    "extra": {
      "name": "USD Coin",
      "resource": {
        "description": "Ranked Stock Trends signal screener for agent workflows, using trend state, trend persistence, trend maturity, relative performance, and volume signal fields.",
        "iconUrl": "https://developer.stocktrends.com/images/stmi-icon.png",
        "mimeType": "application/json",
        "serviceName": "Stock Trends Market Intelligence",
        "tags": [
          "finance",
          "market-intelligence",
          "equities",
          "quantitative-finance",
          "agentic"
        ],
        "url": "https://api.stocktrends.com/v1/agent/screener/top"
      },
      "version": "2"
    },
    "maxTimeoutSeconds": 300,
    "network": "eip155:8453",
    "payTo": "0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab",
    "paymentFlow": null,
    "raw": {
      "amount": "500000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "extra": {
        "name": "USD Coin",
        "resource": {
          "description": "Ranked Stock Trends signal screener for agent workflows, using trend state, trend persistence, trend maturity, relative performance, and volume signal fields.",
          "iconUrl": "https://developer.stocktrends.com/images/stmi-icon.png",
          "mimeType": "application/json",
          "serviceName": "Stock Trends Market Intelligence",
          "tags": [
            "finance",
            "market-intelligence",
            "equities",
            "quantitative-finance",
            "agentic"
          ],
          "url": "https://api.stocktrends.com/v1/agent/screener/top"
        },
        "version": "2"
      },
      "maxTimeoutSeconds": 300,
      "max_timeout_seconds": 300,
      "network": "eip155:8453",
      "payTo": "0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab",
      "pay_to": "0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab",
      "scheme": "exact"
    },
    "scheme": "exact"
  }
]

PaymentRequired raw

{
  "accepts": [
    {
      "amount": "500000",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "extra": {
        "name": "USD Coin",
        "resource": {
          "description": "Ranked Stock Trends signal screener for agent workflows, using trend state, trend persistence, trend maturity, relative performance, and volume signal fields.",
          "iconUrl": "https://developer.stocktrends.com/images/stmi-icon.png",
          "mimeType": "application/json",
          "serviceName": "Stock Trends Market Intelligence",
          "tags": [
            "finance",
            "market-intelligence",
            "equities",
            "quantitative-finance",
            "agentic"
          ],
          "url": "https://api.stocktrends.com/v1/agent/screener/top"
        },
        "version": "2"
      },
      "maxTimeoutSeconds": 300,
      "network": "eip155:8453",
      "payTo": "0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab",
      "scheme": "exact"
    }
  ],
  "extensions": {
    "bazaar": {
      "info": {
        "category": "screener",
        "description": "Ranked Stock Trends signal screener for agent workflows, using trend state, trend persistence, trend maturity, relative performance, and volume signal fields.",
        "family": "screener",
        "input": {
          "method": "GET",
          "queryParams": {
            "limit": 10,
            "min_rsi": 40
          },
          "type": "http"
        },
        "metadataUrl": "https://api.stocktrends.com/v1/ai/context",
        "output": {
          "example": {
            "request_id": "req_demo"
          },
          "format": "application/json",
          "type": "json"
        },
        "pricing_catalog": "https://api.stocktrends.com/v1/pricing/catalog",
        "provenance_reference": {
          "approximate_observation_count": "16M+",
          "classification_framework": "Stock Trends trend classification methodology",
          "full_metadata_endpoints": [
            "/v1/ai/context",
            "/v1/meta/indicators",
            "/v1/meta/stim"
          ],
          "historical_coverage_start_year": 1980,
          "interpretation_limit": "Historical depth supports research and probabilistic interpretation but does not guarantee future performance.",
          "semantic_continuity": "Stock Trends indicators use a consistent classification doctrine across decades of observations."
        },
        "role": "market_intelligence_filter",
        "schemaUrl": "https://api.stocktrends.com/v1/ai/tools",
        "title": "Agent Screener Top",
        "tools_manifest": "https://api.stocktrends.com/v1/ai/tools"
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "additionalProperties": true,
        "properties": {
          "category": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "family": {
            "type": "string"
          },
          "input": {
            "additionalProperties": false,
            "properties": {
              "method": {
                "enum": [
                  "GET"
                ],
                "type": "string"
              },
              "queryParams": {
                "additionalProperties": false,
                "properties": {
                  "exchange": {
                    "enum": [
                      "N",
                      "Q",
                      "A",
                      "B",
                      "T",
                      "I"
                    ],
                    "type": "string"
                  },
                  "limit": {
                    "default": 25,
                    "maximum": 100,
                    "minimum": 1,
                    "type": "integer"
                  },
                  "min_rsi": {
                    "default": 40,
                    "type": "integer"
                  }
                },
                "required": [],
                "type": "object"
              },
              "type": {
                "const": "http",
                "type": "string"
              }
            },
            "required": [
              "type",
              "method"
            ],
            "type": "object"
          },
          "metadataUrl": {
            "type": "string"
          },
          "output": {
            "additionalProperties": true,
            "description": "Ranked instruments with Stock Trends signal fields and filter summary.",
            "properties": {
              "example": {},
              "format": {
                "type": "string"
              },
              "type": {
                "const": "json",
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          },
          "pricing_catalog": {
            "type": "string"
          },
          "schemaUrl": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "tools_manifest": {
            "type": "string"
          }
        },
        "required": [
          "input"
        ],
        "type": "object"
      }
    }
  },
  "resource": {
    "description": "Ranked Stock Trends signal screener for agent workflows, using trend state, trend persistence, trend maturity, relative performance, and volume signal fields.",
    "iconUrl": "https://developer.stocktrends.com/images/stmi-icon.png",
    "mimeType": "application/json",
    "serviceName": "Stock Trends Market Intelligence",
    "tags": [
      "finance",
      "market-intelligence",
      "equities",
      "quantitative-finance",
      "agentic"
    ],
    "url": "https://api.stocktrends.com/v1/agent/screener/top"
  },
  "x402Version": 2
}

Response headers

{
  "cache-control": "no-store, private",
  "connection": "keep-alive",
  "content-length": "6835",
  "content-type": "application/json",
  "date": "Thu, 13 Aug 2026 00:15:02 GMT",
  "payment-required": "eyJ4NDAyVmVyc2lvbiI6MiwicmVzb3VyY2UiOnsidXJsIjoiaHR0cHM6Ly9hcGkuc3RvY2t0cmVuZHMuY29tL3YxL2FnZW50L3NjcmVlbmVyL3RvcCIsImRlc2NyaXB0aW9uIjoiUmFua2VkIFN0b2NrIFRyZW5kcyBzaWduYWwgc2NyZWVuZXIgZm9yIGFnZW50IHdvcmtmbG93cywgdXNpbmcgdHJlbmQgc3RhdGUsIHRyZW5kIHBlcnNpc3RlbmNlLCB0cmVuZCBtYXR1cml0eSwgcmVsYXRpdmUgcGVyZm9ybWFuY2UsIGFuZCB2b2x1bWUgc2lnbmFsIGZpZWxkcy4iLCJtaW1lVHlwZSI6ImFwcGxpY2F0aW9uL2pzb24iLCJzZXJ2aWNlTmFtZSI6IlN0b2NrIFRyZW5kcyBNYXJrZXQgSW50ZWxsaWdlbmNlIiwidGFncyI6WyJmaW5hbmNlIiwibWFya2V0LWludGVsbGlnZW5jZSIsImVxdWl0aWVzIiwicXVhbnRpdGF0aXZlLWZpbmFuY2UiLCJhZ2VudGljIl0sImljb25VcmwiOiJodHRwczovL2RldmVsb3Blci5zdG9ja3RyZW5kcy5jb20vaW1hZ2VzL3N0bWktaWNvbi5wbmcifSwiYWNjZXB0cyI6W3sic2NoZW1lIjoiZXhhY3QiLCJuZXR3b3JrIjoiZWlwMTU1Ojg0NTMiLCJhbW91bnQiOiI1MDAwMDAiLCJhc3NldCI6IjB4ODMzNTg5ZkNENmVEYjZFMDhmNGM3QzMyRDRmNzFiNTRiZEEwMjkxMyIsInBheVRvIjoiMHhBRWViOEVhQmRDMDU1MzJhMjYxMjMwNDVmOTlEMjA4RUIxY0MwMGFiIiwibWF4VGltZW91dFNlY29uZHMiOjMwMCwiZXh0cmEiOnsibmFtZSI6IlVTRCBDb2luIiwidmVyc2lvbiI6IjIiLCJyZXNvdXJjZSI6eyJ1cmwiOiJodHRwczovL2FwaS5zdG9ja3RyZW5kcy5jb20vdjEvYWdlbnQvc2NyZWVuZXIvdG9wIiwiZGVzY3JpcHRpb24iOiJSYW5rZWQgU3RvY2sgVHJlbmRzIHNpZ25hbCBzY3JlZW5lciBmb3IgYWdlbnQgd29ya2Zsb3dzLCB1c2luZyB0cmVuZCBzdGF0ZSwgdHJlbmQgcGVyc2lzdGVuY2UsIHRyZW5kIG1hdHVyaXR5LCByZWxhdGl2ZSBwZXJmb3JtYW5jZSwgYW5kIHZvbHVtZSBzaWduYWwgZmllbGRzLiIsIm1pbWVUeXBlIjoiYXBwbGljYXRpb24vanNvbiIsInNlcnZpY2VOYW1lIjoiU3RvY2sgVHJlbmRzIE1hcmtldCBJbnRlbGxpZ2VuY2UiLCJ0YWdzIjpbImZpbmFuY2UiLCJtYXJrZXQtaW50ZWxsaWdlbmNlIiwiZXF1aXRpZXMiLCJxdWFudGl0YXRpdmUtZmluYW5jZSIsImFnZW50aWMiXSwiaWNvblVybCI6Imh0dHBzOi8vZGV2ZWxvcGVyLnN0b2NrdHJlbmRzLmNvbS9pbWFnZXMvc3RtaS1pY29uLnBuZyJ9fX1dLCJleHRlbnNpb25zIjp7ImJhemFhciI6eyJpbmZvIjp7InRpdGxlIjoiQWdlbnQgU2NyZWVuZXIgVG9wIiwiZGVzY3JpcHRpb24iOiJSYW5rZWQgU3RvY2sgVHJlbmRzIHNpZ25hbCBzY3JlZW5lciBmb3IgYWdlbnQgd29ya2Zsb3dzLCB1c2luZyB0cmVuZCBzdGF0ZSwgdHJlbmQgcGVyc2lzdGVuY2UsIHRyZW5kIG1hdHVyaXR5LCByZWxhdGl2ZSBwZXJmb3JtYW5jZSwgYW5kIHZvbHVtZSBzaWduYWwgZmllbGRzLiIsImNhdGVnb3J5Ijoic2NyZWVuZXIiLCJmYW1pbHkiOiJzY3JlZW5lciIsInRvb2xzX21hbmlmZXN0IjoiaHR0cHM6Ly9hcGkuc3RvY2t0cmVuZHMuY29tL3YxL2FpL3Rvb2xzIiwibWV0YWRhdGFVcmwiOiJodHRwczovL2FwaS5zdG9ja3RyZW5kcy5jb20vdjEvYWkvY29udGV4dCIsInNjaGVtYVVybCI6Imh0dHBzOi8vYXBpLnN0b2NrdHJlbmRzLmNvbS92MS9haS90b29scyIsInByaWNpbmdfY2F0YWxvZyI6Imh0dHBzOi8vYXBpLnN0b2NrdHJlbmRzLmNvbS92MS9wcmljaW5nL2NhdGFsb2ciLCJpbnB1dCI6eyJ0eXBlIjoiaHR0cCIsIm1ldGhvZCI6IkdFVCIsInF1ZXJ5UGFyYW1zIjp7ImxpbWl0IjoxMCwibWluX3JzaSI6NDB9fSwib3V0cHV0Ijp7InR5cGUiOiJqc29uIiwiZm9ybWF0IjoiYXBwbGljYXRpb24vanNvbiIsImV4YW1wbGUiOnsicmVxdWVzdF9pZCI6InJlcV9kZW1vIn19LCJyb2xlIjoibWFya2V0X2ludGVsbGlnZW5jZV9maWx0ZXIiLCJwcm92ZW5hbmNlX3JlZmVyZW5jZSI6eyJoaXN0b3JpY2FsX2NvdmVyYWdlX3N0YXJ0X3llYXIiOjE5ODAsImFwcHJveGltYXRlX29ic2VydmF0aW9uX2NvdW50IjoiMTZNKyIsImNsYXNzaWZpY2F0aW9uX2ZyYW1ld29yayI6IlN0b2NrIFRyZW5kcyB0cmVuZCBjbGFzc2lmaWNhdGlvbiBtZXRob2RvbG9neSIsInNlbWFudGljX2NvbnRpbnVpdHkiOiJTdG9jayBUcmVuZHMgaW5kaWNhdG9ycyB1c2UgYSBjb25zaXN0ZW50IGNsYXNzaWZpY2F0aW9uIGRvY3RyaW5lIGFjcm9zcyBkZWNhZGVzIG9mIG9ic2VydmF0aW9ucy4iLCJmdWxsX21ldGFkYXRhX2VuZHBvaW50cyI6WyIvdjEvYWkvY29udGV4dCIsIi92MS9tZXRhL2luZGljYXRvcnMiLCIvdjEvbWV0YS9zdGltIl0sImludGVycHJldGF0aW9uX2xpbWl0IjoiSGlzdG9yaWNhbCBkZXB0aCBzdXBwb3J0cyByZXNlYXJjaCBhbmQgcHJvYmFiaWxpc3RpYyBpbnRlcnByZXRhdGlvbiBidXQgZG9lcyBub3QgZ3VhcmFudGVlIGZ1dHVyZSBwZXJmb3JtYW5jZS4ifX0sInNjaGVtYSI6eyIkc2NoZW1hIjoiaHR0cHM6Ly9qc29uLXNjaGVtYS5vcmcvZHJhZnQvMjAyMC0xMi9zY2hlbWEiLCJ0eXBlIjoib2JqZWN0IiwicHJvcGVydGllcyI6eyJpbnB1dCI6eyJ0eXBlIjoib2JqZWN0IiwicHJvcGVydGllcyI6eyJ0eXBlIjp7InR5cGUiOiJzdHJpbmciLCJjb25zdCI6Imh0dHAifSwibWV0aG9kIjp7InR5cGUiOiJzdHJpbmciLCJlbnVtIjpbIkdFVCJdfSwicXVlcnlQYXJhbXMiOnsidHlwZSI6Im9iamVjdCIsInByb3BlcnRpZXMiOnsibGltaXQiOnsidHlwZSI6ImludGVnZXIiLCJtaW5pbXVtIjoxLCJtYXhpbXVtIjoxMDAsImRlZmF1bHQiOjI1fSwibWluX3JzaSI6eyJ0eXBlIjoiaW50ZWdlciIsImRlZmF1bHQiOjQwfSwiZXhjaGFuZ2UiOnsidHlwZSI6InN0cmluZyIsImVudW0iOlsiTiIsIlEiLCJBIiwiQiIsIlQiLCJJIl19fSwicmVxdWlyZWQiOltdLCJhZGRpdGlvbmFsUHJvcGVydGllcyI6ZmFsc2V9fSwicmVxdWlyZWQiOlsidHlwZSIsIm1ldGhvZCJdLCJhZGRpdGlvbmFsUHJvcGVydGllcyI6ZmFsc2V9LCJvdXRwdXQiOnsidHlwZSI6Im9iamVjdCIsImRlc2NyaXB0aW9uIjoiUmFua2VkIGluc3RydW1lbnRzIHdpdGggU3RvY2sgVHJlbmRzIHNpZ25hbCBmaWVsZHMgYW5kIGZpbHRlciBzdW1tYXJ5LiIsInByb3BlcnRpZXMiOnsidHlwZSI6eyJ0eXBlIjoic3RyaW5nIiwiY29uc3QiOiJqc29uIn0sImZvcm1hdCI6eyJ0eXBlIjoic3RyaW5nIn0sImV4YW1wbGUiOnt9fSwicmVxdWlyZWQiOlsidHlwZSJdLCJhZGRpdGlvbmFsUHJvcGVydGllcyI6dHJ1ZX0sInRpdGxlIjp7InR5cGUiOiJzdHJpbmcifSwiZGVzY3JpcHRpb24iOnsidHlwZSI6InN0cmluZyJ9LCJjYXRlZ29yeSI6eyJ0eXBlIjoic3RyaW5nIn0sImZhbWlseSI6eyJ0eXBlIjoic3RyaW5nIn0sInRvb2xzX21hbmlmZXN0Ijp7InR5cGUiOiJzdHJpbmcifSwibWV0YWRhdGFVcmwiOnsidHlwZSI6InN0cmluZyJ9LCJzY2hlbWFVcmwiOnsidHlwZSI6InN0cmluZyJ9LCJwcmljaW5nX2NhdGFsb2ciOnsidHlwZSI6InN0cmluZyJ9fSwicmVxdWlyZWQiOlsiaW5wdXQiXSwiYWRkaXRpb25hbFByb3BlcnRpZXMiOnRydWV9fX19",
  "server": "uvicorn",
  "x-request-id": "a4f4827a-6330-4272-827d-6d682aaffb84",
  "x-stocktrends-accepted-payment-methods": "subscription,x402,mpp",
  "x-stocktrends-payment-required": "true",
  "x-stocktrends-pricing-rule": "agent_screener_top"
}

Response body

{
  "accepted_payment_methods": [
    "subscription",
    "x402",
    "mpp"
  ],
  "detail": "Payment is required to access this endpoint.",
  "error": "payment_required",
  "payment_required": {
    "accepts": [
      {
        "amount": "500000",
        "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "extra": {
          "name": "USD Coin",
          "resource": {
            "description": "Ranked Stock Trends signal screener for agent workflows, using trend state, trend persistence, trend maturity, relative performance, and volume signal fields.",
            "iconUrl": "https://developer.stocktrends.com/images/stmi-icon.png",
            "mimeType": "application/json",
            "serviceName": "Stock Trends Market Intelligence",
            "tags": [
              "finance",
              "market-intelligence",
              "equities",
              "quantitative-finance",
              "agentic"
            ],
            "url": "https://api.stocktrends.com/v1/agent/screener/top"
          },
          "version": "2"
        },
        "maxTimeoutSeconds": 300,
        "network": "eip155:8453",
        "payTo": "0xAEeb8EaBdC05532a26123045f99D208EB1cC00ab",
        "scheme": "exact"
      }
    ],
    "extensions": {
      "bazaar": {
        "info": {
          "category": "screener",
          "description": "Ranked Stock Trends signal screener for agent workflows, using trend state, trend persistence, trend maturity, relative performance, and volume signal fields.",
          "family": "screener",
          "input": {
            "method": "GET",
            "queryParams": {
              "limit": 10,
              "min_rsi": 40
            },
            "type": "http"
          },
          "metadataUrl": "https://api.stocktrends.com/v1/ai/context",
          "output": {
            "example": {
              "request_id": "req_demo"
            },
            "format": "application/json",
            "type": "json"
          },
          "pricing_catalog": "https://api.stocktrends.com/v1/pricing/catalog",
          "provenance_reference": {
            "approximate_observation_count": "16M+",
            "classification_framework": "Stock Trends trend classification methodology",
            "full_metadata_endpoints": [
              "/v1/ai/context",
              "/v1/meta/indicators",
              "/v1/meta/stim"
            ],
            "historical_coverage_start_year": 1980,
            "interpretation_limit": "Historical depth supports research and probabilistic interpretation but does not guarantee future performance.",
            "semantic_continuity": "Stock Trends indicators use a consistent classification doctrine across decades of observations."
          },
          "role": "market_intelligence_filter",
          "schemaUrl": "https://api.stocktrends.com/v1/ai/tools",
          "title": "Agent Screener Top",
          "tools_manifest": "https://api.stocktrends.com/v1/ai/tools"
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "additionalProperties": true,
          "properties": {
            "category": {
              "type": "string"
            },
            "description": {
              "type": "string"
            },
            "family": {
              "type": "string"
            },
            "input": {
              "additionalProperties": false,
              "properties": {
                "method": {
                  "enum": [
                    "GET"
                  ],
                  "type": "string"
                },
                "queryParams": {
                  "additionalProperties": false,
                  "properties": {
                    "exchange": {
                      "enum": [
                        "N",
                        "Q",
                        "A",
                        "B",
                        "T",
                        "I"
                      ],
                      "type": "string"
                    },
                    "limit": {
                      "default": 25,
                      "maximum": 100,
                      "minimum": 1,
                      "type": "integer"
                    },
                    "min_rsi": {
                      "default": 40,
                      "type": "integer"
                    }
                  },
                  "required": [],
                  "type": "object"
                },
                "type": {
                  "const": "http",
                  "type": "string"
                }
              },
              "required": [
                "type",
                "method"
              ],
              "type": "object"
            },
            "metadataUrl": {
              "type": "string"
            },
            "output": {
              "additionalProperties": true,
              "description": "Ranked instruments with Stock Trends signal fields and filter summary.",
              "properties": {
                "example": {},
                "format": {
                  "type": "string"
                },
                "type": {
                  "const": "json",
                  "type": "string"
                }
              },
              "required": [
                "type"
              ],
              "type": "object"
            },
            "pricing_catalog": {
              "type": "string"
            },
            "schemaUrl": {
              "type": "string"
            },
            "title": {
              "type": "string"
            },
            "tools_manifest": {
              "type": "string"
            }
          },
          "required": [
            "input"
          ],
          "type": "object"
        }
      }
    },
    "resource": {
      "description": "Ranked Stock Trends signal screener for agent workflows, using trend state, trend persistence, trend maturity, relative performance, and volume signal fields.",
      "iconUrl": "https://developer.stocktrends.com/images/stmi-icon.png",
      "mimeType": "application/json",
      "serviceName": "Stock Trends Market Intelligence",
      "tags": [
        "finance",
        "market-intelligence",
        "equities",
        "quantitative-finance",
        "agentic"
      ],
      "url": "https://api.stocktrends.com/v1/agent/screener/top"
    },
    "x402Version": 2
  },
  "pricing": {
    "amount_usd": "0.500000",
    "network": "eip155:8453",
    "scheme": "exact",
    "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "unit": "request"
  },
  "protocol": "x402",
  "resource": "https://api.stocktrends.com/v1/agent/screener/top",
  "stocktrends_preview": {
    "analytical_role": "market_intelligence_filter",
    "endpoint": {
      "access_type": "paid",
      "category": "screener",
      "method": "GET",
      "path": "/v1/agent/screener/top",
      "purpose": "Find a ranked candidate set from the latest Stock Trends signal data.",
      "requires_payment": true,
      "workflow_role": "Candidate discovery and ranking."
    },
    "example_object": {
      "count": 1,
      "request_id": "req_demo",
      "results": [
        {
          "mt_cnt": 12,
          "rank": 1,
          "rsi": 118,
          "rsi_updn": "+",
          "symbol_exchange": "SAMPLE-N",
          "trend": "^+",
          "trend_cnt": 8,
          "vol_tag": "*"
        }
      ],
      "weekdate": "YYYY-MM-DD"
    },
    "input_location": "query",
    "input_rule": null,
    "investment_agent_value": "Gives agents a compact first paid call for discovering securities with directional Stock Trends signal context before deeper symbol, ST-IM, or portfolio analysis.",
    "next_recommended_calls": [
      "/v1/decision/evaluate-symbol",
      "/v1/portfolio/construct"
    ],
    "notes": [
      "RSI is relative performance versus benchmark with baseline 100.",
      "Use the free /v1/ai/proof/market-edge endpoint for a synthetic signal structure example."
    ],
    "optional_inputs": {
      "exchange": {
        "enum": [
          "N",
          "Q",
          "A",
          "B",
          "T",
          "I"
        ],
        "input_location": "query",
        "parameter_source": "query",
        "required": false,
        "type": "string"
      },
      "limit": {
        "input_location": "query",
        "maximum": 100,
        "minimum": 1,
        "parameter_source": "query",
        "required": false,
        "safe_default": 25,
        "type": "integer"
      },
      "min_rsi": {
        "description": "Minimum Stock Trends RSI threshold. RSI baseline is 100.",
        "example": 40,
        "input_location": "query",
        "parameter_source": "query",
        "required": false,
        "safe_default": 40,
        "type": "integer"
      }
    },
    "output_summary": "Ranked instruments with Stock Trends signal fields and filter summary.",
    "parameter_source": "query",
    "pricing": {
      "cost_source": "/v1/pricing/catalog",
      "effective_price_usd": "0.500000",
      "pricing_rule_id": "agent_screener_top",
      "stc_cost": "0.500000",
      "unit": "request"
    },
    "provenance_reference": {
      "approximate_observation_count": "16M+",
      "classification_framework": "Stock Trends trend classification methodology",
      "full_metadata_endpoints": [
        "/v1/ai/context",
        "/v1/meta/indicators",
        "/v1/meta/stim"
      ],
      "historical_coverage_start_year": 1980,
      "interpretation_limit": "Historical depth supports research and probabilistic interpretation but does not guarantee future performance.",
      "semantic_continuity": "Stock Trends indicators use a consistent classification doctrine across decades of observations."
    },
    "related_endpoints": [
      "/v1/decision/evaluate-symbol",
      "/v1/portfolio/construct",
      "/v1/stim/latest"
    ],
    "required_inputs": {},
    "response_shape": [
      "request_id",
      "screener",
      "weekdate",
      "filter_summary",
      "count",
      "total_matched",
      "results[].rank",
      "results[].symbol",
      "results[].exchange",
      "results[].symbol_exchange",
      "results[].trend",
      "results[].trend_cnt",
      "results[].mt_cnt",
      "results[].rsi",
      "results[].rsi_updn",
      "results[].vol_tag",
      "results[].weekdate"
    ],
    "safe_example_request": {
      "method": "GET",
      "path": "/v1/agent/screener/top",
      "query": {
        "limit": 10,
        "min_rsi": 40
      }
    },
    "supported_rails": [
      "subscription",
      "x402",
      "mpp"
    ]
  }
}

Request headers

{
  "accept": "*/*",
  "user-agent": "Fetch402Bot/0.1 (+https://fetch402.com/crawler; contact: crawler@fetch402.com)"
}

Machine contract

Schemas.

InputJSON
{}
OutputJSON
{}