Use this service when you need this capability: order and summarize supplied NFT transfers for one token or collection.
0.01 USDC per call
x402 V2 exact payment on Base mainnet (eip155:8453) using USDC. The HTTP 402 challenge confirms the exact requirements before an authorized payment.
POST https://signalharness.ai/api/agent/services/nft_transfer_history/invokeOrder and summarize supplied NFT transfers for one token or collection.
Caller-supplied data is processed deterministically. These tools do not supply live market feeds, query blockchain RPC, host AI models, or verify that supplied history is complete. Payment remains Base USDC for every chain category.
| Field | Type | Required | Limits |
|---|---|---|---|
| nft_history_request | string | Required | Minimum length 2; Maximum length 65536 |
{
"nft_history_request": "{\"transfers\":[{\"token_id\":\"1\",\"from\":\"0x0000000000000000000000000000000000000001\",\"to\":\"0x0000000000000000000000000000000000000002\",\"timestamp\":1700000000000,\"transaction_hash\":\"0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\"log_index\":0}]}"
}{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"additionalProperties": false,
"minProperties": 1,
"maxProperties": 1,
"required": [
"nft_history_request"
],
"properties": {
"nft_history_request": {
"type": "string",
"minLength": 2,
"maxLength": 65536
}
}
}Illustrative output from the canonical adapter fixture and schema. It is not a completed paid execution or a current live observation.
{
"service_id": "nft_transfer_history",
"evidence_scope": "caller_supplied_data",
"nft_transfer_history": "{\"first_timestamp_ms\":1700000000000,\"last_timestamp_ms\":1700000000000,\"transfer_count\":1,\"transfers\":[{\"from\":\"0x0000000000000000000000000000000000000001\",\"log_index\":0,\"timestamp_ms\":1700000000000,\"to\":\"0x0000000000000000000000000000000000000002\",\"token_id\":\"1\",\"transaction_hash\":\"0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\"}]}",
"warnings": [
"History completeness depends on supplied records."
]
}{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"type": "object",
"additionalProperties": false,
"minProperties": 4,
"maxProperties": 4,
"required": [
"service_id",
"evidence_scope",
"nft_transfer_history",
"warnings"
],
"properties": {
"service_id": {
"type": "string",
"const": "nft_transfer_history",
"minLength": 20,
"maxLength": 20
},
"evidence_scope": {
"type": "string",
"const": "caller_supplied_data",
"minLength": 20,
"maxLength": 20
},
"nft_transfer_history": {
"type": "string",
"minLength": 1,
"maxLength": 65536
},
"warnings": {
"type": "array",
"minItems": 1,
"maxItems": 8,
"items": {
"type": "string",
"minLength": 1,
"maxLength": 512
}
}
}
}Timeout: 5000 ms. Full schemas are in OpenAPI.
This schema-valid request returns the canonical HTTP 402 challenge without executing the service. A payment-capable client validates the challenge, signs only with prior authority and budget, and retries the identical body.
curl -i -X POST https://signalharness.ai/api/agent/services/nft_transfer_history/invoke \
-H "Content-Type: application/json" \
--data '{"nft_history_request":"{\"transfers\":[{\"token_id\":\"1\",\"from\":\"0x0000000000000000000000000000000000000001\",\"to\":\"0x0000000000000000000000000000000000000002\",\"timestamp\":1700000000000,\"transaction_hash\":\"0xaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa\",\"log_index\":0}]}"}'