{"openapi":"3.1.0","info":{"title":"BeforeApe Risk Data API","version":"1.1.0","description":"Risk signals with evidence for Robinhood Chain launchpad graduations. Two paid endpoints. Not investment advice; not a determination of fraud. Payments use the x402 v2 `exact` scheme (EIP-3009); the server never holds keys or signs anything.","contact":{"name":"BeforeApe","url":"https://beforeape.com"},"x-guidance":"Two paid GET endpoints return risk signals with evidence for Robinhood Chain launchpad tokens. GET /x402/v1/graduations (optional launchpad, since, limit) lists recent graduations; GET /x402/v1/token-dd?ca=<token address> returns the due-diligence report for one token. Request without a payment header to receive the HTTP 402 challenge (x402 v2, exact scheme, USDG on Robinhood Chain or USDC on Base); add ?preview=1 for a free, smaller sample. Not investment advice; signals only, not a determination of fraud."},"servers":[{"url":"https://api.beforeape.com"}],"components":{"schemas":{"graduations":{"type":"array","description":"Recent graduations. preview tier: ca, symbol, graduated_at, risk_level only (latest 10). full tier: up to 200 with flag summary and latest market snapshot.","items":{"type":"object","required":["ca","symbol","graduated_at","risk_level"],"properties":{"ca":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"symbol":{"type":"string"},"name":{"type":"string"},"launchpad":{"enum":["pons","standard"]},"graduated_at":{"type":["string","null"],"format":"date-time"},"graduated_tx":{"type":["string","null"]},"pool_id":{"type":["string","null"]},"risk_level":{"enum":["낮음","중간","고위험","매우 고위험","미평가"]},"flags":{"type":"object","properties":{"count":{"type":"integer"},"max_weight":{"type":"integer"},"top":{"type":"array","items":{"type":"string"}},"no_kyc_funding":{"type":"boolean"}}},"market":{"type":"object","properties":{"snapshot_at":{"type":["string","null"],"format":"date-time"},"price_usd":{"type":["string","null"]},"mcap_usd":{"type":["string","null"]},"liquidity_usd":{"type":["string","null"]},"holders":{"type":["integer","null"]},"top10_pct":{"type":["string","null"]}}}}}},"token_dd":{"type":"object","description":"DD report. preview tier: ca, symbol, risk_level, red_flag_count, verdict_text. full tier: all fields below.","properties":{"ca":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"symbol":{"type":"string"},"risk_level":{"enum":["낮음","중간","고위험","매우 고위험","미평가"]},"red_flag_count":{"type":"integer"},"verdict_text":{"type":["string","null"]},"token":{"type":"object"},"dd":{"type":["object","null"],"description":"risk_level, verdict_text, summary, version, updated_at"},"red_flags":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"title":{"type":"string"},"weight":{"type":"integer","minimum":1,"maximum":10},"detail":{"type":"string"},"evidence":{}}}},"deployer_funding":{"type":"array","description":"funding source path of the deployer wallet"},"flip_conditions":{"type":"array","description":"conditions that would raise (up) or lower (down) the verdict","items":{"type":"object","properties":{"direction":{"enum":["up","down"]},"condition":{"type":"string"}}}},"evidence_links":{"type":"array","description":"evidence transactions / explorer links"},"history":{"type":"array","description":"verdict history"}}},"PaymentRequired":{"type":"object","properties":{"x402Version":{"const":2},"error":{"type":"string"},"resource":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"description":{"type":"string"},"mimeType":{"type":"string"},"serviceName":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}}}},"preview":{},"extensions":{"type":"object"},"accepts":{"type":"array","items":{"type":"object","description":"One entry per enabled network. The entry also names the receive address; copy it into your payment payload unchanged.","required":["scheme","network","amount","asset","maxTimeoutSeconds"],"properties":{"scheme":{"const":"exact"},"network":{"type":"string","examples":["eip155:4663","eip155:8453"]},"amount":{"type":"string","description":"atomic units (6 decimals); must match exactly"},"asset":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"maxTimeoutSeconds":{"type":"integer"},"extra":{"type":"object","description":"EIP-712 domain name/version of the asset"}},"additionalProperties":true}}}}}},"paths":{"/x402/v1/graduations":{"get":{"operationId":"graduations","summary":"Recent graduations with risk summary","description":"Recent token graduations on Robinhood Chain launchpads (Pons v2 and Standard), each with a risk level, a red-flag summary and the latest market snapshot. Risk signals, not investment advice.","tags":["Risk data"],"parameters":[{"name":"launchpad","in":"query","required":false,"schema":{"type":"string","enum":["pons","standard"]},"description":"Only graduations from this launchpad"},{"name":"since","in":"query","required":false,"schema":{"type":"string","format":"date-time"},"description":"Only graduations at or after this ISO 8601 time"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":200},"description":"Number of rows, 1-200 (default 50)"},{"name":"preview","in":"query","required":false,"schema":{"enum":["1"]},"description":"Free preview tier (smaller sample, no payment header needed)"}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"x-x402":{"version":2,"scheme":"exact","networks":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","eip712":{"name":"Global Dollar","version":"1"}},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","eip712":{"name":"USD Coin","version":"2"}}]},"responses":{"200":{"description":"OK (preview or paid). Paid responses carry a PAYMENT-RESPONSE header (base64 JSON: success, transaction, network, payer). Payment is settled before the data is returned.","content":{"application/json":{"schema":{"type":"object","required":["data","tier","generated_at","disclaimer","schema"],"properties":{"data":{"$ref":"#/components/schemas/graduations"},"tier":{"enum":["preview","full"]},"generated_at":{"type":"string","format":"date-time"},"disclaimer":{"type":"string"},"schema":{"type":"string","format":"uri"}}}}}},"400":{"description":"Invalid query parameter (a payment is never settled for it)"},"402":{"description":"Payment Required. The PAYMENT-REQUIRED header (base64 JSON) and the body list `accepts` for each enabled network.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"description":"Unknown token / no DD report yet (a payment is never settled for it)"},"429":{"description":"Rate limited (30 req/min and 1000/day per IP without payment; 120 req/min per payer)"}}}},"/x402/v1/token-dd":{"get":{"operationId":"token_dd","summary":"Due-diligence report for one token","description":"Due-diligence report for one Robinhood Chain token, selected with the ca query parameter: red flags with evidence, deployer funding source, conditions that would change the verdict, evidence links and verdict history. Risk signals, not investment advice.","tags":["Risk data"],"parameters":[{"name":"ca","in":"query","required":true,"schema":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"description":"Token contract address on Robinhood Chain"},{"name":"preview","in":"query","required":false,"schema":{"enum":["1"]},"description":"Free preview tier (smaller sample, no payment header needed)"}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]},"x-x402":{"version":2,"scheme":"exact","networks":[{"network":"eip155:4663","asset":"0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168","eip712":{"name":"Global Dollar","version":"1"}},{"network":"eip155:8453","asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","eip712":{"name":"USD Coin","version":"2"}}]},"responses":{"200":{"description":"OK (preview or paid). Paid responses carry a PAYMENT-RESPONSE header (base64 JSON: success, transaction, network, payer). Payment is settled before the data is returned.","content":{"application/json":{"schema":{"type":"object","required":["data","tier","generated_at","disclaimer","schema"],"properties":{"data":{"$ref":"#/components/schemas/token_dd"},"tier":{"enum":["preview","full"]},"generated_at":{"type":"string","format":"date-time"},"disclaimer":{"type":"string"},"schema":{"type":"string","format":"uri"}}}}}},"400":{"description":"Invalid query parameter (a payment is never settled for it)"},"402":{"description":"Payment Required. The PAYMENT-REQUIRED header (base64 JSON) and the body list `accepts` for each enabled network.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PaymentRequired"}}}},"404":{"description":"Unknown token / no DD report yet (a payment is never settled for it)"},"429":{"description":"Rate limited (30 req/min and 1000/day per IP without payment; 120 req/min per payer)"}}}},"/api/healthz":{"get":{"operationId":"health","summary":"Health check","security":[],"tags":["Status"],"responses":{"200":{"description":"OK"}}}}}}