{"slug":"api-mekler-ai-v1-services-listings-list-grade-changes-ee8524","title":"Read ordered new, grade_changed and rescanned events with previous grades and sc","host":"api.mekler.ai","method":"POST","resource":"https://api.mekler.ai/v1/services/listings/list-grade-changes","category":"market","description":"Read ordered new, grade_changed and rescanned events with previous grades and scores. Default 200, maximum 1000; signed watermark cursors. History retains 30 days or 50000 events; expired cursors return 410. Costs 0.01 USDC per page on Base or Solana. Use a fresh idempotency key per page; retain the","price_listed":0.01,"price_asked":0.01,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":753,"reported_calls_30d":2,"reported_payers_30d":2,"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"idempotency_key":"example-grade-request-0001","limit":200},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":false,"properties":{"cursor":{"maxLength":2048,"type":"string"},"idempotency_key":{"maxLength":128,"minLength":22,"pattern":"^[A-Za-z0-9_-]{22,128}$","type":"string"},"limit":{"default":200,"maximum":1000,"minimum":1,"type":"integer"}},"required":["idempotency_key"],"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"additionalProperties":false,"properties":{"event_cap":{"const":50000},"events":{"items":{"additionalProperties":false,"properties":{"at":{"type":"integer"},"grade":{"enum":["A","B","C","D","F",null],"type":["string","null"]},"listing_id":{"pattern":"^[a-f0-9]{64}$","type":"string"},"previous_grade":{"enum":["A","B","C","D","F",null],"type":["string","null"]},"previous_score":{"maximum":100,"minimum":0,"type":["number","null"]},"published_at":{"type":"integer"},"report_id":{"pattern":"^[a-f0-9]{64}$","type":"string"},"scan_observed_at":{"type":"integer"},"score":{"maximum":100,"minimum":0,"type":["number","null"]},"sequence":{"minimum":1,"type":"integer"},"type":{"enum":["new","grade_changed","rescanned"]}},"required":["sequence","type","listing_id","at","published_at","scan_observed_at","report_id","grade","score","previous_grade","previous_score"],"type":"object"},"maxItems":1000,"type":"array"},"has_more":{"type":"boolean"},"history_floor":{"type":"integer"},"next_cursor":{"type":"string"},"retention_days":{"const":30},"status":{"const":"ok"},"watermark":{"type":"integer"}},"required":["status","events","has_more","next_cursor","watermark","retention_days","event_cap","history_floor"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-20","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.01,"price_match":true,"latency_ms":753,"error":null}],"description_full":"Read ordered new, grade_changed and rescanned events with previous grades and scores. Default 200, maximum 1000; signed watermark cursors. History retains 30 days or 50000 events; expired cursors return 410. Costs 0.01 USDC per page on Base or Solana. Use a fresh idempotency key per page; retain the original body and proof for exact recovery.","last_updated":"2026-10-19T18:21:44.497Z","schemes":["exact"]}