{"uid":"cap_GalbDempAo_80f13ZgPYu","slug":"mangrove-developer-signals-behavior-lookup-1eea97c6","name":"Mangrove Developer – Signals Behavior Lookup","description":"Developer references for Mangrove Agent, API contracts, MCP and AI integrations.","url":"https://api.mangrovedeveloper.ai/api/v1/signals/behavior?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","default":10,"description":"Maximum results, 1-100"},"lookup":{"enum":["describe","pick","find","gap_probability"],"type":"string","example":"describe","description":"describe: one signal -- parameter meanings, measured span, what its default measures. pick: settings of one signal that hit target_rate. find: which signals reach a rate band. gap_probability: share of a signal's gaps inside a range of bar lengths, per configuration."},"signal":{"type":"string","description":"Signal name, e.g. rsi_oversold. Required by describe, pick, gap_probability"},"category":{"type":"string","description":"find: restrict to one family, e.g. oscillator, volatility, momentum"},"max_rate":{"type":"number","description":"find: high end of the band, same units (required)"},"min_rate":{"type":"number","description":"find: low end of the band, same units (required)"},"signal_type":{"enum":["FILTER","TRIGGER"],"type":"string","default":"FILTER","example":"FILTER","description":"FILTER (an ongoing state) or TRIGGER (a one-bar event); measured separately"},"target_rate":{"type":"number","description":"pick: rate to aim for -- FILTER selectivity 0-1, TRIGGER firings per 1,000 bars. Omit to list the span"},"max_gap_bars":{"type":"number","description":"pick/find, TRIGGER only: median gap at most this many bars"},"max_run_bars":{"type":"number","description":"pick/find, FILTER only: mean run at most this many bars"},"min_gap_bars":{"type":"number","description":"pick/find, TRIGGER only: median gap at least this many bars"},"min_run_bars":{"type":"number","description":"pick/find, FILTER only: mean run at least this many bars"},"max_gap_range_bars":{"type":"number","description":"gap_probability: high end of the gap range, inclusive (required)"},"min_gap_range_bars":{"type":"number","description":"gap_probability: low end of the gap range, inclusive (required)"}}},"responseSchema":{"type":"json","example":{"lookup":"describe","result":{"signal":"rsi_oversold","category":"oscillator","measured":true,"parameters":{"window":{"max":100,"min":2,"type":"int","means":"RSI calculation window","default":14},"threshold":{"max":50,"min":0,"type":"float","means":"Oversold threshold","default":30}},"description":"Check if RSI is below the oversold threshold. RSI values bel...","signal_type":"FILTER","configurations":151,"measured_over_bars":339669}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VJrVzMpjrnLtJpHHyU4pw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Queries metadata, parameter settings, and statistical behavior of named trading signals (RSI, volatility, momentum, etc.) across describe, pick, find, and gap_probability operations.","exampleAgentPrompt":"Describe the rsi_oversold signal for me — what does it measure, what are its parameters, and how many configurations have been tested?","exampleUseCases":[{"title":"Parameter discovery for a named signal","prompt":"Tell me everything about the macd_cross trigger signal — its parameters, what each one means, and how many bar configurations it's been measured over."},{"title":"Finding signals in a target firing rate band","prompt":"Find me all momentum trigger signals that fire between 5 and 15 times per 1000 bars, with a median gap of at least 10 bars."},{"title":"Tuning a signal to hit a selectivity target","prompt":"What parameter settings for rsi_oversold as a FILTER signal get me closest to a selectivity rate of 0.15, with a mean run length no longer than 30 bars?"}],"resultDescription":"A JSON object containing the signal's category, type (FILTER or TRIGGER), description, parameter definitions with min/max/default/meaning, number of configurations tested, and total bars measured — or, for pick/find/gap_probability lookups, ranked configurations, matching signals, or gap probability distributions respectively.","failureModes":["Signal name not found — returns empty result or error if the signal field is misspelled or unsupported","Missing required fields for a lookup type — e.g. omitting min_rate/max_rate for a 'find' lookup returns a validation error","Out-of-range limit value (outside 1–100) causes a parameter validation failure","Conflicting constraints (e.g. min_run_bars > max_run_bars) may return empty results","Payment not included or insufficient USDC — x402 payment required error returned before processing"],"whenToPreferThis":"Use this endpoint when you need programmatic, structured metadata about specific named trading signals — their statistical properties, parameter ranges, and measured behavior — rather than generating signals or running backtests. Ideal for agents that need to select, tune, or explain trading signals dynamically based on quantitative criteria.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-04T06:33:43.636Z","isFirstParty":false,"canonicalSlug":"mangrove-developer-signals-behavior-lookup-1eea97c6"}