{
  "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_profiler_address_pnl",
    "manifest_type": "hosted_http_data_api",
    "version": "1.0.0",
    "manifest_hash": "0x0539726e416900f1bd90d124f8b280e5a14ca33796bc0aaaa1dd52255ff96517",
    "config_hash": "0xa51f735ef44e37469e2b1ea32bbb66f08763c59ba503fe9d8ceacfae1913a914",
    "title": "Retrieve address PnL data",
    "display_title": "Retrieve address PnL data",
    "description_for_agent": "Use this Nansen API service when a buyer Agent needs Retrieve address PnL data. Endpoint: POST /api/v1/profiler/address/pnl. Best for wallet or address due diligence, balances, labels, PnL, counterparties, related wallets, and transaction history.",
    "capabilities": [
      "nansen",
      "data_service",
      "wallet_profile",
      "address_intelligence",
      "pnl",
      "profit_loss",
      "trader_performance"
    ],
    "routing": {
      "routing_version": "agentrouter_structured_routing_v1",
      "domains": [
        "crypto",
        "market_data",
        "onchain"
      ],
      "data_types": [
        "nansen",
        "wallet_profile",
        "address_intelligence",
        "pnl",
        "profit_loss",
        "trader_performance",
        "price"
      ],
      "entities": [
        "token",
        "wallet_address",
        "chain",
        "time_window"
      ],
      "chains": [
        "all"
      ],
      "time_requirements": {
        "supports_realtime": false,
        "supports_historical": true,
        "accepted_time_fields": [
          "date"
        ]
      },
      "input_fields": [
        "date",
        "chain",
        "address",
        "pagination"
      ],
      "output_fields": [
        "data",
        "data.nof_buys",
        "data.sold_usd",
        "data.nof_sells",
        "data.bought_usd",
        "data.holding_usd",
        "data.sold_amount",
        "data.token_price",
        "data.token_symbol",
        "data.bought_amount",
        "data.token_address",
        "data.cost_basis_usd",
        "data.holding_amount",
        "data.max_balance_held",
        "data.pnl_usd_realised",
        "data.avg_sold_price_usd",
        "data.pnl_usd_unrealised",
        "data.max_balance_held_usd",
        "data.roi_percent_realised",
        "data.roi_percent_unrealised",
        "pagination",
        "pagination.page",
        "pagination.per_page",
        "pagination.is_last_page"
      ],
      "keywords": [
        "retrieve",
        "address",
        "pnl",
        "nansen",
        "when",
        "buyer",
        "agent",
        "needs",
        "endpoint",
        "profiler",
        "best",
        "wallet",
        "due",
        "diligence",
        "balances",
        "labels",
        "counterparties"
      ],
      "capability_refs": [
        "nansen",
        "data_service",
        "wallet_profile",
        "address_intelligence",
        "pnl",
        "profit_loss",
        "trader_performance"
      ]
    },
    "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": 1,
      "operational_feedback_count": 1,
      "consumer_feedback_count": 0,
      "recent_failure_rate": 0,
      "success_rate": 1,
      "schema_valid_rate": 1,
      "freshness_valid_rate": 1,
      "coverage_valid_rate": 1,
      "intent_fit_rate": null,
      "intent_mismatch_count": 0,
      "intent_mismatch_rate": null,
      "usefulness_rate": null,
      "average_consumer_score": null,
      "average_agent_friendly_score": 1,
      "average_latency_ms": null,
      "verification_status": "verified",
      "feedback_state": "observed",
      "trust_score": 0.99,
      "trust_score_prior": 0.7,
      "trust_score_confidence": 0.1667,
      "routing_trust_score": 0.7483
    },
    "sample_request": {
      "date": {
        "to": "2025-05-03T23:59:59Z",
        "from": "2025-05-01T00:00:00Z"
      },
      "chain": "all",
      "address": "0xbbfb6566ad064c233af6314aeb1eee4c26a5f921",
      "pagination": {
        "page": 1,
        "per_page": 10
      }
    },
    "request_data": {
      "fields": [
        "address",
        "chain",
        "date",
        "pagination"
      ],
      "example": {
        "date": {
          "to": "2025-05-03T23:59:59Z",
          "from": "2025-05-01T00:00:00Z"
        },
        "chain": "all",
        "address": "0xbbfb6566ad064c233af6314aeb1eee4c26a5f921",
        "pagination": {
          "page": 1,
          "per_page": 10
        }
      },
      "purpose": "Use this example before payment to decide whether the service accepts the fields needed for the task.",
      "shape_summary": "object keys: address, chain, date, pagination"
    },
    "response_data": {
      "fields": [
        "pagination",
        "pagination.page",
        "pagination.per_page",
        "pagination.is_last_page",
        "data",
        "data.token_address",
        "data.token_symbol",
        "data.token_price",
        "data.roi_percent_realised",
        "data.pnl_usd_realised",
        "data.pnl_usd_unrealised",
        "data.roi_percent_unrealised",
        "data.bought_amount",
        "data.bought_usd",
        "data.cost_basis_usd",
        "data.sold_amount"
      ],
      "preview": {
        "data": [
          {
            "nof_buys": "example",
            "sold_usd": "example",
            "nof_sells": "example",
            "bought_usd": "example",
            "holding_usd": "example",
            "sold_amount": "example",
            "token_price": "example",
            "token_symbol": "BTC",
            "bought_amount": "example",
            "token_address": "0x0000000000000000000000000000000000000000",
            "cost_basis_usd": "example",
            "holding_amount": "example",
            "max_balance_held": "example",
            "pnl_usd_realised": "example",
            "avg_sold_price_usd": "example",
            "pnl_usd_unrealised": "example",
            "max_balance_held_usd": "example",
            "roi_percent_realised": "example",
            "roi_percent_unrealised": "example"
          }
        ],
        "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: pagination, data"
    },
    "pre_call_context": {
      "context_version": "agent_pre_call_context_v1",
      "decision_summary": "Use nansen_profiler_address_pnl when the task fits: nansen, wallet_profile, address_intelligence, pnl, profit_loss, trader_performance. 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.449Z",
        "latest_http_status": null
      },
      "trust": {
        "provider_id": "provider_nansen_api",
        "feedback_count": 1,
        "operational_feedback_count": 1,
        "consumer_feedback_count": 0,
        "recent_failure_rate": 0,
        "success_rate": 1,
        "schema_valid_rate": 1,
        "freshness_valid_rate": 1,
        "coverage_valid_rate": 1,
        "intent_fit_rate": null,
        "intent_mismatch_count": 0,
        "intent_mismatch_rate": null,
        "usefulness_rate": null,
        "average_consumer_score": null,
        "average_agent_friendly_score": 1,
        "average_latency_ms": null,
        "verification_status": "verified",
        "feedback_state": "observed",
        "trust_score": 0.99,
        "trust_score_prior": 0.7,
        "trust_score_confidence": 0.1667,
        "routing_trust_score": 0.7483
      },
      "health": {
        "health_version": "agent_service_health_v1",
        "status": "healthy",
        "last_validation_at": "2026-09-08T08:21:24.449Z",
        "last_validation_ok": true,
        "last_success_at": "2026-06-05T09:36:20.735Z",
        "last_failure_at": null,
        "latest_http_status": null,
        "recent_failure_rate": 0,
        "circuit_breaker": {
          "active": false,
          "reason": null,
          "recent_window": 1,
          "recent_failures": 0
        }
      },
      "request_data": {
        "fields": [
          "address",
          "chain",
          "date",
          "pagination"
        ],
        "example": {
          "date": {
            "to": "2025-05-03T23:59:59Z",
            "from": "2025-05-01T00:00:00Z"
          },
          "chain": "all",
          "address": "0xbbfb6566ad064c233af6314aeb1eee4c26a5f921",
          "pagination": {
            "page": 1,
            "per_page": 10
          }
        },
        "purpose": "Use this example before payment to decide whether the service accepts the fields needed for the task.",
        "shape_summary": "object keys: address, chain, date, pagination"
      },
      "response_data": {
        "fields": [
          "pagination",
          "pagination.page",
          "pagination.per_page",
          "pagination.is_last_page",
          "data",
          "data.token_address",
          "data.token_symbol",
          "data.token_price",
          "data.roi_percent_realised",
          "data.pnl_usd_realised",
          "data.pnl_usd_unrealised",
          "data.roi_percent_unrealised",
          "data.bought_amount",
          "data.bought_usd",
          "data.cost_basis_usd",
          "data.sold_amount"
        ],
        "preview": {
          "data": [
            {
              "nof_buys": "example",
              "sold_usd": "example",
              "nof_sells": "example",
              "bought_usd": "example",
              "holding_usd": "example",
              "sold_amount": "example",
              "token_price": "example",
              "token_symbol": "BTC",
              "bought_amount": "example",
              "token_address": "0x0000000000000000000000000000000000000000",
              "cost_basis_usd": "example",
              "holding_amount": "example",
              "max_balance_held": "example",
              "pnl_usd_realised": "example",
              "avg_sold_price_usd": "example",
              "pnl_usd_unrealised": "example",
              "max_balance_held_usd": "example",
              "roi_percent_realised": "example",
              "roi_percent_unrealised": "example"
            }
          ],
          "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: pagination, data"
      },
      "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": "<string>",
          "from": "<string>"
        },
        "chain": "<string>",
        "address": "<address_or_hash>",
        "pagination": {
          "page": "<number>",
          "per_page": "<number>"
        }
      },
      "data_shape": {
        "data": {
          "type": "array",
          "item_count_sample": 1,
          "item_shape": {
            "nof_buys": "<string>",
            "sold_usd": "<string>",
            "nof_sells": "<string>",
            "bought_usd": "<string>",
            "holding_usd": "<string>",
            "sold_amount": "<string>",
            "token_price": "<string>",
            "token_symbol": "<string>",
            "bought_amount": "<string>",
            "token_address": "<address_or_hash>",
            "cost_basis_usd": "<string>",
            "holding_amount": "<string>",
            "max_balance_held": "<string>",
            "pnl_usd_realised": "<string>",
            "avg_sold_price_usd": "<string>",
            "pnl_usd_unrealised": "<string>",
            "max_balance_held_usd": "<string>",
            "roi_percent_realised": "<string>",
            "roi_percent_unrealised": "<string>"
          }
        },
        "pagination": {
          "page": "<number>",
          "per_page": "<number>",
          "is_last_page": "<boolean>"
        }
      },
      "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 Retrieve address PnL data. Endpoint: POST /api/v1/profiler/address/pnl. Best for wallet or address due diligence, balances, labels, PnL, counterparties, related wallets, and transaction history. (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": 1,
      "quality_event_count": 1,
      "upstream_error_count": 0,
      "business_error_count": 0,
      "latest_verification": {
        "issues": [],
        "data_shape": {
          "type": "object",
          "empty": false,
          "nested_arrays": [
            {
              "key": "data",
              "item_count": 6
            }
          ],
          "top_level_keys": [
            "pagination",
            "data"
          ]
        },
        "sanity_valid": true,
        "schema_valid": true,
        "quality_model": {
          "name": "deterministic_first_data_quality_v1",
          "weights": {
            "deterministic": 0.8,
            "agent_friendly": 0.2
          }
        },
        "coverage_valid": true,
        "data_non_empty": true,
        "freshness_valid": true,
        "data_quality_issues": [],
        "deterministic_score": 1,
        "agent_friendly_score": 1,
        "overall_quality_score": 1
      },
      "latest_quality_event": {
        "status": "verified_result_recorded",
        "created_at": "2026-06-05T09:36:22.949Z",
        "event_hash": "0x7da962928f652f562ad713b4edd577d929475c86556a7f126168c441d4b3c8b8",
        "event_type": "completed_paid_invocation",
        "payment_tx": "0x60d15c4bc958a1c3465f5bf85d82a0ba81c152c6f3349cac86d4072c1fbe4f90",
        "request_id": "req_1780652177860",
        "service_id": "nansen_profiler_address_pnl",
        "trace_hash": "0xcea6107094000ba8b425d219b2aaa7b8ab221357ce4ec26b7529186ef96f91dd",
        "provider_id": "provider_nansen_api",
        "event_version": "agent_service_quality_event_v1",
        "blocking_issues": [],
        "quality_event_id": "0xc4869bb67f4512b833f58483b741cfdb468fc4bd2d61136f62d3234c0f2ad3e8",
        "consumer_feedback_expected": true,
        "deterministic_verification": {
          "issues": [],
          "data_shape": {
            "type": "object",
            "empty": false,
            "nested_arrays": [
              {
                "key": "data",
                "item_count": 6
              }
            ],
            "top_level_keys": [
              "pagination",
              "data"
            ]
          },
          "sanity_valid": true,
          "schema_valid": true,
          "quality_model": {
            "name": "deterministic_first_data_quality_v1",
            "weights": {
              "deterministic": 0.8,
              "agent_friendly": 0.2
            }
          },
          "coverage_valid": true,
          "data_non_empty": true,
          "freshness_valid": true,
          "data_quality_issues": [],
          "deterministic_score": 1,
          "agent_friendly_score": 1,
          "overall_quality_score": 1
        }
      },
      "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.449Z",
      "last_validation_ok": true,
      "last_success_at": "2026-06-05T09:36:20.735Z",
      "last_failure_at": null,
      "latest_http_status": null,
      "recent_failure_rate": 0,
      "circuit_breaker": {
        "active": false,
        "reason": null,
        "recent_window": 1,
        "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.449Z",
    "updated_at": "2026-09-08T17:04:49.392Z"
  },
  "manifest": {
    "title": "Retrieve address PnL 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_profiler_address_pnl",
      "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_profiler_address_pnl",
    "capabilities": [
      "nansen",
      "data_service",
      "wallet_profile",
      "address_intelligence",
      "pnl",
      "profit_loss",
      "trader_performance"
    ],
    "input_schema": {
      "type": "object",
      "properties": {
        "date": {
          "type": "object",
          "properties": {
            "to": {
              "type": "string"
            },
            "from": {
              "type": "string"
            }
          }
        },
        "chain": {
          "type": "string"
        },
        "address": {
          "type": "string"
        },
        "pagination": {
          "type": "object",
          "properties": {
            "page": {
              "type": "number"
            },
            "per_page": {
              "type": "number"
            }
          }
        }
      }
    },
    "registration": {
      "duplicate_policy": "same_provider_source_is_idempotent",
      "source_fingerprint": "sha256:481fec763ad78018a08bd41f6623551baf90f56d937f79be5c43cb45e028fd69",
      "manifest_hash": "0x0539726e416900f1bd90d124f8b280e5a14ca33796bc0aaaa1dd52255ff96517",
      "config_hash": "0xa51f735ef44e37469e2b1ea32bbb66f08763c59ba503fe9d8ceacfae1913a914",
      "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:04:49.392Z"
      }
    },
    "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 Retrieve address PnL data. Endpoint: POST /api/v1/profiler/address/pnl. Best for wallet or address due diligence, balances, labels, PnL, counterparties, related wallets, and transaction history.",
      "request_data": {
        "fields": [
          "address",
          "chain",
          "date",
          "pagination"
        ],
        "example": {
          "date": {
            "to": "2025-05-03T23:59:59Z",
            "from": "2025-05-01T00:00:00Z"
          },
          "chain": "all",
          "address": "0xbbfb6566ad064c233af6314aeb1eee4c26a5f921",
          "pagination": {
            "page": 1,
            "per_page": 10
          }
        },
        "purpose": "Use this example before payment to decide whether the service accepts the fields needed for the task.",
        "shape_summary": "object keys: address, chain, date, pagination"
      },
      "response_data": {
        "fields": [
          "pagination",
          "pagination.page",
          "pagination.per_page",
          "pagination.is_last_page",
          "data",
          "data.token_address",
          "data.token_symbol",
          "data.token_price",
          "data.roi_percent_realised",
          "data.pnl_usd_realised",
          "data.pnl_usd_unrealised",
          "data.roi_percent_unrealised",
          "data.bought_amount",
          "data.bought_usd",
          "data.cost_basis_usd",
          "data.sold_amount"
        ],
        "preview": {
          "data": [
            {
              "nof_buys": "example",
              "sold_usd": "example",
              "nof_sells": "example",
              "bought_usd": "example",
              "holding_usd": "example",
              "sold_amount": "example",
              "token_price": "example",
              "token_symbol": "BTC",
              "bought_amount": "example",
              "token_address": "0x0000000000000000000000000000000000000000",
              "cost_basis_usd": "example",
              "holding_amount": "example",
              "max_balance_held": "example",
              "pnl_usd_realised": "example",
              "avg_sold_price_usd": "example",
              "pnl_usd_unrealised": "example",
              "max_balance_held_usd": "example",
              "roi_percent_realised": "example",
              "roi_percent_unrealised": "example"
            }
          ],
          "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: pagination, data"
      },
      "routing_hints": {
        "not_for": [],
        "good_for": [
          "nansen",
          "wallet_profile",
          "address_intelligence",
          "pnl",
          "profit_loss",
          "trader_performance"
        ]
      },
      "capability_tags": [
        "nansen",
        "data_service",
        "wallet_profile",
        "address_intelligence",
        "pnl",
        "profit_loss",
        "trader_performance"
      ],
      "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: address, chain, date, pagination",
      "response_shape_summary": "object keys: pagination, data",
      "routing": {
        "routing_version": "agentrouter_structured_routing_v1",
        "domains": [
          "crypto",
          "market_data",
          "onchain"
        ],
        "data_types": [
          "nansen",
          "wallet_profile",
          "address_intelligence",
          "pnl",
          "profit_loss",
          "trader_performance",
          "price"
        ],
        "entities": [
          "token",
          "wallet_address",
          "chain",
          "time_window"
        ],
        "chains": [
          "all"
        ],
        "time_requirements": {
          "supports_realtime": false,
          "supports_historical": true,
          "accepted_time_fields": [
            "date"
          ]
        },
        "input_fields": [
          "date",
          "chain",
          "address",
          "pagination"
        ],
        "output_fields": [
          "data",
          "data.nof_buys",
          "data.sold_usd",
          "data.nof_sells",
          "data.bought_usd",
          "data.holding_usd",
          "data.sold_amount",
          "data.token_price",
          "data.token_symbol",
          "data.bought_amount",
          "data.token_address",
          "data.cost_basis_usd",
          "data.holding_amount",
          "data.max_balance_held",
          "data.pnl_usd_realised",
          "data.avg_sold_price_usd",
          "data.pnl_usd_unrealised",
          "data.max_balance_held_usd",
          "data.roi_percent_realised",
          "data.roi_percent_unrealised",
          "pagination",
          "pagination.page",
          "pagination.per_page",
          "pagination.is_last_page"
        ],
        "keywords": [
          "retrieve",
          "address",
          "pnl",
          "nansen",
          "when",
          "buyer",
          "agent",
          "needs",
          "endpoint",
          "profiler",
          "best",
          "wallet",
          "due",
          "diligence",
          "balances",
          "labels",
          "counterparties"
        ],
        "capability_refs": [
          "nansen",
          "data_service",
          "wallet_profile",
          "address_intelligence",
          "pnl",
          "profit_loss",
          "trader_performance"
        ]
      }
    },
    "sample_request": {
      "date": {
        "to": "2025-05-03T23:59:59Z",
        "from": "2025-05-01T00:00:00Z"
      },
      "chain": "all",
      "address": "0xbbfb6566ad064c233af6314aeb1eee4c26a5f921",
      "pagination": {
        "page": 1,
        "per_page": 10
      }
    },
    "runtime_secrets": {
      "public": false,
      "custody": "hosted_runtime_config",
      "required": true
    },
    "sample_response": {
      "data": {
        "data": [
          {
            "nof_buys": "example",
            "sold_usd": "example",
            "nof_sells": "example",
            "bought_usd": "example",
            "holding_usd": "example",
            "sold_amount": "example",
            "token_price": "example",
            "token_symbol": "BTC",
            "bought_amount": "example",
            "token_address": "0x0000000000000000000000000000000000000000",
            "cost_basis_usd": "example",
            "holding_amount": "example",
            "max_balance_held": "example",
            "pnl_usd_realised": "example",
            "avg_sold_price_usd": "example",
            "pnl_usd_unrealised": "example",
            "max_balance_held_usd": "example",
            "roi_percent_realised": "example",
            "roi_percent_unrealised": "example"
          }
        ],
        "pagination": {
          "page": 1,
          "per_page": 10,
          "is_last_page": true
        }
      },
      "query": {
        "date": {
          "to": "2025-05-03T23:59:59Z",
          "from": "2025-05-01T00:00:00Z"
        },
        "chain": "all",
        "address": "0xbbfb6566ad064c233af6314aeb1eee4c26a5f921",
        "pagination": {
          "page": 1,
          "per_page": 10
        }
      },
      "status": "success",
      "summary": "Use this Nansen API service when a buyer Agent needs Retrieve address PnL data. Endpoint: POST /api/v1/profiler/address/pnl. Best for wallet or address due diligence, balances, labels, PnL, counterparties, related wallets, and transaction history. (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:56:28.559Z",
        "is_estimated": true,
        "freshness_seconds": 86400
      },
      "request_id": "sample_req",
      "service_id": "nansen_profiler_address_pnl",
      "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 Retrieve address PnL data. Endpoint: POST /api/v1/profiler/address/pnl. Best for wallet or address due diligence, balances, labels, PnL, counterparties, related wallets, and transaction history.",
    "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",
        "wallet_profile",
        "address_intelligence",
        "pnl",
        "profit_loss",
        "trader_performance",
        "price"
      ],
      "entities": [
        "token",
        "wallet_address",
        "chain",
        "time_window"
      ],
      "chains": [
        "all"
      ],
      "time_requirements": {
        "supports_realtime": false,
        "supports_historical": true,
        "accepted_time_fields": [
          "date"
        ]
      },
      "input_fields": [
        "date",
        "chain",
        "address",
        "pagination"
      ],
      "output_fields": [
        "data",
        "data.nof_buys",
        "data.sold_usd",
        "data.nof_sells",
        "data.bought_usd",
        "data.holding_usd",
        "data.sold_amount",
        "data.token_price",
        "data.token_symbol",
        "data.bought_amount",
        "data.token_address",
        "data.cost_basis_usd",
        "data.holding_amount",
        "data.max_balance_held",
        "data.pnl_usd_realised",
        "data.avg_sold_price_usd",
        "data.pnl_usd_unrealised",
        "data.max_balance_held_usd",
        "data.roi_percent_realised",
        "data.roi_percent_unrealised",
        "pagination",
        "pagination.page",
        "pagination.per_page",
        "pagination.is_last_page"
      ],
      "keywords": [
        "retrieve",
        "address",
        "pnl",
        "nansen",
        "when",
        "buyer",
        "agent",
        "needs",
        "endpoint",
        "profiler",
        "best",
        "wallet",
        "due",
        "diligence",
        "balances",
        "labels",
        "counterparties"
      ],
      "capability_refs": [
        "nansen",
        "data_service",
        "wallet_profile",
        "address_intelligence",
        "pnl",
        "profit_loss",
        "trader_performance"
      ]
    },
    "erc8257": {
      "compatible": true,
      "compatibility_version": "agentrouter_erc8257_manifest_compat_v1",
      "tool_manifest_standard": "ERC-8257",
      "tool_type": "hosted_http_data_api",
      "tool_id": "nansen_profiler_address_pnl",
      "registry_strategy": "compatible_manifest_only_no_custom_onchain_tool_registry",
      "metadata_hash": "0x0539726e416900f1bd90d124f8b280e5a14ca33796bc0aaaa1dd52255ff96517"
    },
    "integrity": {
      "integrity_version": "agentrouter_manifest_integrity_v1",
      "algorithm": "sha256-stable-json",
      "manifest_hash": "0x0539726e416900f1bd90d124f8b280e5a14ca33796bc0aaaa1dd52255ff96517",
      "config_hash": "0xa51f735ef44e37469e2b1ea32bbb66f08763c59ba503fe9d8ceacfae1913a914",
      "created_at": "2026-09-08T17:04:49.348Z",
      "updated_at": "2026-09-08T17:04:49.348Z"
    }
  },
  "latest_validation": {
    "ok": true,
    "service_id": "nansen_profiler_address_pnl",
    "schema_errors": [],
    "envelope_errors": [],
    "result_errors": [],
    "result_preview": null,
    "created_at": "2026-09-08T08:21:24.449Z",
    "redaction": {
      "redacted": true,
      "reason": "Latest validation proves the endpoint responded with JSON, but public output omits paid data values."
    }
  },
  "recent_evidence_events": [
    {
      "input": {
        "date": {
          "to": "2025-05-03T23:59:59Z",
          "from": "2025-05-01T00:00:00Z"
        },
        "chain": "ethereum",
        "address": "0xbbfb6566ad064c233af6314aeb1eee4c26a5f921",
        "pagination": {
          "page": 1,
          "per_page": 10
        }
      },
      "payment": {
        "quote": {
          "amount": "0.01",
          "currency": "USDC",
          "service_id": "nansen_profiler_address_pnl",
          "quote_version": "agent_router_payment_quote_v1",
          "payment_backend": "circle_arc"
        },
        "payment_tx": "0x60d15c4bc958a1c3465f5bf85d82a0ba81c152c6f3349cac86d4072c1fbe4f90",
        "settlement_receipt": {
          "mode": "circle_arc",
          "asset": "USDC",
          "caip2": "eip155:5042002",
          "payer": "agentrouter_consumer",
          "amount": "0.01",
          "pay_to": "0x2c4d600a04c0d3bbb1e3cc8a13e54e21c2b6c0bb",
          "status": "settled",
          "network": "arc-testnet",
          "tx_hash": "0x60d15c4bc958a1c3465f5bf85d82a0ba81c152c6f3349cac86d4072c1fbe4f90",
          "chain_id": 5042002,
          "protocol": "x402",
          "created_at": "2026-06-05T09:36:20.487Z",
          "token_address": "0x3600000000000000000000000000000000000000",
          "payment_backend": "circle_arc",
          "receipt_version": "agent_router_settlement_receipt_v1",
          "settlement_model": "direct_provider_wallet"
        }
      },
      "request": {
        "budget": {
          "currency": "USDC",
          "max_amount": "0.50"
        },
        "params": {
          "chain": "ethereum",
          "groupby": "pnl_status"
        },
        "capability": "nansen_profiler_address_pnl",
        "constraints": {
          "max_price_usdc": "0.50"
        },
        "consumer_context": {
          "source": "agentrouter_structured_request_local_wallet"
        }
      },
      "arc_anchor": {
        "mode": "arc_testnet",
        "caip2": "eip155:5042002",
        "status": "anchored",
        "network": "arc-testnet",
        "tx_hash": "0xd7a9b8536a4b286e1cc8e002c605b077a8b99ea8331f55c690c39fa5e56fd2eb",
        "chain_id": 5042002,
        "created_at": "2026-06-05T09:36:22.578Z",
        "event_type": "AgentRouterEvidence",
        "request_id": "req_1780652177860",
        "trace_hash": "0xcea6107094000ba8b425d219b2aaa7b8ab221357ce4ec26b7529186ef96f91dd",
        "result_hash": "0x5639046d8041b66365493d4e6225188b93e22f8bfa40f051ed5e559f1ce062bc",
        "block_number": "45613615",
        "explorer_url": "https://testnet.arcscan.app/tx/0xd7a9b8536a4b286e1cc8e002c605b077a8b99ea8331f55c690c39fa5e56fd2eb",
        "service_hash": "0xf5ba2cf4d12cff3f2ffe19bbd7f2cdf3c7925774bf91143e58b75ad42b28868c",
        "provider_hash": "0xbcaf14232bef0239c4c62e15f3c41109b667630ed6520867e1b4181ad1dc8669",
        "storage_model": "full_evidence_offchain_hashes_on_arc",
        "anchor_account": "0x2C4d600a04c0d3bbb1e3Cc8a13e54e21c2B6C0bB",
        "anchor_version": "agent_router_arc_anchor_v1",
        "payment_tx_hash": "0x60d15c4bc958a1c3465f5bf85d82a0ba81c152c6f3349cac86d4072c1fbe4f90",
        "contract_address": "0x65274c73f39bf1654f9aaf261ea16d0b08fdb8d0",
        "verification_hash": "0xd1b135ca339f1b85904ecce0deefd4a56c72991524cafa145d295232d67f454c"
      },
      "created_at": "2026-06-05T09:36:21.235Z",
      "input_hash": "0x63d9fc499a034d9b6e96bbc6b731f0731cb7810094fe09a09281da699a5168ca",
      "payment_tx": "0x60d15c4bc958a1c3465f5bf85d82a0ba81c152c6f3349cac86d4072c1fbe4f90",
      "request_id": "req_1780652177860",
      "route_type": "completed_paid_invocation",
      "service_id": "nansen_profiler_address_pnl",
      "trace_hash": "0xcea6107094000ba8b425d219b2aaa7b8ab221357ce4ec26b7529186ef96f91dd",
      "config_hash": "0x186ca7b77485e9f4cb5e5d3e00a0234450dbc1e33dba9a6b2a15799d1b57aea2",
      "output_hash": "0x5639046d8041b66365493d4e6225188b93e22f8bfa40f051ed5e559f1ce062bc",
      "provider_id": "provider_nansen_api",
      "result_hash": "0x5639046d8041b66365493d4e6225188b93e22f8bfa40f051ed5e559f1ce062bc",
      "verification": {
        "issues": [],
        "data_shape": {
          "type": "object",
          "empty": false,
          "nested_arrays": [
            {
              "key": "data",
              "item_count": 6
            }
          ],
          "top_level_keys": [
            "pagination",
            "data"
          ]
        },
        "sanity_valid": true,
        "schema_valid": true,
        "quality_model": {
          "name": "deterministic_first_data_quality_v1",
          "weights": {
            "deterministic": 0.8,
            "agent_friendly": 0.2
          }
        },
        "coverage_valid": true,
        "data_non_empty": true,
        "freshness_valid": true,
        "data_quality_issues": [],
        "deterministic_score": 1,
        "agent_friendly_score": 1,
        "overall_quality_score": 1
      },
      "manifest_hash": "0xa1546fc81bbcf71da59704133a3537b0451ee7cde9fd59da30cc50098771caa8",
      "manifest_type": "hosted_http_data_api",
      "service_binding": {
        "version": "1.0.0",
        "service_id": "nansen_profiler_address_pnl",
        "config_hash": "0x186ca7b77485e9f4cb5e5d3e00a0234450dbc1e33dba9a6b2a15799d1b57aea2",
        "provider_id": "provider_nansen_api",
        "manifest_hash": "0xa1546fc81bbcf71da59704133a3537b0451ee7cde9fd59da30cc50098771caa8",
        "manifest_type": "hosted_http_data_api"
      },
      "service_version": "1.0.0",
      "evidence_profile": {
        "profile_type": "paid_hosted_http_data_api_execution",
        "manifest_type": "hosted_http_data_api",
        "storage_model": "offchain_full_evidence_arc_hash_anchor",
        "evidence_scope": "service_call",
        "profile_version": "agentrouter_execution_evidence_profile_v1",
        "required_bindings": [
          "service_id",
          "manifest_hash",
          "input_hash",
          "output_hash",
          "payment_tx",
          "verification_report"
        ],
        "erc8257_manifest_compatible": true,
        "erc8004_reputation_compatible": true
      },
      "evidence_version": "agent_router_evidence_v1",
      "selected_service": {
        "title": "Retrieve address PnL data",
        "trust": {
          "provider_id": "provider_nansen_api",
          "trust_score": 0.99,
          "success_rate": 1,
          "feedback_count": 1,
          "intent_fit_rate": null,
          "usefulness_rate": null,
          "schema_valid_rate": 1,
          "average_latency_ms": null,
          "coverage_valid_rate": 1,
          "recent_failure_rate": 0,
          "verification_status": "verified",
          "freshness_valid_rate": 1,
          "average_consumer_score": null,
          "consumer_feedback_count": 0,
          "operational_feedback_count": 1,
          "average_agent_friendly_score": 1
        },
        "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"
          }
        ],
        "health": {
          "status": "healthy",
          "health_version": "agent_service_health_v1",
          "circuit_breaker": {
            "active": false,
            "reason": null,
            "recent_window": 1,
            "recent_failures": 0
          },
          "last_failure_at": null,
          "last_success_at": "2026-06-05T09:36:20.735Z",
          "last_validation_at": "2026-06-05T08:52:24.125Z",
          "last_validation_ok": true,
          "latest_http_status": null,
          "recent_failure_rate": 0
        },
        "pricing": {
          "amount": "0.01",
          "pay_to": "0x2c4d600a04c0d3bbb1e3cc8a13e54e21c2b6c0bb",
          "network": "base",
          "currency": "USDC",
          "protocol": "x402",
          "settlement_model": "direct_provider_wallet"
        },
        "routing": {
          "chains": [
            "all"
          ],
          "domains": [
            "crypto",
            "market_data",
            "onchain"
          ],
          "entities": [
            "token",
            "wallet_address",
            "chain",
            "time_window"
          ],
          "keywords": [
            "retrieve",
            "address",
            "pnl",
            "nansen",
            "when",
            "buyer",
            "agent",
            "needs",
            "endpoint",
            "profiler",
            "best",
            "wallet",
            "due",
            "diligence",
            "balances",
            "labels",
            "counterparties"
          ],
          "data_types": [
            "nansen",
            "wallet_profile",
            "address_intelligence",
            "pnl",
            "profit_loss",
            "trader_performance",
            "price"
          ],
          "input_fields": [
            "date",
            "chain",
            "address",
            "pagination"
          ],
          "output_fields": [
            "data",
            "data.nof_buys",
            "data.sold_usd",
            "data.nof_sells",
            "data.bought_usd",
            "data.holding_usd",
            "data.sold_amount",
            "data.token_price",
            "data.token_symbol",
            "data.bought_amount",
            "data.token_address",
            "data.cost_basis_usd",
            "data.holding_amount",
            "data.max_balance_held",
            "data.pnl_usd_realised",
            "data.avg_sold_price_usd",
            "data.pnl_usd_unrealised",
            "data.max_balance_held_usd",
            "data.roi_percent_realised",
            "data.roi_percent_unrealised",
            "pagination",
            "pagination.page",
            "pagination.per_page",
            "pagination.is_last_page"
          ],
          "capability_refs": [
            "nansen",
            "data_service",
            "wallet_profile",
            "address_intelligence",
            "pnl",
            "profit_loss",
            "trader_performance"
          ],
          "routing_version": "agentrouter_structured_routing_v1",
          "time_requirements": {
            "supports_realtime": false,
            "supports_historical": true,
            "accepted_time_fields": [
              "date"
            ]
          }
        },
        "version": "1.0.0",
        "created_at": "2026-06-05T08:52:24.125Z",
        "service_id": "nansen_profiler_address_pnl",
        "updated_at": "2026-06-05T08:52:24.125Z",
        "config_hash": "0x186ca7b77485e9f4cb5e5d3e00a0234450dbc1e33dba9a6b2a15799d1b57aea2",
        "capabilities": [
          "nansen",
          "data_service",
          "wallet_profile",
          "address_intelligence",
          "pnl",
          "profit_loss",
          "trader_performance",
          "transaction_data"
        ],
        "request_data": {
          "fields": [
            "address",
            "chain",
            "date",
            "pagination"
          ],
          "example": {
            "date": {
              "to": "2025-05-03T23:59:59Z",
              "from": "2025-05-01T00:00:00Z"
            },
            "chain": "all",
            "address": "0xbbfb6566ad064c233af6314aeb1eee4c26a5f921",
            "pagination": {
              "page": 1,
              "per_page": 10
            }
          },
          "purpose": "Use this example before payment to decide whether the service accepts the fields needed for the task.",
          "shape_summary": "object keys: address, chain, date, pagination"
        },
        "display_title": "Retrieve address PnL data",
        "manifest_hash": "0xa1546fc81bbcf71da59704133a3537b0451ee7cde9fd59da30cc50098771caa8",
        "manifest_type": "hosted_http_data_api",
        "response_data": {
          "fields": [
            "pagination",
            "pagination.page",
            "pagination.per_page",
            "pagination.is_last_page",
            "data",
            "data.token_address",
            "data.token_symbol",
            "data.token_price",
            "data.roi_percent_realised",
            "data.pnl_usd_realised",
            "data.pnl_usd_unrealised",
            "data.roi_percent_unrealised",
            "data.bought_amount",
            "data.bought_usd",
            "data.cost_basis_usd",
            "data.sold_amount"
          ],
          "preview": {
            "data": [
              {
                "nof_buys": "example",
                "sold_usd": "example",
                "nof_sells": "example",
                "bought_usd": "example",
                "holding_usd": "example",
                "sold_amount": "example",
                "token_price": "example",
                "token_symbol": "BTC",
                "bought_amount": "example",
                "token_address": "0x0000000000000000000000000000000000000000",
                "cost_basis_usd": "example",
                "holding_amount": "example",
                "max_balance_held": "example",
                "pnl_usd_realised": "example",
                "avg_sold_price_usd": "example",
                "pnl_usd_unrealised": "example",
                "max_balance_held_usd": "example",
                "roi_percent_realised": "example",
                "roi_percent_unrealised": "example"
              }
            ],
            "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: pagination, data"
        },
        "sample_request": {
          "date": {
            "to": "2025-05-03T23:59:59Z",
            "from": "2025-05-01T00:00:00Z"
          },
          "chain": "all",
          "address": "0xbbfb6566ad064c233af6314aeb1eee4c26a5f921",
          "pagination": {
            "page": 1,
            "per_page": 10
          }
        },
        "quality_profile": {
          "feedback_count": 1,
          "profile_version": "agent_data_quality_profile_v1",
          "result_contract": {
            "semantic_checks": [
              "agent_friendliness",
              "intent_fit_summary"
            ],
            "envelope_required": true,
            "deterministic_checks": [
              "http_status",
              "schema",
              "envelope",
              "freshness",
              "coverage",
              "empty_result"
            ]
          },
          "latest_verification": {
            "issues": [],
            "data_shape": {
              "type": "object",
              "empty": false,
              "nested_arrays": [
                {
                  "key": "data",
                  "item_count": 6
                }
              ],
              "top_level_keys": [
                "pagination",
                "data"
              ]
            },
            "sanity_valid": true,
            "schema_valid": true,
            "quality_model": {
              "name": "deterministic_first_data_quality_v1",
              "weights": {
                "deterministic": 0.8,
                "agent_friendly": 0.2
              }
            },
            "coverage_valid": true,
            "data_non_empty": true,
            "freshness_valid": true,
            "data_quality_issues": [],
            "deterministic_score": 1,
            "agent_friendly_score": 1,
            "overall_quality_score": 1
          },
          "quality_event_count": 0,
          "verification_status": "verified",
          "business_error_count": 0,
          "latest_quality_event": null,
          "latest_validation_ok": true,
          "upstream_error_count": 0,
          "latest_validation_error": null,
          "declared_freshness_seconds": 300
        },
        "sample_response": {
          "status": "success",
          "summary": "Use this Nansen API service when a buyer Agent needs Retrieve address PnL data. Endpoint: POST /api/v1/profiler/address/pnl. Best for wallet or address due diligence, balances, labels, PnL, counterparties, related wallets, and transaction history. (sample response)",
          "metadata": {
            "confidence": 0.7,
            "limitations": [
              "Sample response is mock/static and not a live paid response."
            ],
            "data_sources": [
              "provider_config_hosted_http"
            ],
            "is_estimated": true,
            "freshness_seconds": 86400
          },
          "redaction": {
            "reason": "Public discovery responses expose schema and shape only. Real values require paid invocation.",
            "redacted": true
          },
          "data_shape": {
            "data": {
              "type": "array",
              "item_shape": {
                "nof_buys": "<string>",
                "sold_usd": "<string>",
                "nof_sells": "<string>",
                "bought_usd": "<string>",
                "holding_usd": "<string>",
                "sold_amount": "<string>",
                "token_price": "<string>",
                "token_symbol": "<string>",
                "bought_amount": "<string>",
                "token_address": "<address_or_hash>",
                "cost_basis_usd": "<string>",
                "holding_amount": "<string>",
                "max_balance_held": "<string>",
                "pnl_usd_realised": "<string>",
                "avg_sold_price_usd": "<string>",
                "pnl_usd_unrealised": "<string>",
                "max_balance_held_usd": "<string>",
                "roi_percent_realised": "<string>",
                "roi_percent_unrealised": "<string>"
              },
              "item_count_sample": 1
            },
            "pagination": {
              "page": "<number>",
              "per_page": "<number>",
              "is_last_page": "<boolean>"
            }
          },
          "agent_hints": {
            "good_for": [
              "MVP validation",
              "Agent response parsing"
            ],
            "warnings": [
              "Use paid invocation for the full response."
            ],
            "suggested_followups": []
          },
          "query_shape": {
            "date": {
              "to": "<string>",
              "from": "<string>"
            },
            "chain": "<string>",
            "address": "<address_or_hash>",
            "pagination": {
              "page": "<number>",
              "per_page": "<number>"
            }
          },
          "sample_type": "mock",
          "schema_version": "agent_data_envelope_v1"
        },
        "pre_call_context": {
          "trust": {
            "provider_id": "provider_nansen_api",
            "trust_score": 0.99,
            "success_rate": 1,
            "feedback_count": 1,
            "intent_fit_rate": null,
            "usefulness_rate": null,
            "schema_valid_rate": 1,
            "average_latency_ms": null,
            "coverage_valid_rate": 1,
            "recent_failure_rate": 0,
            "verification_status": "verified",
            "freshness_valid_rate": 1,
            "average_consumer_score": null,
            "consumer_feedback_count": 0,
            "operational_feedback_count": 1,
            "average_agent_friendly_score": 1
          },
          "health": {
            "status": "healthy",
            "health_version": "agent_service_health_v1",
            "circuit_breaker": {
              "active": false,
              "reason": null,
              "recent_window": 1,
              "recent_failures": 0
            },
            "last_failure_at": null,
            "last_success_at": "2026-06-05T09:36:20.735Z",
            "last_validation_at": "2026-06-05T08:52:24.125Z",
            "last_validation_ok": true,
            "latest_http_status": null,
            "recent_failure_rate": 0
          },
          "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": {
            "source_type": "provider_declared_data_service",
            "credential_custody": "hosted_runtime_config",
            "provenance_version": "agent_data_source_provenance_v1",
            "authorization_status": "provider_declared",
            "verified_by_platform": false,
            "redistribution_status": "provider_declared",
            "source_provenance_level": "wrapped_api",
            "platform_stores_credentials": true
          },
          "risk_flags": [
            "has_declared_limitations"
          ],
          "limitations": [
            "Sample response is mock/static and not a live paid response."
          ],
          "request_data": {
            "fields": [
              "address",
              "chain",
              "date",
              "pagination"
            ],
            "example": {
              "date": {
                "to": "2025-05-03T23:59:59Z",
                "from": "2025-05-01T00:00:00Z"
              },
              "chain": "all",
              "address": "0xbbfb6566ad064c233af6314aeb1eee4c26a5f921",
              "pagination": {
                "page": 1,
                "per_page": 10
              }
            },
            "purpose": "Use this example before payment to decide whether the service accepts the fields needed for the task.",
            "shape_summary": "object keys: address, chain, date, pagination"
          },
          "verification": {
            "status": "verified",
            "last_validation_at": "2026-06-05T08:52:24.125Z",
            "last_validation_ok": true,
            "latest_http_status": null
          },
          "response_data": {
            "fields": [
              "pagination",
              "pagination.page",
              "pagination.per_page",
              "pagination.is_last_page",
              "data",
              "data.token_address",
              "data.token_symbol",
              "data.token_price",
              "data.roi_percent_realised",
              "data.pnl_usd_realised",
              "data.pnl_usd_unrealised",
              "data.roi_percent_unrealised",
              "data.bought_amount",
              "data.bought_usd",
              "data.cost_basis_usd",
              "data.sold_amount"
            ],
            "preview": {
              "data": [
                {
                  "nof_buys": "example",
                  "sold_usd": "example",
                  "nof_sells": "example",
                  "bought_usd": "example",
                  "holding_usd": "example",
                  "sold_amount": "example",
                  "token_price": "example",
                  "token_symbol": "BTC",
                  "bought_amount": "example",
                  "token_address": "0x0000000000000000000000000000000000000000",
                  "cost_basis_usd": "example",
                  "holding_amount": "example",
                  "max_balance_held": "example",
                  "pnl_usd_realised": "example",
                  "avg_sold_price_usd": "example",
                  "pnl_usd_unrealised": "example",
                  "max_balance_held_usd": "example",
                  "roi_percent_realised": "example",
                  "roi_percent_unrealised": "example"
                }
              ],
              "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: pagination, data"
          },
          "context_version": "agent_pre_call_context_v1",
          "decision_summary": "Use nansen_profiler_address_pnl when the task fits: nansen, wallet_profile, address_intelligence, pnl, profit_loss, trader_performance. Costs 0.01 USDC via x402 on base. Service is currently healthy.",
          "buyer_requirements": {
            "network": "base",
            "currency": "USDC",
            "max_budget_field": "max_amount",
            "payment_protocol": "x402",
            "payment_required": true,
            "needs_buyer_api_key": false
          },
          "provider_requirements": {
            "credential_public": false,
            "credential_custody": "hosted_runtime_config",
            "provider_credential_required": true
          }
        },
        "source_provenance": {
          "source_type": "provider_declared_data_service",
          "credential_custody": "hosted_runtime_config",
          "provenance_version": "agent_data_source_provenance_v1",
          "authorization_status": "provider_declared",
          "verified_by_platform": false,
          "redistribution_status": "provider_declared",
          "source_provenance_level": "wrapped_api",
          "platform_stores_credentials": true
        },
        "verification_status": "verified",
        "description_for_agent": "Use this Nansen API service when a buyer Agent needs Retrieve address PnL data. Endpoint: POST /api/v1/profiler/address/pnl. Best for wallet or address due diligence, balances, labels, PnL, counterparties, related wallets, and transaction history.",
        "validation_result_preview": null
      },
      "verification_hash": "0xd1b135ca339f1b85904ecce0deefd4a56c72991524cafa145d295232d67f454c",
      "trace_payload_hash": "0xcea6107094000ba8b425d219b2aaa7b8ab221357ce4ec26b7529186ef96f91dd",
      "verification_report": {
        "created_at": "2026-06-05T09:36:21.235Z",
        "request_id": "req_1780652177860",
        "service_id": "nansen_profiler_address_pnl",
        "report_hash": "0xd1b135ca339f1b85904ecce0deefd4a56c72991524cafa145d295232d67f454c",
        "schema_valid": true,
        "business_error": null,
        "coverage_valid": true,
        "data_non_empty": true,
        "report_version": "agentrouter_verification_report_v1",
        "freshness_valid": true,
        "deterministic_checks": {
          "issues": [],
          "data_shape": {
            "type": "object",
            "empty": false,
            "nested_arrays": [
              {
                "key": "data",
                "item_count": 6
              }
            ],
            "top_level_keys": [
              "pagination",
              "data"
            ]
          },
          "sanity_valid": true,
          "schema_valid": true,
          "quality_model": {
            "name": "deterministic_first_data_quality_v1",
            "weights": {
              "deterministic": 0.8,
              "agent_friendly": 0.2
            }
          },
          "coverage_valid": true,
          "data_non_empty": true,
          "freshness_valid": true,
          "data_quality_issues": [],
          "deterministic_score": 1,
          "agent_friendly_score": 1,
          "overall_quality_score": 1
        }
      },
      "verification_report_hash": "0xd1b135ca339f1b85904ecce0deefd4a56c72991524cafa145d295232d67f454c"
    }
  ],
  "recent_quality_events": [
    {
      "status": "verified_result_recorded",
      "created_at": "2026-06-05T09:36:22.949Z",
      "event_hash": "0x7da962928f652f562ad713b4edd577d929475c86556a7f126168c441d4b3c8b8",
      "event_type": "completed_paid_invocation",
      "payment_tx": "0x60d15c4bc958a1c3465f5bf85d82a0ba81c152c6f3349cac86d4072c1fbe4f90",
      "request_id": "req_1780652177860",
      "service_id": "nansen_profiler_address_pnl",
      "trace_hash": "0xcea6107094000ba8b425d219b2aaa7b8ab221357ce4ec26b7529186ef96f91dd",
      "provider_id": "provider_nansen_api",
      "event_version": "agent_service_quality_event_v1",
      "blocking_issues": [],
      "quality_event_id": "0xc4869bb67f4512b833f58483b741cfdb468fc4bd2d61136f62d3234c0f2ad3e8",
      "consumer_feedback_expected": true,
      "deterministic_verification": {
        "issues": [],
        "data_shape": {
          "type": "object",
          "empty": false,
          "nested_arrays": [
            {
              "key": "data",
              "item_count": 6
            }
          ],
          "top_level_keys": [
            "pagination",
            "data"
          ]
        },
        "sanity_valid": true,
        "schema_valid": true,
        "quality_model": {
          "name": "deterministic_first_data_quality_v1",
          "weights": {
            "deterministic": 0.8,
            "agent_friendly": 0.2
          }
        },
        "coverage_valid": true,
        "data_non_empty": true,
        "freshness_valid": true,
        "data_quality_issues": [],
        "deterministic_score": 1,
        "agent_friendly_score": 1,
        "overall_quality_score": 1
      }
    }
  ],
  "recent_feedback_events": [
    {
      "status": "success",
      "created_at": "2026-06-05T09:36:20.735Z",
      "latency_ms": null,
      "payment_tx": "0x60d15c4bc958a1c3465f5bf85d82a0ba81c152c6f3349cac86d4072c1fbe4f90",
      "request_id": "req_1780652177860",
      "service_id": "nansen_profiler_address_pnl",
      "consumer_id": "local_agent_wallet",
      "provider_id": "provider_nansen_api",
      "schema_valid": true,
      "verification": {
        "issues": [],
        "data_shape": {
          "type": "object",
          "empty": false,
          "nested_arrays": [
            {
              "key": "data",
              "item_count": 6
            }
          ],
          "top_level_keys": [
            "pagination",
            "data"
          ]
        },
        "sanity_valid": true,
        "schema_valid": true,
        "quality_model": {
          "name": "deterministic_first_data_quality_v1",
          "weights": {
            "deterministic": 0.8,
            "agent_friendly": 0.2
          }
        },
        "coverage_valid": true,
        "data_non_empty": true,
        "freshness_valid": true,
        "data_quality_issues": [],
        "deterministic_score": 1,
        "agent_friendly_score": 1,
        "overall_quality_score": 1
      },
      "event_version": "agent_service_feedback_v1",
      "feedback_hash": "0x200f8b115b30d89a8a34b66e2ca346344d000b90775d5712e5febed3aaa5443f",
      "billing_status": "charged_success",
      "coverage_valid": true,
      "data_non_empty": true,
      "consumer_rating": 1,
      "freshness_valid": true,
      "payment_backend": "circle_arc",
      "payment_collected": true,
      "settlement_receipt": {
        "mode": "circle_arc",
        "asset": "USDC",
        "caip2": "eip155:5042002",
        "payer": "agentrouter_consumer",
        "amount": "0.01",
        "pay_to": "0x2c4d600a04c0d3bbb1e3cc8a13e54e21c2b6c0bb",
        "status": "settled",
        "network": "arc-testnet",
        "tx_hash": "0x60d15c4bc958a1c3465f5bf85d82a0ba81c152c6f3349cac86d4072c1fbe4f90",
        "chain_id": 5042002,
        "protocol": "x402",
        "created_at": "2026-06-05T09:36:20.487Z",
        "token_address": "0x3600000000000000000000000000000000000000",
        "payment_backend": "circle_arc",
        "receipt_version": "agent_router_settlement_receipt_v1",
        "settlement_model": "direct_provider_wallet"
      },
      "payment_verification": {
        "ok": true,
        "payer": "0xe3cbf7e987157348616024f9e9a438bab73a23e4",
        "pay_to": "0x2C4d600a04c0d3bbb1e3Cc8a13e54e21c2B6C0bB",
        "status": "verified_arc_usdc_transfer",
        "tx_hash": "0x60d15c4bc958a1c3465f5bf85d82a0ba81c152c6f3349cac86d4072c1fbe4f90",
        "chain_id": 5042002,
        "expected": {
          "payTo": "0x2c4d600a04c0d3bbb1e3cc8a13e54e21c2b6c0bb",
          "payer": "0xe3cbf7e987157348616024f9e9a438bab73a23e4",
          "amount": "0.01"
        },
        "block_number": "45613611",
        "explorer_url": "https://testnet.arcscan.app/tx/0x60d15c4bc958a1c3465f5bf85d82a0ba81c152c6f3349cac86d4072c1fbe4f90",
        "amount_atomic": "10000",
        "token_address": "0x3600000000000000000000000000000000000000"
      },
      "result_delivery_status": "delivered"
    }
  ],
  "recent_health_checks": []
}