> For the complete documentation index, see [llms.txt](https://docs.nansen.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nansen.ai/api/backtesting-data/historical-address-transactions.md).

# Historical Address Transactions

## Get Historical Transactions for an Address (Beta)

> \*\*Beta — subject to breaking changes.\*\*\
> \
> Returns the 20 most recent token transfer transactions for a wallet address as\
> of a historical snapshot date, with temporally-correct counterparty labels.\
> \
> \*\*Key differences from \`/profiler/address/transactions\`:\*\*\
> \- Accepts an explicit \`as\_of\_date\` (no rolling default)\
> \- Counterparty labels resolved from label history at \`as\_of\_date\` (no forward-looking bias)\
> \- Limited to ethereum, base, bnb, and solana\
> \- Capped at 20 results per query

```json
{"openapi":"3.1.0","info":{"title":"Nansen API","version":"1.0.0"},"servers":[{"url":"https://api.nansen.ai"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"apiKey","description":"API key for authentication"}},"schemas":{"ProfilerAddressHistoricalTransactionsRequest":{"properties":{"address":{"type":"string","title":"Address","description":"Wallet address (EVM hex or Solana base58)"},"chain":{"$ref":"#/components/schemas/ProfilerHistoricalTokenBalancesChain","description":"Blockchain chain"},"as_of_date":{"type":"string","format":"date","title":"As Of Date","description":"Historical snapshot date — only transactions on or before this date are returned, with labels resolved as of this date."},"hide_spam_token":{"type":"boolean","title":"Hide Spam Token","description":"Filter out tokens flagged as spam by Nansen","default":true},"pagination":{"$ref":"#/components/schemas/PaginationRequest","description":"Pagination parameters. The endpoint returns at most 20 rows, so pagination beyond that yields empty results."},"apply_blacklist_filter":{"type":"boolean","title":"Apply Blacklist Filter","description":"When True, exclude blacklisted addresses from the results. Defaults to True.","default":true}},"additionalProperties":false,"type":"object","required":["address","chain","as_of_date"],"title":"ProfilerAddressHistoricalTransactionsRequest","description":"Request model for the profiler historical address transactions endpoint.\n\nReturns the 20 most recent token transfer transactions for a wallet address\nas of a given historical date, with temporally-correct counterparty labels."},"ProfilerHistoricalTokenBalancesChain":{"type":"string","enum":["all","base","bnb","ethereum","mantra","solana"],"title":"ProfilerHistoricalTokenBalancesChain","description":"Chains supported for Profiler Historical Token Balances endpoint."},"PaginationRequest":{"properties":{"page":{"type":"integer","minimum":1,"title":"Page","description":"Page number (1-based)","default":1},"per_page":{"type":"integer","maximum":1000,"minimum":1,"title":"Per Page","description":"Number of records per page (max 1000)","default":10}},"type":"object","title":"PaginationRequest","description":"Pagination parameters for API requests."},"ProfilerAddressHistoricalTransactionsResponse":{"properties":{"pagination":{"$ref":"#/components/schemas/PaginationInfo","description":"Pagination information"},"data":{"items":{"$ref":"#/components/schemas/ProfilerAddressHistoricalTransactionsItem"},"type":"array","title":"Data","description":"List of historical transaction records ordered by block_timestamp DESC."}},"type":"object","required":["pagination","data"],"title":"ProfilerAddressHistoricalTransactionsResponse","description":"Response model for the profiler historical address transactions endpoint."},"PaginationInfo":{"properties":{"page":{"type":"integer","minimum":1,"title":"Page","description":"Current page number","default":1},"per_page":{"type":"integer","maximum":1000,"minimum":1,"title":"Per Page","description":"Number of records per page","default":10},"is_last_page":{"type":"boolean","title":"Is Last Page","description":"Whether this is the last page","default":true}},"type":"object","title":"PaginationInfo","description":"Pagination information for API responses."},"ProfilerAddressHistoricalTransactionsItem":{"properties":{"source_type":{"type":"string","title":"Source Type","description":"Always 'transfer'. Mirrors the production schema."},"method":{"type":"string","title":"Method","description":"Transaction method name. Falls back to 'received'/'sent' for single-transfer transactions."},"transaction_hash":{"type":"string","title":"Transaction Hash","description":"Transaction hash in human-readable format (0x-prefixed hex on EVM, base58 on Solana)"},"tokens_received":{"anyOf":[{"items":{},"type":"array"}],"title":"Tokens Received","description":"Array of token transfers received in this transaction. Each entry is a tuple of (token_symbol, token_amount, token_price_usd, token_value_usd, token_address, chain, from_address, to_address, from_address_label, to_address_label). Labels are resolved as of as_of_date."},"tokens_sent":{"anyOf":[{"items":{},"type":"array"}],"title":"Tokens Sent","description":"Array of token transfers sent in this transaction. Same tuple shape as tokens_received with negative amounts."},"volume_usd":{"anyOf":[{"type":"number"}],"title":"Volume Usd","description":"Transaction volume in USD computed from historical prices."},"block_timestamp":{"type":"string","title":"Block Timestamp","description":"Block timestamp of the transaction (ISO format)."},"chain":{"type":"string","title":"Chain","description":"Blockchain identifier for this row."}},"type":"object","required":["source_type","method","transaction_hash","block_timestamp","chain"],"title":"ProfilerAddressHistoricalTransactionsItem","description":"Single historical transaction record for a wallet address.\n\nEach row is one transaction (grouped by transaction_hash) containing arrays\nof received and sent token transfers with temporally-correct counterparty\nlabels resolved as of `as_of_date`."}},"headers":{"XNansenCreditsUsed":{"description":"Number of credits consumed by this API request","schema":{"type":"string"}},"XNansenCreditsRemaining":{"description":"Total credits remaining in the user's account after this request","schema":{"type":"string"}},"PaymentReceipt":{"description":"Base64url-encoded MPP receipt returned on successful paid requests via Authorization: Payment","schema":{"type":"string"}},"RateLimitLimit":{"description":"Combined rate limit across all configured time windows","schema":{"type":"string"}},"RateLimitRemaining":{"description":"Number of requests remaining in the current limiting window","schema":{"type":"string"}},"RateLimitReset":{"description":"Time in seconds until the rate limit window resets","schema":{"type":"string"}},"XRateLimitLimitSecond":{"description":"Maximum requests allowed per second","schema":{"type":"string"}},"XRateLimitRemainingSecond":{"description":"Requests remaining in the current second","schema":{"type":"string"}},"XRateLimitLimitMinute":{"description":"Maximum requests allowed per minute","schema":{"type":"string"}},"XRateLimitRemainingMinute":{"description":"Requests remaining in the current minute","schema":{"type":"string"}},"PaymentRequired":{"description":"Base64-encoded x402 payment options returned on 402 responses for x402 clients","schema":{"type":"string"}},"WWWAuthenticatePayment":{"description":"MPP payment challenge returned on 402 responses, for example `Payment id=\"...\", realm=\"api.nansen.ai\", method=\"tempo\", intent=\"charge\", request=\"...\"`","schema":{"type":"string"}},"RetryAfter":{"description":"Number of seconds to wait before making a new request","schema":{"type":"string"}}},"responses":{"BadRequestError":{"description":"Bad Request - Invalid request parameters or malformed request","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"UnauthorizedError":{"description":"Authentication error - No API key found in request","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"PaymentRequiredError":{"description":"Payment Required - This endpoint supports pay-per-request via x402 and MPP. x402 responses advertise payment options in `Payment-Required`; MPP responses advertise a fresh `WWW-Authenticate: Payment ...` challenge. Successful MPP responses may include `Payment-Receipt`.","headers":{"Payment-Required":{"$ref":"#/components/headers/PaymentRequired"},"WWW-Authenticate":{"$ref":"#/components/headers/WWWAuthenticatePayment"}},"content":{"application/json":{"schema":{"type":"object","description":"Problem-details body for x402 or MPP payment challenges."}}}},"ForbiddenError":{"description":"Forbidden - User does not have required subscription tier or has exceeded credit limit","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"NotFoundError":{"description":"Not Found - The requested resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"ValidationError":{"description":"Validation error - Invalid request parameters","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"array","items":{"type":"object","properties":{"loc":{"type":"array","items":{"type":"string"}},"msg":{"type":"string"},"type":{"type":"string"}}}}}}}}},"TooManyRequestsError":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"},"retry_after":{"type":"integer","description":"Seconds to wait before retrying"}}}}},"headers":{"Retry-After":{"$ref":"#/components/headers/RetryAfter"}}},"InternalServerError":{"description":"Internal Server Error - An unexpected error occurred","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}},"paths":{"/api/v1beta1/profiler/address/historical-transactions":{"post":{"tags":["Profiler"],"summary":"Get Historical Transactions for an Address (Beta)","description":"**Beta — subject to breaking changes.**\n\nReturns the 20 most recent token transfer transactions for a wallet address as\nof a historical snapshot date, with temporally-correct counterparty labels.\n\n**Key differences from `/profiler/address/transactions`:**\n- Accepts an explicit `as_of_date` (no rolling default)\n- Counterparty labels resolved from label history at `as_of_date` (no forward-looking bias)\n- Limited to ethereum, base, bnb, and solana\n- Capped at 20 results per query","operationId":"get_profiler_address_historical_transactions_beta_api_v1beta1_profiler_address_historical_transactions_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfilerAddressHistoricalTransactionsRequest"}}},"required":true},"responses":{"200":{"description":"Historical address transaction data","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfilerAddressHistoricalTransactionsResponse"}}},"headers":{"X-Nansen-Credits-Used":{"$ref":"#/components/headers/XNansenCreditsUsed"},"X-Nansen-Credits-Remaining":{"$ref":"#/components/headers/XNansenCreditsRemaining"},"Payment-Receipt":{"$ref":"#/components/headers/PaymentReceipt"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RateLimit-Limit-Second":{"$ref":"#/components/headers/XRateLimitLimitSecond"},"X-RateLimit-Remaining-Second":{"$ref":"#/components/headers/XRateLimitRemainingSecond"},"X-RateLimit-Limit-Minute":{"$ref":"#/components/headers/XRateLimitLimitMinute"},"X-RateLimit-Remaining-Minute":{"$ref":"#/components/headers/XRateLimitRemainingMinute"}}},"400":{"description":"Bad Request","$ref":"#/components/responses/BadRequestError"},"401":{"description":"Unauthorized","$ref":"#/components/responses/UnauthorizedError"},"402":{"description":"Payment Required","$ref":"#/components/responses/PaymentRequiredError"},"403":{"description":"Forbidden","$ref":"#/components/responses/ForbiddenError"},"404":{"description":"Not Found","$ref":"#/components/responses/NotFoundError"},"422":{"description":"Unprocessable Content","$ref":"#/components/responses/ValidationError"},"429":{"description":"Too Many Requests","$ref":"#/components/responses/TooManyRequestsError"},"500":{"description":"Internal Server Error","$ref":"#/components/responses/InternalServerError"}}}}}}
```

## Get Historical (Time-Travel) Transaction Lookup Data (Beta)

> \*\*Beta — subject to breaking changes.\*\*\
> \
> Time-travel-aware variant of \`/transaction-with-token-transfer-lookup\`.\
> \
> Returns transaction details (sender/receiver, native value, token transfers)\
> with \*\*temporally-correct labels\*\* and \*\*dual pricing\*\* (dated price at the\
> transaction's block\_timestamp + as-of-date price). Labels are resolved at\
> \`as\_of\_date\` to avoid forward-looking bias; entity labels are available from\
> 2025-03-11 onward.\
> \
> \*\*Performance\*\*\
> \
> This endpoint executes two queries sequentially:\
> \
> 1\. \*\*Hash -> timestamp resolution\*\* — can take \*\*60-170 seconds\*\* for unknown\
>    hashes. Pass \`block\_timestamp\` in the request to skip this step entirely.\
> 2\. \*\*Data lookup\*\* — <1 second once the timestamp is known.

```json
{"openapi":"3.1.0","info":{"title":"Nansen API","version":"1.0.0"},"servers":[{"url":"https://api.nansen.ai"}],"security":[{"ApiKeyAuth":[]}],"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"apiKey","description":"API key for authentication"}},"schemas":{"ProfilerHistoricalTransactionLookupRequest":{"properties":{"chain":{"$ref":"#/components/schemas/ProfilerHistoricalTransactionLookupChain","description":"Blockchain chain for the historical transaction lookup"},"transaction_hash":{"type":"string","title":"Transaction Hash","description":"Transaction hash to lookup (0x-prefixed, 66 chars)"},"as_of_date":{"type":"string","format":"date","title":"As Of Date","description":"Reference date for temporal label resolution and as-of-date pricing. Must be on/after the transaction's block_timestamp. Entity labels are available from 2025-03-11 onward."},"block_timestamp":{"anyOf":[{"type":"string"}],"title":"Block Timestamp","description":"Optional block timestamp in 'YYYY-MM-DD HH:MM:SS' format. When provided, skips the slow (60-170s) hash-to-timestamp resolution step. Strongly recommended."},"apply_blacklist_filter":{"type":"boolean","title":"Apply Blacklist Filter","description":"When True, exclude blacklisted addresses from the results. Defaults to True.","default":true}},"additionalProperties":false,"type":"object","required":["chain","transaction_hash","as_of_date"],"title":"ProfilerHistoricalTransactionLookupRequest","description":"Request model for the profiler historical transaction lookup endpoint."},"ProfilerHistoricalTransactionLookupChain":{"type":"string","enum":["base","bnb","ethereum"],"title":"ProfilerHistoricalTransactionLookupChain","description":"Chains supported by the historical transaction lookup endpoint."},"ProfilerHistoricalTransactionLookupListResponse":{"properties":{"data":{"items":{"$ref":"#/components/schemas/ProfilerHistoricalTransactionLookupResponse"},"type":"array","title":"Data","description":"List of historical transaction lookup results"}},"type":"object","required":["data"],"title":"ProfilerHistoricalTransactionLookupListResponse","description":"Wrapper response for the profiler historical transaction lookup endpoint."},"ProfilerHistoricalTransactionLookupResponse":{"properties":{"chain":{"type":"string","title":"Chain","description":"The blockchain network of the transaction"},"transaction_hash":{"type":"string","title":"Transaction Hash","description":"The unique identifier of the transaction"},"from_address":{"type":"string","title":"From Address","description":"The hexadecimal address of the sender"},"from_address_label":{"anyOf":[{"type":"string"}],"title":"From Address Label","description":"Temporally-correct label of the sender at as_of_date"},"to_address":{"type":"string","title":"To Address","description":"The hexadecimal address of the recipient"},"to_address_label":{"anyOf":[{"type":"string"}],"title":"To Address Label","description":"Temporally-correct label of the recipient at as_of_date"},"native_value":{"anyOf":[{"type":"number"}],"title":"Native Value","description":"The amount of native cryptocurrency transferred"},"dated_native_price":{"anyOf":[{"type":"number"}],"title":"Dated Native Price","description":"Native cryptocurrency price at the transaction's block_timestamp date"},"dated_native_value_usd":{"anyOf":[{"type":"number"}],"title":"Dated Native Value Usd","description":"USD value of native transfer at the transaction's block_timestamp date"},"as_of_date_native_price":{"anyOf":[{"type":"number"}],"title":"As Of Date Native Price","description":"Native cryptocurrency price at as_of_date"},"as_of_date_native_value_usd":{"anyOf":[{"type":"number"}],"title":"As Of Date Native Value Usd","description":"USD value of native transfer at as_of_date"},"receipt_status":{"anyOf":[{"type":"integer"}],"title":"Receipt Status","description":"Transaction receipt status (1 for success, 0 for failure)"},"block_timestamp":{"type":"string","title":"Block Timestamp","description":"The timestamp of the block containing the transaction"},"as_of_date":{"type":"string","title":"As Of Date","description":"The reference date used for label and pricing resolution"},"method":{"anyOf":[{"type":"string"}],"title":"Method","description":"Human-readable method signature resolved from the transaction's sig_hash. Empty string when no match is found."},"token_transfer_array":{"anyOf":[{"items":{"$ref":"#/components/schemas/HistoricalTokenTransfer"},"type":"array"}],"title":"Token Transfer Array","description":"Token transfers in this transaction (temporally-correct labels)"}},"type":"object","required":["chain","transaction_hash","from_address","from_address_label","to_address","to_address_label","native_value","dated_native_price","dated_native_value_usd","as_of_date_native_price","as_of_date_native_value_usd","receipt_status","block_timestamp","as_of_date","method","token_transfer_array"],"title":"ProfilerHistoricalTransactionLookupResponse","description":"Response row for the profiler historical transaction lookup endpoint.\n\nMirrors the /transaction-with-token-transfer-lookup response where\noverlapping. Differences:\n- Uses ``as_of_date_native_*`` instead of ``current_native_*`` (temporal pricing).\n- Adds ``method`` (resolved from sig_hash) and ``as_of_date`` fields.\n- No ``nft_transfer_array``."},"HistoricalTokenTransfer":{"properties":{"from_address":{"type":"string","title":"From Address","description":"Sender address (0x-prefixed lowercase hex)"},"from_address_label":{"type":"string","title":"From Address Label","description":"Temporally-correct label of the sender at as_of_date"},"to_address":{"type":"string","title":"To Address","description":"Receiver address (0x-prefixed lowercase hex)"},"to_address_label":{"type":"string","title":"To Address Label","description":"Temporally-correct label of the receiver at as_of_date"},"token_address":{"type":"string","title":"Token Address","description":"Token contract address"},"token_symbol":{"type":"string","title":"Token Symbol","description":"Token symbol"},"token_amount":{"anyOf":[{"type":"number"}],"title":"Token Amount","description":"Token amount transferred (decimal-adjusted)"},"dated_price_usd":{"anyOf":[{"type":"number"}],"title":"Dated Price Usd","description":"Token price in USD at the transaction's block_timestamp date"},"dated_value_usd":{"anyOf":[{"type":"number"}],"title":"Dated Value Usd","description":"USD value of the transfer at the transaction's block_timestamp date"},"as_of_date_price_usd":{"anyOf":[{"type":"number"}],"title":"As Of Date Price Usd","description":"Token price in USD at as_of_date"},"as_of_date_value_usd":{"anyOf":[{"type":"number"}],"title":"As Of Date Value Usd","description":"USD value of the transfer at as_of_date"},"transfer_id":{"type":"string","title":"Transfer Id","description":"Transfer ID (token-transfer-* or trace-*)"}},"type":"object","required":["from_address","from_address_label","to_address","to_address_label","token_address","token_symbol","token_amount","dated_price_usd","dated_value_usd","as_of_date_price_usd","as_of_date_value_usd","transfer_id"],"title":"HistoricalTokenTransfer","description":"Single token transfer with temporally-correct labels and dual pricing."}},"headers":{"XNansenCreditsUsed":{"description":"Number of credits consumed by this API request","schema":{"type":"string"}},"XNansenCreditsRemaining":{"description":"Total credits remaining in the user's account after this request","schema":{"type":"string"}},"PaymentReceipt":{"description":"Base64url-encoded MPP receipt returned on successful paid requests via Authorization: Payment","schema":{"type":"string"}},"RateLimitLimit":{"description":"Combined rate limit across all configured time windows","schema":{"type":"string"}},"RateLimitRemaining":{"description":"Number of requests remaining in the current limiting window","schema":{"type":"string"}},"RateLimitReset":{"description":"Time in seconds until the rate limit window resets","schema":{"type":"string"}},"XRateLimitLimitSecond":{"description":"Maximum requests allowed per second","schema":{"type":"string"}},"XRateLimitRemainingSecond":{"description":"Requests remaining in the current second","schema":{"type":"string"}},"XRateLimitLimitMinute":{"description":"Maximum requests allowed per minute","schema":{"type":"string"}},"XRateLimitRemainingMinute":{"description":"Requests remaining in the current minute","schema":{"type":"string"}},"PaymentRequired":{"description":"Base64-encoded x402 payment options returned on 402 responses for x402 clients","schema":{"type":"string"}},"WWWAuthenticatePayment":{"description":"MPP payment challenge returned on 402 responses, for example `Payment id=\"...\", realm=\"api.nansen.ai\", method=\"tempo\", intent=\"charge\", request=\"...\"`","schema":{"type":"string"}},"RetryAfter":{"description":"Number of seconds to wait before making a new request","schema":{"type":"string"}}},"responses":{"BadRequestError":{"description":"Bad Request - Invalid request parameters or malformed request","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"UnauthorizedError":{"description":"Authentication error - No API key found in request","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"PaymentRequiredError":{"description":"Payment Required - This endpoint supports pay-per-request via x402 and MPP. x402 responses advertise payment options in `Payment-Required`; MPP responses advertise a fresh `WWW-Authenticate: Payment ...` challenge. Successful MPP responses may include `Payment-Receipt`.","headers":{"Payment-Required":{"$ref":"#/components/headers/PaymentRequired"},"WWW-Authenticate":{"$ref":"#/components/headers/WWWAuthenticatePayment"}},"content":{"application/json":{"schema":{"type":"object","description":"Problem-details body for x402 or MPP payment challenges."}}}},"ForbiddenError":{"description":"Forbidden - User does not have required subscription tier or has exceeded credit limit","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"NotFoundError":{"description":"Not Found - The requested resource was not found","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}},"ValidationError":{"description":"Validation error - Invalid request parameters","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"array","items":{"type":"object","properties":{"loc":{"type":"array","items":{"type":"string"}},"msg":{"type":"string"},"type":{"type":"string"}}}}}}}}},"TooManyRequestsError":{"description":"Too Many Requests - Rate limit exceeded","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"},"retry_after":{"type":"integer","description":"Seconds to wait before retrying"}}}}},"headers":{"Retry-After":{"$ref":"#/components/headers/RetryAfter"}}},"InternalServerError":{"description":"Internal Server Error - An unexpected error occurred","content":{"application/json":{"schema":{"type":"object","properties":{"detail":{"type":"string"}}}}}}}},"paths":{"/api/v1beta1/profiler/historical-transaction-lookup":{"post":{"tags":["Profiler"],"summary":"Get Historical (Time-Travel) Transaction Lookup Data (Beta)","description":"**Beta — subject to breaking changes.**\n\nTime-travel-aware variant of `/transaction-with-token-transfer-lookup`.\n\nReturns transaction details (sender/receiver, native value, token transfers)\nwith **temporally-correct labels** and **dual pricing** (dated price at the\ntransaction's block_timestamp + as-of-date price). Labels are resolved at\n`as_of_date` to avoid forward-looking bias; entity labels are available from\n2025-03-11 onward.\n\n**Performance**\n\nThis endpoint executes two queries sequentially:\n\n1. **Hash -> timestamp resolution** — can take **60-170 seconds** for unknown\n   hashes. Pass `block_timestamp` in the request to skip this step entirely.\n2. **Data lookup** — <1 second once the timestamp is known.","operationId":"get_profiler_historical_transaction_lookup_beta_api_v1beta1_profiler_historical_transaction_lookup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfilerHistoricalTransactionLookupRequest"}}},"required":true},"responses":{"200":{"description":"Historical transaction lookup data with temporally-correct labels and dual pricing","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProfilerHistoricalTransactionLookupListResponse"}}},"headers":{"X-Nansen-Credits-Used":{"$ref":"#/components/headers/XNansenCreditsUsed"},"X-Nansen-Credits-Remaining":{"$ref":"#/components/headers/XNansenCreditsRemaining"},"Payment-Receipt":{"$ref":"#/components/headers/PaymentReceipt"},"RateLimit-Limit":{"$ref":"#/components/headers/RateLimitLimit"},"RateLimit-Remaining":{"$ref":"#/components/headers/RateLimitRemaining"},"RateLimit-Reset":{"$ref":"#/components/headers/RateLimitReset"},"X-RateLimit-Limit-Second":{"$ref":"#/components/headers/XRateLimitLimitSecond"},"X-RateLimit-Remaining-Second":{"$ref":"#/components/headers/XRateLimitRemainingSecond"},"X-RateLimit-Limit-Minute":{"$ref":"#/components/headers/XRateLimitLimitMinute"},"X-RateLimit-Remaining-Minute":{"$ref":"#/components/headers/XRateLimitRemainingMinute"}}},"400":{"description":"Bad Request","$ref":"#/components/responses/BadRequestError"},"401":{"description":"Unauthorized","$ref":"#/components/responses/UnauthorizedError"},"402":{"description":"Payment Required","$ref":"#/components/responses/PaymentRequiredError"},"403":{"description":"Forbidden","$ref":"#/components/responses/ForbiddenError"},"404":{"description":"Not Found","$ref":"#/components/responses/NotFoundError"},"422":{"description":"Unprocessable Content","$ref":"#/components/responses/ValidationError"},"429":{"description":"Too Many Requests","$ref":"#/components/responses/TooManyRequestsError"},"500":{"description":"Internal Server Error","$ref":"#/components/responses/InternalServerError"}}}}}}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nansen.ai/api/backtesting-data/historical-address-transactions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.