{ "service_detail_version": "agent_router_service_detail_v1", "data_context": { "page_role": "service_capability_detail", "result_preview_role": "latest_validation_sample", "result_preview_is_live_user_query": false, "explanation": "latest_validation.result_preview is the last provider validation sample. It proves this service can return real JSON for its sample request, but it is not the result of the current buyer Agent task.", "live_query_instruction": "Buyer Agents should invoke this service with task-specific input through AgentRouter instead of reusing the validation sample as the final answer." }, "service": { "service_id": "nansen_perp_leaderboard", "manifest_type": "hosted_http_data_api", "version": "1.0.0", "manifest_hash": "0xac80c792b034a908300ffedbab3f50bf18e13fc6d62ab1de993ffa0f50345381", "config_hash": "0x6f7c61e5ea09e93ce2492ba2173a55398fd44afef9d2f7085d96e0e16e543d1e", "title": "Get Perpetual Trading Leaderboard Data", "display_title": "Get Perpetual Trading Leaderboard Data", "description_for_agent": "Use this Nansen API service when a buyer Agent needs Get Perpetual Trading Leaderboard Data. Endpoint: POST /api/v1/perp-leaderboard.", "capabilities": [ "nansen", "data_service", "perpetuals", "derivatives", "perp_trading", "leaderboard", "trader_ranking" ], "routing": { "routing_version": "agentrouter_structured_routing_v1", "domains": [ "crypto", "market_data", "onchain" ], "data_types": [ "nansen", "perpetuals", "derivatives", "perp_trading", "leaderboard", "trader_ranking" ], "entities": [ "wallet_address", "time_window" ], "chains": [], "time_requirements": { "supports_realtime": false, "supports_historical": true, "accepted_time_fields": [ "date" ] }, "input_fields": [ "date", "pagination" ], "output_fields": [ "data", "data.roi", "data.total_pnl", "data.account_value", "data.trader_address", "data.trader_address_label", "pagination", "pagination.page", "pagination.per_page", "pagination.is_last_page" ], "keywords": [ "perpetual", "trading", "leaderboard", "nansen", "when", "buyer", "agent", "needs", "endpoint", "perp-leaderboard", "data_service", "perpetuals", "derivatives", "perp_trading", "trader_ranking" ], "capability_refs": [ "nansen", "data_service", "perpetuals", "derivatives", "perp_trading", "leaderboard", "trader_ranking" ] }, "pricing": { "amount": "0.01", "pay_to": "0x2c4d600a04c0d3bbb1e3cc8a13e54e21c2b6c0bb", "network": "base", "currency": "USDC", "protocol": "x402", "settlement_model": "direct_provider_wallet" }, "verification_status": "verified", "trust": { "provider_id": "provider_nansen_api", "feedback_count": 0, "operational_feedback_count": 0, "consumer_feedback_count": 0, "recent_failure_rate": null, "success_rate": null, "schema_valid_rate": null, "freshness_valid_rate": null, "coverage_valid_rate": null, "intent_fit_rate": null, "intent_mismatch_count": 0, "intent_mismatch_rate": null, "usefulness_rate": null, "average_consumer_score": null, "average_agent_friendly_score": null, "average_latency_ms": null, "verification_status": "verified", "feedback_state": "no_feedback_yet", "trust_score": 0.7, "trust_score_prior": 0.7, "trust_score_confidence": 0, "routing_trust_score": 0.7 }, "sample_request": { "date": { "to": "2026-05-24", "from": "2026-05-20" }, "pagination": { "page": 1, "per_page": 3 } }, "request_data": { "fields": [ "date", "pagination" ], "example": { "date": { "to": "2026-05-24", "from": "2026-05-20" }, "pagination": { "page": 1, "per_page": 3 } }, "purpose": "Use this example before payment to decide whether the service accepts the fields needed for the task.", "shape_summary": "object keys: date, pagination" }, "response_data": { "fields": [ "data", "data.trader_address", "data.trader_address_label", "data.total_pnl", "data.roi", "data.account_value", "pagination", "pagination.page", "pagination.per_page", "pagination.is_last_page" ], "preview": { "data": [ { "roi": "example", "total_pnl": "example", "account_value": "example", "trader_address": "0x0000000000000000000000000000000000000000", "trader_address_label": "0x0000000000000000000000000000000000000000" } ], "pagination": { "page": 1, "per_page": 10, "is_last_page": true } }, "purpose": "Use this preview before payment to decide whether the service can return data useful for the task. It is a sample/preview, not a guaranteed paid result.", "shape_summary": "object keys: data, pagination" }, "pre_call_context": { "context_version": "agent_pre_call_context_v1", "decision_summary": "Use nansen_perp_leaderboard when the task fits: nansen, perpetuals, derivatives, perp_trading, leaderboard, trader_ranking. Costs 0.01 USDC via x402 on base. Service is currently healthy.", "buyer_requirements": { "payment_required": true, "payment_protocol": "x402", "currency": "USDC", "network": "base", "needs_buyer_api_key": false, "max_budget_field": "max_amount" }, "provider_requirements": { "provider_credential_required": true, "credential_public": false, "credential_custody": "hosted_runtime_config" }, "pricing": { "amount": "0.01", "pay_to": "0x2c4d600a04c0d3bbb1e3cc8a13e54e21c2b6c0bb", "network": "base", "currency": "USDC", "protocol": "x402", "settlement_model": "direct_provider_wallet" }, "freshness": { "update_frequency": "on_request", "max_data_lag_seconds": 300, "declared_live_on_request": true }, "provenance": { "provenance_version": "agent_data_source_provenance_v1", "source_provenance_level": "wrapped_api", "source_type": "provider_declared_data_service", "authorization_status": "provider_declared", "redistribution_status": "provider_declared", "credential_custody": "hosted_runtime_config", "platform_stores_credentials": true, "verified_by_platform": false }, "verification": { "status": "verified", "last_validation_ok": true, "last_validation_at": "2026-09-08T08:21:24.267Z", "latest_http_status": null }, "trust": { "provider_id": "provider_nansen_api", "feedback_count": 0, "operational_feedback_count": 0, "consumer_feedback_count": 0, "recent_failure_rate": null, "success_rate": null, "schema_valid_rate": null, "freshness_valid_rate": null, "coverage_valid_rate": null, "intent_fit_rate": null, "intent_mismatch_count": 0, "intent_mismatch_rate": null, "usefulness_rate": null, "average_consumer_score": null, "average_agent_friendly_score": null, "average_latency_ms": null, "verification_status": "verified", "feedback_state": "no_feedback_yet", "trust_score": 0.7, "trust_score_prior": 0.7, "trust_score_confidence": 0, "routing_trust_score": 0.7 }, "health": { "health_version": "agent_service_health_v1", "status": "healthy", "last_validation_at": "2026-09-08T08:21:24.267Z", "last_validation_ok": true, "last_success_at": null, "last_failure_at": null, "latest_http_status": null, "recent_failure_rate": null, "circuit_breaker": { "active": false, "reason": null, "recent_window": 0, "recent_failures": 0 } }, "request_data": { "fields": [ "date", "pagination" ], "example": { "date": { "to": "2026-05-24", "from": "2026-05-20" }, "pagination": { "page": 1, "per_page": 3 } }, "purpose": "Use this example before payment to decide whether the service accepts the fields needed for the task.", "shape_summary": "object keys: date, pagination" }, "response_data": { "fields": [ "data", "data.trader_address", "data.trader_address_label", "data.total_pnl", "data.roi", "data.account_value", "pagination", "pagination.page", "pagination.per_page", "pagination.is_last_page" ], "preview": { "data": [ { "roi": "example", "total_pnl": "example", "account_value": "example", "trader_address": "0x0000000000000000000000000000000000000000", "trader_address_label": "0x0000000000000000000000000000000000000000" } ], "pagination": { "page": 1, "per_page": 10, "is_last_page": true } }, "purpose": "Use this preview before payment to decide whether the service can return data useful for the task. It is a sample/preview, not a guaranteed paid result.", "shape_summary": "object keys: data, pagination" }, "limitations": [ "Sample response is mock/static and not a live paid response." ], "risk_flags": [ "has_declared_limitations" ] }, "sample_response": { "schema_version": "agent_data_envelope_v1", "status": "success", "sample_type": "mock", "query_shape": { "date": { "to": "", "from": "" }, "pagination": { "page": "", "per_page": "" } }, "data_shape": { "data": { "type": "array", "item_count_sample": 1, "item_shape": { "roi": "", "total_pnl": "", "account_value": "", "trader_address": "", "trader_address_label": "" } }, "pagination": { "page": "", "per_page": "", "is_last_page": "" } }, "metadata": { "data_sources": [ "provider_config_hosted_http" ], "freshness_seconds": 86400, "is_estimated": true, "confidence": 0.7, "limitations": [ "Sample response is mock/static and not a live paid response." ] }, "agent_hints": { "good_for": [ "MVP validation", "Agent response parsing" ], "warnings": [ "Use paid invocation for the full response." ], "suggested_followups": [] }, "summary": "Use this Nansen API service when a buyer Agent needs Get Perpetual Trading Leaderboard Data. Endpoint: POST /api/v1/perp-leaderboard. (sample response)", "redaction": { "redacted": true, "reason": "Public discovery responses expose schema and shape only. Real values require paid invocation." } }, "validation_result_preview": null, "source_provenance": { "provenance_version": "agent_data_source_provenance_v1", "source_provenance_level": "wrapped_api", "source_type": "provider_declared_data_service", "authorization_status": "provider_declared", "redistribution_status": "provider_declared", "credential_custody": "hosted_runtime_config", "platform_stores_credentials": true, "verified_by_platform": false }, "quality_profile": { "profile_version": "agent_data_quality_profile_v1", "verification_status": "verified", "latest_validation_ok": true, "latest_validation_error": null, "feedback_count": 0, "quality_event_count": 0, "upstream_error_count": 0, "business_error_count": 0, "latest_verification": null, "latest_quality_event": null, "declared_freshness_seconds": 300, "result_contract": { "envelope_required": true, "deterministic_checks": [ "http_status", "schema", "envelope", "freshness", "coverage", "empty_result" ], "semantic_checks": [ "agent_friendliness", "intent_fit_summary" ] } }, "health": { "health_version": "agent_service_health_v1", "status": "healthy", "last_validation_at": "2026-09-08T08:21:24.267Z", "last_validation_ok": true, "last_success_at": null, "last_failure_at": null, "latest_http_status": null, "recent_failure_rate": null, "circuit_breaker": { "active": false, "reason": null, "recent_window": 0, "recent_failures": 0 } }, "erc8004": { "agent_id": "340924", "chain": "bsc", "chain_id": 56, "registry": "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432", "explorer_url": "https://8004scan.io/agents/56/340924" }, "erc8004_status": { "state": "registered", "active_chain": "bsc", "registered_chain": "bsc", "agent_id": "340924" }, "badges": [ { "code": "verified_live_endpoint", "label": "Verified live endpoint", "level": "positive" }, { "code": "healthy", "label": "Healthy", "level": "positive" }, { "code": "fresh_data", "label": "Fresh data", "level": "positive" }, { "code": "source_declared", "label": "Source declared", "level": "neutral" } ], "created_at": "2026-09-08T08:21:24.266Z", "updated_at": "2026-09-08T17:05:30.097Z" }, "manifest": { "title": "Get Perpetual Trading Leaderboard Data", "not_for": [], "pricing": { "amount": "0.01", "pay_to": "0x2c4d600a04c0d3bbb1e3cc8a13e54e21c2b6c0bb", "network": "base", "currency": "USDC", "protocol": "x402", "settlement_model": "direct_provider_wallet" }, "endpoint": { "url": "https://agentrouter.network/provider/custom/nansen_perp_leaderboard", "method": "POST" }, "provider": { "provider_id": "provider_nansen_api", "agent_identity": { "agent_id": "optional", "standard": "erc-8004-compatible", "agent_uri": "optional", "agent_registry": "optional" }, "payout_address": "0x2c4d600a04c0d3bbb1e3cc8a13e54e21c2b6c0bb", "erc8004_agent_id": "340924" }, "freshness": { "update_frequency": "on_request", "max_data_lag_seconds": 300 }, "service_id": "nansen_perp_leaderboard", "capabilities": [ "nansen", "data_service", "perpetuals", "derivatives", "perp_trading", "leaderboard", "trader_ranking" ], "input_schema": { "type": "object", "properties": { "date": { "type": "object", "properties": { "to": { "type": "string" }, "from": { "type": "string" } } }, "pagination": { "type": "object", "properties": { "page": { "type": "number" }, "per_page": { "type": "number" } } } } }, "registration": { "duplicate_policy": "same_provider_source_is_idempotent", "source_fingerprint": "sha256:73ca8a973b72c1eb1484551855e421d0258c5368721d827ec344483a52aa5790", "manifest_hash": "0xac80c792b034a908300ffedbab3f50bf18e13fc6d62ab1de993ffa0f50345381", "config_hash": "0x6f7c61e5ea09e93ce2492ba2173a55398fd44afef9d2f7085d96e0e16e543d1e", "version": "1.0.0", "manifest_type": "hosted_http_data_api", "erc8004": { "standard": "ERC-8004", "network": "bsc", "caip2": "eip155:56", "chain_id": 56, "agent_id": "340924", "metadata_uri": "https://agentrouter.network/.well-known/erc8004/vendors/provider_nansen_api.json", "metadata_hash": null, "identity_registry": "0x8004A169FB4a3325136EB29fA0ceB6D2e539a432", "reputation_registry": "0x8004BAa17C55a88189AE136b182e5fdA19dE9b63", "validation_registry": "0x8004Cb1BF31DAf7788923b405b754f57acEB4272", "tx_hash": "0xce780499022ade2028085acc000218a8e5d1cebddf4df912bd9dd779135fc365", "status": "registered", "updated_at": "2026-09-08T17:05:30.097Z" } }, "output_schema": { "type": "object", "required": [ "schema_version", "service_id", "request_id", "status", "query", "data", "metadata" ], "properties": { "data": { "type": "object" }, "query": { "type": "object" }, "status": { "type": "string" }, "metadata": { "type": "object" }, "request_id": { "type": "string" }, "service_id": { "type": "string" }, "schema_version": { "type": "string" } } }, "agent_contract": { "summary": "Use this Nansen API service when a buyer Agent needs Get Perpetual Trading Leaderboard Data. Endpoint: POST /api/v1/perp-leaderboard.", "request_data": { "fields": [ "date", "pagination" ], "example": { "date": { "to": "2026-05-24", "from": "2026-05-20" }, "pagination": { "page": 1, "per_page": 3 } }, "purpose": "Use this example before payment to decide whether the service accepts the fields needed for the task.", "shape_summary": "object keys: date, pagination" }, "response_data": { "fields": [ "data", "data.trader_address", "data.trader_address_label", "data.total_pnl", "data.roi", "data.account_value", "pagination", "pagination.page", "pagination.per_page", "pagination.is_last_page" ], "preview": { "data": [ { "roi": "example", "total_pnl": "example", "account_value": "example", "trader_address": "0x0000000000000000000000000000000000000000", "trader_address_label": "0x0000000000000000000000000000000000000000" } ], "pagination": { "page": 1, "per_page": 10, "is_last_page": true } }, "purpose": "Use this preview before payment to decide whether the service can return data useful for the task. It is a sample/preview, not a guaranteed paid result.", "shape_summary": "object keys: data, pagination" }, "routing_hints": { "not_for": [], "good_for": [ "nansen", "perpetuals", "derivatives", "perp_trading", "leaderboard", "trader_ranking" ] }, "capability_tags": [ "nansen", "data_service", "perpetuals", "derivatives", "perp_trading", "leaderboard", "trader_ranking" ], "contract_version": "agent_data_service_contract_v1", "example_questions": [ "Query this provider data service with the sample request shape." ], "quality_expectations": { "result_envelope": "agent_data_envelope_v1", "must_include_metadata": [ "data_sources", "generated_at", "freshness_seconds", "confidence", "limitations" ], "empty_result_should_be_explicit": true, "preview_paid_shape_should_match": true }, "request_shape_summary": "object keys: date, pagination", "response_shape_summary": "object keys: data, pagination", "routing": { "routing_version": "agentrouter_structured_routing_v1", "domains": [ "crypto", "market_data", "onchain" ], "data_types": [ "nansen", "perpetuals", "derivatives", "perp_trading", "leaderboard", "trader_ranking" ], "entities": [ "wallet_address", "time_window" ], "chains": [], "time_requirements": { "supports_realtime": false, "supports_historical": true, "accepted_time_fields": [ "date" ] }, "input_fields": [ "date", "pagination" ], "output_fields": [ "data", "data.roi", "data.total_pnl", "data.account_value", "data.trader_address", "data.trader_address_label", "pagination", "pagination.page", "pagination.per_page", "pagination.is_last_page" ], "keywords": [ "perpetual", "trading", "leaderboard", "nansen", "when", "buyer", "agent", "needs", "endpoint", "perp-leaderboard", "data_service", "perpetuals", "derivatives", "perp_trading", "trader_ranking" ], "capability_refs": [ "nansen", "data_service", "perpetuals", "derivatives", "perp_trading", "leaderboard", "trader_ranking" ] } }, "sample_request": { "date": { "to": "2026-05-24", "from": "2026-05-20" }, "pagination": { "page": 1, "per_page": 3 } }, "runtime_secrets": { "public": false, "custody": "hosted_runtime_config", "required": true }, "sample_response": { "data": { "data": [ { "roi": "example", "total_pnl": "example", "account_value": "example", "trader_address": "0x0000000000000000000000000000000000000000", "trader_address_label": "0x0000000000000000000000000000000000000000" } ], "pagination": { "page": 1, "per_page": 10, "is_last_page": true } }, "query": { "date": { "to": "2026-05-24", "from": "2026-05-20" }, "pagination": { "page": 1, "per_page": 3 } }, "status": "success", "summary": "Use this Nansen API service when a buyer Agent needs Get Perpetual Trading Leaderboard Data. Endpoint: POST /api/v1/perp-leaderboard. (sample response)", "metadata": { "confidence": 0.7, "limitations": [ "Sample response is mock/static and not a live paid response." ], "data_sources": [ "provider_config_hosted_http" ], "generated_at": "2026-05-24T05:55:41.353Z", "is_estimated": true, "freshness_seconds": 86400 }, "request_id": "sample_req", "service_id": "nansen_perp_leaderboard", "agent_hints": { "good_for": [ "MVP validation", "Agent response parsing" ], "warnings": [ "Use paid invocation for the full response." ], "suggested_followups": [] }, "sample_type": "mock", "schema_version": "agent_data_envelope_v1" }, "manifest_version": "agent_data_service_manifest_v1", "data_source_claim": { "source_type": "provider_declared_data_service", "credential_custody": "hosted_runtime_config", "authorization_status": "provider_declared", "redistribution_status": "provider_declared", "source_provenance_level": "wrapped_api", "platform_stores_credentials": true }, "description_for_agent": "Use this Nansen API service when a buyer Agent needs Get Perpetual Trading Leaderboard Data. Endpoint: POST /api/v1/perp-leaderboard.", "manifest_type": "hosted_http_data_api", "version": "1.0.0", "routing": { "routing_version": "agentrouter_structured_routing_v1", "domains": [ "crypto", "market_data", "onchain" ], "data_types": [ "nansen", "perpetuals", "derivatives", "perp_trading", "leaderboard", "trader_ranking" ], "entities": [ "wallet_address", "time_window" ], "chains": [], "time_requirements": { "supports_realtime": false, "supports_historical": true, "accepted_time_fields": [ "date" ] }, "input_fields": [ "date", "pagination" ], "output_fields": [ "data", "data.roi", "data.total_pnl", "data.account_value", "data.trader_address", "data.trader_address_label", "pagination", "pagination.page", "pagination.per_page", "pagination.is_last_page" ], "keywords": [ "perpetual", "trading", "leaderboard", "nansen", "when", "buyer", "agent", "needs", "endpoint", "perp-leaderboard", "data_service", "perpetuals", "derivatives", "perp_trading", "trader_ranking" ], "capability_refs": [ "nansen", "data_service", "perpetuals", "derivatives", "perp_trading", "leaderboard", "trader_ranking" ] }, "erc8257": { "compatible": true, "compatibility_version": "agentrouter_erc8257_manifest_compat_v1", "tool_manifest_standard": "ERC-8257", "tool_type": "hosted_http_data_api", "tool_id": "nansen_perp_leaderboard", "registry_strategy": "compatible_manifest_only_no_custom_onchain_tool_registry", "metadata_hash": "0xac80c792b034a908300ffedbab3f50bf18e13fc6d62ab1de993ffa0f50345381" }, "integrity": { "integrity_version": "agentrouter_manifest_integrity_v1", "algorithm": "sha256-stable-json", "manifest_hash": "0xac80c792b034a908300ffedbab3f50bf18e13fc6d62ab1de993ffa0f50345381", "config_hash": "0x6f7c61e5ea09e93ce2492ba2173a55398fd44afef9d2f7085d96e0e16e543d1e", "created_at": "2026-09-08T17:05:29.992Z", "updated_at": "2026-09-08T17:05:29.992Z" } }, "latest_validation": { "ok": true, "service_id": "nansen_perp_leaderboard", "schema_errors": [], "envelope_errors": [], "result_errors": [], "result_preview": null, "created_at": "2026-09-08T08:21:24.267Z", "redaction": { "redacted": true, "reason": "Latest validation proves the endpoint responded with JSON, but public output omits paid data values." } }, "recent_evidence_events": [], "recent_quality_events": [], "recent_feedback_events": [], "recent_health_checks": [] }