{"openapi":"3.1.0","info":{"title":"Splash API","version":"0.1.0","description":"Public wallet balances, supported DeFi positions and portfolio totals in USD. Start with /v1/explorer/addresses/{address}. No API key required; AccessKey is optional. Native summary totals and raw wallet quantities are decimal strings. A null total means incomplete data; knownValueUsd retains the known subtotal. Portfolio and token routes return unwrapped numeric JSON. Use your HTTP client's compression support for Brotli or gzip responses. Check HTTP status before parsing JSON: transport errors may return an empty 406 (no acceptable encoding) or 503 (retry later); follow Retry-After when present. Use /v1/chain/list and /v1/protocol/all_list for discovery; see /api for examples and supported position types."},"servers":[{"url":"https://splash.dudidum.com"}],"security":[],"paths":{"/v1/addresses/{address}":{"get":{"operationId":"lookupAddress","summary":"Get an address's HyperCore portfolio and activity","description":"Hyperliquid portfolio and checked recent activity, including up to 5 accounts and 32 perpetual markets. Agent addresses resolve to the trading account. Successful results may be reused for 30 seconds. Use includeSubaccounts=false for a single trading account. This is not lifetime history; inspect coverage for incomplete checks. The path accepts .eth/.hl names; resolved targets remain hex addresses in all existing financial fields. Named responses add identity metadata. Failed name resolution never queries a portfolio.","parameters":[{"name":"address","in":"path","required":true,"schema":{"$ref":"#/components/schemas/LookupIdentifier"},"example":"0xd3cdb511c245a01e820aae6bf4bdd5359b2ccc68"},{"name":"includeSubaccounts","in":"query","description":"Include discovered subaccounts","schema":{"type":"boolean","default":true}}],"responses":{"200":{"description":"Lookup, possibly with partial coverage or source failures","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Lookup"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"description":"Name has no resolved EVM address"},"405":{"$ref":"#/components/responses/MethodNotAllowed"},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"500":{"description":"Unexpected server failure","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Capacity exceeded, or all source queries failed","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/Error"},{"$ref":"#/components/schemas/Lookup"}]}}}}}}},"/health":{"get":{"operationId":"getHealth","summary":"Check Splash availability, not individual data sources","responses":{"200":{"description":"Service is running","content":{"application/json":{"schema":{"type":"object","required":["status","service"],"properties":{"status":{"const":"ok"},"service":{"const":"hyperliquid-lookup"},"samples":{"type":"object","description":"Optional readiness counters for the three homepage sample wallets; no portfolio values.","properties":{"wallets":{"const":3},"cached":{"type":"integer","minimum":0,"maximum":3},"fresh":{"type":"integer","minimum":0,"maximum":3},"persistence":{"enum":["off","pending","ready","unavailable"]}}},"refresh":{"type":"object","description":"Optional refresh readiness and progress counters. Contains no wallet values or identifiers.","properties":{"enabled":{"type":"boolean"},"active":{"type":"integer"},"draining":{"type":"integer"},"concurrency":{"type":"integer","minimum":1,"maximum":2},"pending":{"type":"integer"},"oldestDueSeconds":{"type":"integer"},"cooldownSeconds":{"type":"integer"}}}}}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}}}}},"/v1/chain":{"get":{"operationId":"compat_chain","tags":["Portfolio and tokens"],"summary":"GET /v1/chain","description":"Supported chain-specific protocols and positions. Use /api#coverage for available protocol IDs and position types. Prediction claims use Investment items with empty detail_types; read stats for their value. Covered source failures return 503. Unknown prices use zero with X-Splash-Valuation: partial-priced-subtotal. TVL is omitted when unavailable.","security":[],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"supported-protocols","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatChain"}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/chain/list":{"get":{"operationId":"compat_chain_list","tags":["Portfolio and tokens"],"summary":"GET /v1/chain/list","description":"Supported chain-specific protocols and positions. Use /api#coverage for available protocol IDs and position types. Prediction claims use Investment items with empty detail_types; read stats for their value. Covered source failures return 503. Unknown prices use zero with X-Splash-Valuation: partial-priced-subtotal. TVL is omitted when unavailable.","security":[],"parameters":[{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"supported-protocols","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true}}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/protocol":{"get":{"operationId":"compat_protocol","tags":["Portfolio and tokens"],"summary":"GET /v1/protocol","description":"Supported chain-specific protocols and positions. Use /api#coverage for available protocol IDs and position types. Prediction claims use Investment items with empty detail_types; read stats for their value. Covered source failures return 503. Unknown prices use zero with X-Splash-Valuation: partial-priced-subtotal. TVL is omitted when unavailable.","security":[],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"supported-protocols","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatProtocol"}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/protocol/list":{"get":{"operationId":"compat_protocol_list","tags":["Portfolio and tokens"],"summary":"GET /v1/protocol/list","description":"Supported chain-specific protocols and positions. Use /api#coverage for available protocol IDs and position types. Prediction claims use Investment items with empty detail_types; read stats for their value. Covered source failures return 503. Unknown prices use zero with X-Splash-Valuation: partial-priced-subtotal. TVL is omitted when unavailable.","security":[],"parameters":[{"name":"chain_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"supported-protocols","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true}}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/protocol/all_list":{"get":{"operationId":"compat_protocol_all_list","tags":["Portfolio and tokens"],"summary":"GET /v1/protocol/all_list","description":"Supported chain-specific protocols and positions. Use /api#coverage for available protocol IDs and position types. Prediction claims use Investment items with empty detail_types; read stats for their value. Covered source failures return 503. Unknown prices use zero with X-Splash-Valuation: partial-priced-subtotal. TVL is omitted when unavailable.","security":[],"parameters":[{"name":"chain_ids","in":"query","required":false,"schema":{"type":"string"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"supported-protocols","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true}}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/app_protocol/list":{"get":{"operationId":"compat_app_protocol_list","tags":["Portfolio and tokens"],"summary":"GET /v1/app_protocol/list","description":"HyperCore app coverage only. No invented EVM-chain assets. Monetary values are JSON numbers.","security":[],"parameters":[{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"hypercore-only","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CompatApp"}}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/pool":{"get":{"operationId":"compat_pool","tags":["Portfolio and tokens"],"summary":"GET /v1/pool","description":"Unsupported data returns an empty response of the documented shape, not evidence of an empty wallet. Transaction pre-execution returns success=false.","security":[],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"chain_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"empty-unsupported","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatPool"}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/token":{"get":{"operationId":"compat_token","tags":["Portfolio and tokens"],"summary":"GET /v1/token","description":"Native assets, curated ERC20s and bounded indexed token discovery on the chains listed in /api#coverage. Token lists default is_all=true; false returns core tokens only. Not exhaustive. Lending receipt tokens and flagged spam excluded from lists; native ERC20 aliases counted once. Explicit single-token queries retain a flagged token quantity but no trusted price. Missing prices remain zero with partial-priced-subtotal header. Source failures return 503. Numeric raw_amount may exceed JavaScript safe integer precision; exact amounts are in the native portfolio API.","security":[],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"chain_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"curated-wallet","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatToken"}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/token/list_by_ids":{"get":{"operationId":"compat_token_list_by_ids","tags":["Portfolio and tokens"],"summary":"GET /v1/token/list_by_ids","description":"Native assets, curated ERC20s and bounded indexed token discovery on the chains listed in /api#coverage. Token lists default is_all=true; false returns core tokens only. Not exhaustive. Lending receipt tokens and flagged spam excluded from lists; native ERC20 aliases counted once. Explicit single-token queries retain a flagged token quantity but no trusted price. Missing prices remain zero with partial-priced-subtotal header. Source failures return 503. Numeric raw_amount may exceed JavaScript safe integer precision; exact amounts are in the native portfolio API.","security":[],"parameters":[{"name":"ids","in":"query","required":true,"schema":{"type":"string"},"description":"Comma-separated token IDs, at most 100."},{"name":"chain_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"curated-wallet","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true}}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/token/top_holders":{"get":{"operationId":"compat_token_top_holders","tags":["Portfolio and tokens"],"summary":"GET /v1/token/top_holders","description":"Unsupported data returns an empty response of the documented shape, not evidence of an empty wallet. Transaction pre-execution returns success=false.","security":[],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"chain_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"start","in":"query","required":false,"schema":{"type":"integer"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"empty-unsupported","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true}}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/token/history_price":{"get":{"operationId":"compat_token_history_price","tags":["Portfolio and tokens"],"summary":"GET /v1/token/history_price","description":"Unsupported data returns an empty response of the documented shape, not evidence of an empty wallet. Transaction pre-execution returns success=false.","security":[],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"chain_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"date_at","in":"query","required":true,"schema":{"type":"string"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"empty-unsupported","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"price":{"type":"number"}},"required":["price"]}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/user/used_chain_list":{"get":{"operationId":"compat_user_used_chain_list","tags":["Portfolio and tokens"],"summary":"GET /v1/user/used_chain_list","description":"Net supported protocol positions plus curated wallets, after exact receipt-token reconciliation. total_balance additionally includes HyperCore equity. Version-scoped and non-exhaustive; see /api#coverage. Source failures and receipt quantity conflicts return 503. Unknown valuations retain known numeric subtotals with partial-priced-subtotal.","security":[],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"protocols-and-curated-wallet","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true}}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/user/chain_balance":{"get":{"operationId":"compat_user_chain_balance","tags":["Portfolio and tokens"],"summary":"GET /v1/user/chain_balance","description":"Net supported protocol positions plus curated wallets, after exact receipt-token reconciliation. total_balance additionally includes HyperCore equity. Version-scoped and non-exhaustive; see /api#coverage. Source failures and receipt quantity conflicts return 503. Unknown valuations retain known numeric subtotals with partial-priced-subtotal.","security":[],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"chain_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"protocols-and-curated-wallet","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"usd_value":{"type":"number"}},"required":["usd_value"]}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/user/protocol":{"get":{"operationId":"compat_user_protocol","tags":["Portfolio and tokens"],"summary":"GET /v1/user/protocol","description":"Supported chain-specific protocols and positions. Use /api#coverage for available protocol IDs and position types. Prediction claims use Investment items with empty detail_types; read stats for their value. Covered source failures return 503. Unknown prices use zero with X-Splash-Valuation: partial-priced-subtotal. TVL is omitted when unavailable.","security":[],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"protocol_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"supported-protocols","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatUserProtocol"}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/user/complex_protocol_list":{"get":{"operationId":"compat_user_complex_protocol_list","tags":["Portfolio and tokens"],"summary":"GET /v1/user/complex_protocol_list","description":"Supported chain-specific protocols and positions. Use /api#coverage for available protocol IDs and position types. Prediction claims use Investment items with empty detail_types; read stats for their value. Covered source failures return 503. Unknown prices use zero with X-Splash-Valuation: partial-priced-subtotal. TVL is omitted when unavailable.","security":[],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"chain_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"supported-protocols","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true}}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/user/all_complex_protocol_list":{"get":{"operationId":"compat_user_all_complex_protocol_list","tags":["Portfolio and tokens"],"summary":"GET /v1/user/all_complex_protocol_list","description":"Supported chain-specific protocols and positions. Use /api#coverage for available protocol IDs and position types. Prediction claims use Investment items with empty detail_types; read stats for their value. Covered source failures return 503. Unknown prices use zero with X-Splash-Valuation: partial-priced-subtotal. TVL is omitted when unavailable.","security":[],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"chain_ids","in":"query","required":false,"schema":{"type":"string"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"supported-protocols","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true}}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/user/simple_protocol_list":{"get":{"operationId":"compat_user_simple_protocol_list","tags":["Portfolio and tokens"],"summary":"GET /v1/user/simple_protocol_list","description":"Supported chain-specific protocols and positions. Use /api#coverage for available protocol IDs and position types. Prediction claims use Investment items with empty detail_types; read stats for their value. Covered source failures return 503. Unknown prices use zero with X-Splash-Valuation: partial-priced-subtotal. TVL is omitted when unavailable.","security":[],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"chain_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"supported-protocols","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true}}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/user/all_simple_protocol_list":{"get":{"operationId":"compat_user_all_simple_protocol_list","tags":["Portfolio and tokens"],"summary":"GET /v1/user/all_simple_protocol_list","description":"Supported chain-specific protocols and positions. Use /api#coverage for available protocol IDs and position types. Prediction claims use Investment items with empty detail_types; read stats for their value. Covered source failures return 503. Unknown prices use zero with X-Splash-Valuation: partial-priced-subtotal. TVL is omitted when unavailable.","security":[],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"chain_ids","in":"query","required":false,"schema":{"type":"string"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"supported-protocols","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true}}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/user/complex_app_list":{"get":{"operationId":"compat_user_complex_app_list","tags":["Portfolio and tokens"],"summary":"GET /v1/user/complex_app_list","description":"HyperCore app coverage only. No invented EVM-chain assets. Monetary values are JSON numbers.","security":[],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"hypercore-only","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CompatComplexApp"}}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/user/token":{"get":{"operationId":"compat_user_token","tags":["Portfolio and tokens"],"summary":"GET /v1/user/token","description":"Native assets, curated ERC20s and bounded indexed token discovery on the chains listed in /api#coverage. Token lists default is_all=true; false returns core tokens only. Not exhaustive. Lending receipt tokens and flagged spam excluded from lists; native ERC20 aliases counted once. Explicit single-token queries retain a flagged token quantity but no trusted price. Missing prices remain zero with partial-priced-subtotal header. Source failures return 503. Numeric raw_amount may exceed JavaScript safe integer precision; exact amounts are in the native portfolio API.","security":[],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"chain_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"token_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"curated-wallet","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatUserToken"}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/user/token_list":{"get":{"operationId":"compat_user_token_list","tags":["Portfolio and tokens"],"summary":"GET /v1/user/token_list","description":"Native assets, curated ERC20s and bounded indexed token discovery on the chains listed in /api#coverage. Token lists default is_all=true; false returns core tokens only. Not exhaustive. Lending receipt tokens and flagged spam excluded from lists; native ERC20 aliases counted once. Explicit single-token queries retain a flagged token quantity but no trusted price. Missing prices remain zero with partial-priced-subtotal header. Source failures return 503. Numeric raw_amount may exceed JavaScript safe integer precision; exact amounts are in the native portfolio API.","security":[],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"chain_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"is_all","in":"query","required":false,"schema":{"type":"boolean","default":true},"description":"Defaults to true. Set false for core tokens only; does not expand discovery or include quarantined spam."},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"curated-wallet","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true}}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/user/all_token_list":{"get":{"operationId":"compat_user_all_token_list","tags":["Portfolio and tokens"],"summary":"GET /v1/user/all_token_list","description":"Native assets, curated ERC20s and bounded indexed token discovery on the chains listed in /api#coverage. Token lists default is_all=true; false returns core tokens only. Not exhaustive. Lending receipt tokens and flagged spam excluded from lists; native ERC20 aliases counted once. Explicit single-token queries retain a flagged token quantity but no trusted price. Missing prices remain zero with partial-priced-subtotal header. Source failures return 503. Numeric raw_amount may exceed JavaScript safe integer precision; exact amounts are in the native portfolio API.","security":[],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"is_all","in":"query","required":false,"schema":{"type":"boolean","default":true},"description":"Defaults to true. Set false for core tokens only; does not expand discovery or include quarantined spam."},{"name":"chain_ids","in":"query","required":false,"schema":{"type":"string"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"curated-wallet","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true}}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/user/nft_list":{"get":{"operationId":"compat_user_nft_list","tags":["Portfolio and tokens"],"summary":"GET /v1/user/nft_list","description":"ERC-721 and ERC-1155 holdings on Ethereum (eth) and Optimism (op). id accepts a hex address only. is_all=true includes collections outside the default trusted set. Returns the first page per chain; X-Splash-Coverage: partial-nft-discovery indicates additional pages or unsupported requested chains. Use /v1/nft/addresses/{address} for pagination and exact string quantities. NFT prices remain null and are excluded from portfolio totals. Unsupported-only chain requests return [] with empty-unsupported coverage; source failures return 503.","security":[],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"chain_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"is_all","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Include collections outside the default trusted set."},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"NFT holdings for supported requested chains; check coverage headers.","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CompatNftHolding"}}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/user/all_nft_list":{"get":{"operationId":"compat_user_all_nft_list","tags":["Portfolio and tokens"],"summary":"GET /v1/user/all_nft_list","description":"ERC-721 and ERC-1155 holdings on Ethereum (eth) and Optimism (op). id accepts a hex address only. is_all=true includes collections outside the default trusted set. Returns the first page per chain; X-Splash-Coverage: partial-nft-discovery indicates additional pages or unsupported requested chains. Use /v1/nft/addresses/{address} for pagination and exact string quantities. NFT prices remain null and are excluded from portfolio totals. Unsupported-only chain requests return [] with empty-unsupported coverage; source failures return 503.","security":[],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"is_all","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Include collections outside the default trusted set."},{"name":"chain_ids","in":"query","required":false,"schema":{"type":"string"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"NFT holdings for supported requested chains; check coverage headers.","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CompatNftHolding"}}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/user/history_list":{"get":{"operationId":"compat_user_history_list","tags":["Portfolio and tokens"],"summary":"GET /v1/user/history_list","description":"Unsupported data returns an empty response of the documented shape, not evidence of an empty wallet. Transaction pre-execution returns success=false.","security":[],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"chain_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"token_id","in":"query","required":false,"schema":{"type":"string"}},{"name":"start_time","in":"query","required":false,"schema":{"type":"number"}},{"name":"page_count","in":"query","required":false,"schema":{"type":"integer"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"empty-unsupported","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatHistory"}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/user/all_history_list":{"get":{"operationId":"compat_user_all_history_list","tags":["Portfolio and tokens"],"summary":"GET /v1/user/all_history_list","description":"Unsupported data returns an empty response of the documented shape, not evidence of an empty wallet. Transaction pre-execution returns success=false.","security":[],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"start_time","in":"query","required":false,"schema":{"type":"number"}},{"name":"page_count","in":"query","required":false,"schema":{"type":"integer"}},{"name":"chain_ids","in":"query","required":false,"schema":{"type":"string"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"empty-unsupported","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatHistory"}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/user/token_authorized_list":{"get":{"operationId":"compat_user_token_authorized_list","tags":["Portfolio and tokens"],"summary":"GET /v1/user/token_authorized_list","description":"Unsupported data returns an empty response of the documented shape, not evidence of an empty wallet. Transaction pre-execution returns success=false.","security":[],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"chain_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"empty-unsupported","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true}}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/user/nft_authorized_list":{"get":{"operationId":"compat_user_nft_authorized_list","tags":["Portfolio and tokens"],"summary":"GET /v1/user/nft_authorized_list","description":"Unsupported data returns an empty response of the documented shape, not evidence of an empty wallet. Transaction pre-execution returns success=false.","security":[],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"chain_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"empty-unsupported","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatNftApprovals"}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/user/total_balance":{"get":{"operationId":"compat_user_total_balance","tags":["Portfolio and tokens"],"summary":"GET /v1/user/total_balance","description":"Net supported protocol positions plus curated wallets, after exact receipt-token reconciliation. total_balance additionally includes HyperCore equity. Version-scoped and non-exhaustive; see /api#coverage. Source failures and receipt quantity conflicts return 503. Unknown valuations retain known numeric subtotals with partial-priced-subtotal.","security":[],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"hypercore-protocols-curated-wallet","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatTotal"}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/user/chain_net_curve":{"get":{"operationId":"compat_user_chain_net_curve","tags":["Portfolio and tokens"],"summary":"GET /v1/user/chain_net_curve","description":"Unsupported data returns an empty response of the documented shape, not evidence of an empty wallet. Transaction pre-execution returns success=false.","security":[],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"chain_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"empty-unsupported","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true}}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/user/total_net_curve":{"get":{"operationId":"compat_user_total_net_curve","tags":["Portfolio and tokens"],"summary":"GET /v1/user/total_net_curve","description":"Unsupported data returns an empty response of the documented shape, not evidence of an empty wallet. Transaction pre-execution returns success=false.","security":[],"parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string"}},{"name":"chain_ids","in":"query","required":false,"schema":{"type":"string"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"empty-unsupported","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true}}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/wallet/gas_market":{"get":{"operationId":"compat_wallet_gas_market","tags":["Portfolio and tokens"],"summary":"GET /v1/wallet/gas_market","description":"Unsupported data returns an empty response of the documented shape, not evidence of an empty wallet. Transaction pre-execution returns success=false.","security":[],"parameters":[{"name":"chain_id","in":"query","required":true,"schema":{"type":"string"}},{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"empty-unsupported","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","additionalProperties":true}}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/wallet/pre_exec_tx":{"post":{"operationId":"compat_wallet_pre_exec_tx","tags":["Portfolio and tokens"],"summary":"POST /v1/wallet/pre_exec_tx","description":"Unsupported data returns an empty response of the documented shape, not evidence of an empty wallet. Transaction pre-execution returns success=false.","security":[],"parameters":[{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"empty-unsupported","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatSimulation"}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"413":{"description":"Request body exceeds 64 KiB","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"415":{"description":"Use Content-Type: application/json","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["tx"],"properties":{"tx":{"type":"object","additionalProperties":true},"pending_tx_list":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}}}},"/v1/wallet/explain_tx":{"post":{"operationId":"compat_wallet_explain_tx","tags":["Portfolio and tokens"],"summary":"POST /v1/wallet/explain_tx","description":"Unsupported data returns an empty response of the documented shape, not evidence of an empty wallet. Transaction pre-execution returns success=false.","security":[],"parameters":[{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"empty-unsupported","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"abi":{"type":"object","properties":{"func":{"type":"string"},"params":{"type":"array","items":{}}},"required":["func","params"]},"actions":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["abi","actions"]}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"413":{"description":"Request body exceeds 64 KiB","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"415":{"description":"Use Content-Type: application/json","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["tx"],"properties":{"tx":{"type":"object","additionalProperties":true},"pending_tx_list":{"type":"array","items":{"type":"object","additionalProperties":true}}}}}}}}},"/v1/account/units":{"get":{"operationId":"compat_account_units","tags":["Portfolio and tokens"],"summary":"GET /v1/account/units","description":"Returns balance=2147483647 and empty stats. This is not a paid credit balance or a guarantee of unlimited request capacity.","security":[],"parameters":[{"name":"AccessKey","in":"header","required":false,"schema":{"type":"string"},"description":"Any value accepted, or omit. Ignored; never stored or forwarded."}],"responses":{"200":{"description":"unmetered","headers":{"X-Splash-Coverage":{"schema":{"type":"string"}},"X-Splash-Data-Scope":{"schema":{"type":"string"}},"X-Splash-Valuation":{"schema":{"type":"string"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"balance":{"type":"integer"},"stats":{"type":"array","items":{"type":"object","additionalProperties":true}}},"required":["balance","stats"]}}}},"400":{"description":"Invalid query or request body","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"405":{"description":"Use the documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Covered source unavailable; not disguised as empty holdings","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CompatError"}}}}}}},"/v1/lending/addresses/{address}":{"get":{"operationId":"lookupLendingAddress","summary":"Get Aave and Compound lending positions across registered EVM mainnets","description":"Aave/Compound supplies, debt and covered rewards, including accrued Compound V2 COMP. Wallet balances and subaccounts are excluded. Net value includes covered rewards and deducts debt; Aave V1 debt includes origination fees. Summary totals are decimal strings. Partial responses retain known positions with complete=false and totalValueUsd=null. See /api#coverage for available markets and position types. The path accepts .eth/.hl names; resolved targets remain hex addresses in all existing financial fields. Named responses add identity metadata. Failed name resolution never queries a portfolio.","parameters":[{"name":"address","in":"path","required":true,"schema":{"$ref":"#/components/schemas/LookupIdentifier"}},{"name":"chain_ids","in":"query","schema":{"type":"string"}},{"name":"protocol_id","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Complete or explicitly partial lending portfolio","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LendingLookup"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"description":"Name has no resolved EVM address"},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Sources unavailable or capacity exceeded","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/LendingLookup"},{"$ref":"#/components/schemas/Error"}]}}}}}}},"/v1/portfolio/addresses/{address}":{"get":{"operationId":"lookupPortfolioAddress","summary":"Get native and curated ERC20 balances plus Aave/Compound lending","description":"Exact address, no subaccounts. Wallet + supplies - debt. Raw wallet amounts and native totals are exact decimal strings. Receipt tokens excluded, native ERC20 aliases counted once. discoveryComplete=false always: this is a curated token universe, not all-wallet discovery. Missing prices remain null, known subtotals preserved and totalValueUsd=null. Existing lending-only endpoints remain separate. The path accepts .eth/.hl names; resolved targets remain hex addresses in all existing financial fields. Named responses add identity metadata. Failed name resolution never queries a portfolio.","parameters":[{"name":"address","in":"path","required":true,"schema":{"$ref":"#/components/schemas/LookupIdentifier"}},{"name":"chain_ids","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Complete or explicitly partial lending portfolio","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PortfolioLookup"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"description":"Name has no resolved EVM address"},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Sources unavailable or capacity exceeded","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/PortfolioLookup"},{"$ref":"#/components/schemas/Error"}]}}}}}}},"/v1/defi/addresses/{address}":{"get":{"operationId":"lookupDefiAddress","summary":"Get additional DeFi protocol positions","description":"Supported protocol positions for one address, excluding Aave/Compound and Hyperliquid accounts. Supply, borrow, rewards and raw quantities are returned separately. Debt reduces net value. Verified sole-owner Polymarket Safe claims may be included. Missing prices, stale valuations and failed checks keep totals partial. Summary totals and native asset quantities are decimal strings. See /api#coverage for available chains, protocol IDs and position types. The path accepts .eth/.hl names; resolved targets remain hex addresses in all existing financial fields. Named responses add identity metadata. Failed name resolution never queries a portfolio.","parameters":[{"name":"address","in":"path","required":true,"schema":{"$ref":"#/components/schemas/LookupIdentifier"}},{"name":"chain_ids","in":"query","schema":{"type":"string"},"description":"Comma-separated chain IDs, for example eth,base"},{"name":"protocol_id","in":"query","schema":{"type":"string"},"description":"Canonical chain/version protocol ID, e.g. morphoblue, arb_fluid, matic_polymarket, hyper_hyperlend, hyper_kinetiq or hyper_pendle2"}],"responses":{"200":{"description":"Covered observation, possibly partial","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DefiLookup"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"description":"Name has no resolved EVM address"},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"All queried sources failed or lookup unavailable","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/DefiLookup"},{"$ref":"#/components/schemas/Error"}]}}}}}}},"/v1/explorer/addresses/{address}":{"get":{"operationId":"lookupExplorerAddress","summary":"Get wallet balances, net DeFi positions and Hyperliquid equity","description":"Combined portfolio for the supplied EVM address plus its Hyperliquid account and officially linked Hyperliquid subaccounts, returned separately under hyperliquid.accounts. No agent-owner resolution or history. Verified sole-owner Polymarket Safe claims can be included, but not proxy cash or unrelated positions. Value is wallet plus protocol assets minus debt plus Hyperliquid equity, excluding duplicate receipt balances. Gross exposure is separate. Hyperliquid equity uses USDC=$1; lending is not added twice to signed spot equity. Portfolio lookups use the same flow as the web interface. Splash makes a best-efforts lookup for any valid address. If portfolio data is already available, it can be returned immediately; otherwise, allow a few moments for the lookup to populate. Older estimates can return during an update, with cache.state=stale and totalValueUsd=null. refresh=true requests an update and may reuse a recent result. Reusing a result preserves fetchedAt; a failed update does not make an older estimate complete. Summary totals are decimal strings. Incomplete valuation sets totalValueUsd=null and retains knownValueUsd. Complete refers to covered checks, not exhaustive asset discovery. The path accepts .eth/.hl names; resolved targets remain hex addresses in all existing financial fields. Named responses add identity metadata. Failed name resolution never queries a portfolio.","parameters":[{"name":"address","in":"path","required":true,"schema":{"$ref":"#/components/schemas/LookupIdentifier"}},{"name":"refresh","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Request an update; a recent observation may be returned."}],"responses":{"200":{"description":"Complete covered observation or explicit partial subtotal","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExplorerLookup"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"description":"Name has no resolved EVM address"},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"All sources failed or lookup unavailable","content":{"application/json":{"schema":{"oneOf":[{"$ref":"#/components/schemas/ExplorerLookup"},{"$ref":"#/components/schemas/Error"}]}}}}}}},"/v1/identity/{identifier}":{"get":{"operationId":"getWalletIdentity","summary":"Discover forward-confirmed ENS and HL primary names","description":"Wallet display names, separate from financial values. Preference is HL primary, confirmed HL alias, ENS primary, confirmed ENS alias, then address. Both name systems remain in names; aliases are not primary records. Each name system may reuse successful display observations for up to one hour, capped by known ENS registration/subname expiry. ENS without expiry metadata is reused for at most 60 seconds. Read cacheExpiresAt and ttlSeconds; registration expiry is not a guarantee records cannot change sooner. Incomplete discovery returns HTTP 200 with partial/unavailable status, not proof that no name exists. Invalid, missing or unavailable input names return 400, 404 or 503 respectively. Forward target resolution retains its separate 60-second limit. No query parameters or API key required.","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"$ref":"#/components/schemas/LookupIdentifier"}}],"responses":{"200":{"description":"Verified names, unnamed address or explicitly unavailable optional discovery","content":{"application/json":{"schema":{"$ref":"#/components/schemas/WalletIdentity"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"description":"Input name has no forward address"},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Input name forward resolution unavailable"}}}},"/v1/resolve/{identifier}":{"get":{"operationId":"resolveWalletIdentifier","summary":"Resolve an EVM address, .eth name or .hl name","description":"Resolve a hex address, .eth name or .hl name to its current target EVM address, never the name owner. Successful name results may be reused for 60 seconds; missing names for 15 seconds. Missing names return 404, unavailable lookups 503. Names may change; use the returned address for financial requests. Portfolio and token query parameter id accepts hex addresses only. No query parameters or API key required.","parameters":[{"name":"identifier","in":"path","required":true,"schema":{"$ref":"#/components/schemas/LookupIdentifier"}}],"responses":{"200":{"description":"Resolved EVM address and provenance","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NameResolution"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"404":{"description":"No resolved EVM address; no portfolio queried"},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Name lookup temporarily unavailable; not evidence of a missing name"}}}},"/v1/nft/addresses/{address}":{"get":{"operationId":"getNftGallery","tags":["NFTs"],"summary":"Get NFT holdings for a wallet","description":"Ethereum (eth) and Optimism (op), ERC-721 and ERC-1155. Holdings are checked against current ownership. Names resolve to their current address. Up to 50 candidates per page. Follow nextCursor unchanged with the same address, chain and is_all value until null; there is no fixed page-count limit. Cursors last up to one hour and may expire earlier; restart from the first page after INVALID_CURSOR. complete=false means more pages or incomplete checks, not an empty wallet. Results may be reused for five minutes without changing fetchedAt. NFT values are not added to portfolio totals. Same-origin or server-to-server requests; no key required.","parameters":[{"name":"address","in":"path","required":true,"schema":{"$ref":"#/components/schemas/LookupIdentifier"}},{"name":"chain_id","in":"query","schema":{"enum":["eth","op"],"default":"eth"}},{"name":"is_all","in":"query","schema":{"type":"boolean","default":false},"description":"Include collections outside the default trusted set."},{"name":"cursor","in":"query","schema":{"type":"string","maxLength":64}}],"responses":{"200":{"description":"Ownership-checked holdings and pagination state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/NftGallery"}}}},"400":{"description":"Invalid address, query or expired cursor"},"404":{"description":"Name has no current address"},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"NFT lookup unavailable; do not treat as empty holdings"}}}},"/v1/leaderboard":{"get":{"tags":["Splash leaderboard"],"summary":"Wallets ranked by cached net value","parameters":[{"name":"q","in":"query","schema":{"type":"string","maxLength":512},"description":"Case-insensitive search of addresses, known names, exchange labels or protocols."},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"maximum":999999,"default":1},"description":"Page number; up to 20 wallets per page. Beyond the end returns the last available page."}],"description":"Wallets queried through portfolio endpoints join automatically. Results are ordered by exact USD net value, highest first, with address tie breaking and unobserved values last. Ranks remain global in search results. Values normally refresh every 60 minutes; check valueObservedAt, valuationComplete, stale and refreshFailed. Protocol values reconcile to netWorthUsd. Reading this endpoint does not request new portfolio data.","responses":{"200":{"description":"Ranked entries; unmatched searches return an empty entries array.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/LeaderboardWatchlist"}}}},"400":{"description":"Invalid q or page"},"405":{"description":"Use GET"},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Leaderboard temporarily unavailable; retry with backoff."}}}},"/v1/leaderboard/identities":{"get":{"tags":["Splash leaderboard"],"summary":"Names for a leaderboard page","parameters":[{"name":"q","in":"query","schema":{"type":"string","maxLength":512},"description":"Case-insensitive search of addresses, known names, exchange labels or protocols."},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"maximum":999999,"default":1},"description":"Page number; up to 20 wallets per page. Beyond the end returns the last available page."}],"description":"Names for wallets on the matching leaderboard page, without financial balances. Both HL and ENS names are returned when available. Changed name targets remain unavailable rather than assigned to a different wallet.","responses":{"200":{"description":"Per-wallet identity results, including explicit unavailable statuses.","content":{"application/json":{"schema":{"type":"object","required":["entries"],"properties":{"entries":{"type":"array","maxItems":20,"items":{"$ref":"#/components/schemas/LeaderboardIdentity"}}}}}}},"400":{"description":"Invalid q or page"},"405":{"description":"Use GET"},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Names temporarily unavailable; retry with backoff."}}}},"/v1/leaderboard/identities/stream":{"get":{"tags":["Splash leaderboard"],"summary":"Progressive names for a leaderboard page","parameters":[{"name":"q","in":"query","schema":{"type":"string","maxLength":512},"description":"Case-insensitive search of addresses, known names, exchange labels or protocols."},{"name":"page","in":"query","schema":{"type":"integer","minimum":1,"maximum":999999,"default":1},"description":"Page number; up to 20 wallets per page. Beyond the end returns the last available page."}],"description":"Server-sent events for the matching page. Each identity event contains a WalletIdentity JSON object for one exact address; repeated events replace that address's previous result. ENS and HL can arrive separately; pending status/source means discovery is still running, not a missing name. Cached display names can be sent immediately. A done event with {} ends the stream; close the connection then. On error or disconnection, keep already received names, close the connection and retry later. Events do not change ranks or portfolio values. Up to 150 seconds per connection. No API key required.","responses":{"200":{"description":"identity events followed by done, or an error event. Use EventSource or curl -N.","content":{"text/event-stream":{"schema":{"type":"string"}}}},"400":{"description":"Invalid q or page"},"405":{"description":"Use GET"},"429":{"description":"Request budget or concurrent-request capacity exceeded. Wait Retry-After seconds before retrying.","headers":{"Retry-After":{"schema":{"type":"integer","minimum":1},"description":"Seconds to wait before retrying."},"X-RateLimit-Limit":{"schema":{"type":"integer"},"description":"Network-client request-budget replenishment per minute."},"X-RateLimit-Remaining":{"schema":{"type":"integer"},"description":"Immediately available requests; shared capacity may be lower."},"X-RateLimit-Reset":{"schema":{"type":"integer"},"description":"Seconds until the burst budget is fully replenished."}}},"503":{"description":"Identity capacity unavailable; retry later."}}}}},"components":{"responses":{"BadRequest":{"description":"Invalid address or query parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"MethodNotAllowed":{"description":"Use the endpoint's documented method","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"NullableFlag":{"type":["boolean","null"],"description":"Null means a negative result could not be established from the checked sources."},"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}},"Lookup":{"type":"object","required":["requestedAddress","resolvedAddress","role","fetchedAt","status","hasHoldingsNow","hasObservedActivity","hasHyperliquidFootprint","accounts","summary","evidence","warnings","sources","coverage","cache"],"properties":{"requestedAddress":{"$ref":"#/components/schemas/Address"},"resolvedAddress":{"$ref":"#/components/schemas/Address"},"role":{"type":["object","null"],"properties":{"role":{"type":"string","enum":["missing","user","agent","vault","subAccount"]},"data":{"type":"object"}}},"fetchedAt":{"type":"string","format":"date-time"},"status":{"type":"string","enum":["active_portfolio","activity_found","no_activity_found","unknown"]},"hasHoldingsNow":{"$ref":"#/components/schemas/NullableFlag"},"hasObservedActivity":{"$ref":"#/components/schemas/NullableFlag"},"hasHyperliquidFootprint":{"$ref":"#/components/schemas/NullableFlag"},"accounts":{"type":"array","items":{"$ref":"#/components/schemas/Account"}},"summary":{"$ref":"#/components/schemas/Valuation"},"evidence":{"type":"array","items":{"type":"object","required":["address","kind","count"],"properties":{"address":{"$ref":"#/components/schemas/Address"},"kind":{"type":"string"},"count":{"type":"integer","minimum":1}}}},"warnings":{"type":"array","items":{"type":"string"}},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"coverage":{"$ref":"#/components/schemas/Coverage"},"cache":{"type":"object","required":["hit","ttlSeconds"],"properties":{"hit":{"type":"boolean"},"ttlSeconds":{"type":"number","minimum":0}}},"identity":{"$ref":"#/components/schemas/NameResolution"}}},"NullableRecords":{"type":["array","null"],"items":{"type":"object","additionalProperties":true},"description":"Upstream records with original decimal strings preserved. Null means the source query failed."},"Account":{"type":"object","required":["address","accountMode","portfolio","activity"],"properties":{"address":{"$ref":"#/components/schemas/Address"},"parentAddress":{"$ref":"#/components/schemas/Address","description":"Present only for an officially linked Hyperliquid subaccount; EVM positions are not expanded."},"fetchedAt":{"type":"string","format":"date-time"},"accountMode":{"type":["string","null"],"enum":["unifiedAccount","portfolioMargin","disabled","default","dexAbstraction",null]},"portfolio":{"type":"object","required":["spotBalances","vaultEquities","staking","borrowLend","perpMarkets","totalValueUsd","valuationNote"],"properties":{"spotBalances":{"$ref":"#/components/schemas/NullableRecords"},"tokenMetadata":{"type":"array","items":{"$ref":"#/components/schemas/HyperCoreTokenMetadata"}},"vaultEquities":{"$ref":"#/components/schemas/NullableRecords"},"staking":{"type":["object","null"],"additionalProperties":true},"borrowLend":{"type":["object","null"],"additionalProperties":true},"perpMarkets":{"type":"array","items":{"type":"object","required":["dex","state","openOrders"],"properties":{"dex":{"type":"string"},"state":{"type":["object","null"],"description":"Raw margin summaries and assetPositions; decimal values are strings.","additionalProperties":true},"openOrders":{"$ref":"#/components/schemas/NullableRecords"}}}},"totalValueUsd":{"type":["string","null"],"description":"Estimated USD equity, or null when incomplete."},"valuation":{"$ref":"#/components/schemas/Valuation"},"valuationNote":{"type":"string"}}},"activity":{"type":"object","required":["fills","historicalOrders","ledger","stakingHistory"],"properties":{"fills":{"$ref":"#/components/schemas/NullableRecords"},"historicalOrders":{"$ref":"#/components/schemas/NullableRecords"},"ledger":{"$ref":"#/components/schemas/NullableRecords"},"stakingHistory":{"$ref":"#/components/schemas/NullableRecords"}}}}},"HyperCoreTokenMetadata":{"type":"object","required":["index","name","priceUsd"],"description":"Observed token metadata. Outcome index values use the +encoding token name, not a normal spot-token index. Their separate numeric assetId identifies the outcome trading asset.","properties":{"index":{"oneOf":[{"type":"integer","minimum":0},{"type":"string","pattern":"^\\+[0-9]+$"}]},"name":{"type":"string"},"fullName":{"type":["string","null"]},"priceUsd":{"type":["string","null"],"description":"Exact decimal USD estimate. Null is unknown; zero can be a verified zero settlement payout."},"kind":{"type":"string","enum":["outcome"]},"outcome":{"type":"integer","minimum":0},"side":{"type":"integer","enum":[0,1]},"sideName":{"type":"string"},"assetId":{"type":"integer","minimum":100000000},"quoteToken":{"type":"string"},"pricing":{"type":"object","description":"Price basis and original observation timestamp. Midpoints are indicative, not guaranteed sale proceeds.","additionalProperties":true}},"additionalProperties":true},"Source":{"type":"object","required":["type","status","fetchedAt"],"properties":{"type":{"type":"string"},"user":{"$ref":"#/components/schemas/Address"},"dex":{"type":"string","description":"Empty string means native perpetuals."},"status":{"type":"string","enum":["ok","error"]},"fetchedAt":{"type":["string","null"],"format":"date-time"},"itemCount":{"type":"integer","minimum":0},"startTime":{"type":"integer"},"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string"},"message":{"type":"string"}}}}},"Valuation":{"type":"object","required":["totalValueUsd","knownValueUsd","valuationComplete","grossPositionValueUsd","knownGrossPositionValueUsd","exposureComplete","unrealizedPnlUsd","positionCount","missing"],"properties":{"totalValueUsd":{"type":["string","null"]},"knownValueUsd":{"type":"string"},"valuationComplete":{"type":"boolean"},"grossPositionValueUsd":{"type":["string","null"],"description":"Sum of absolute open position notionals, separate from equity."},"knownGrossPositionValueUsd":{"type":"string"},"exposureComplete":{"type":"boolean"},"unrealizedPnlUsd":{"type":["string","null"]},"knownLendingSupplyUsd":{"type":"string","description":"Known Hyperliquid supply already included in signed spot equity."},"knownLendingDebtUsd":{"type":"string","description":"Known Hyperliquid debt already deducted from signed spot equity."},"lendingSupplyUsd":{"type":["string","null"]},"lendingDebtUsd":{"type":["string","null"]},"positionCount":{"type":"integer","minimum":0},"uniqueAccounts":{"type":"integer","minimum":0},"scopeComplete":{"type":"boolean"},"missing":{"type":"array","items":{"type":"string"}},"priceAsOf":{"type":["string","null"],"format":"date-time"},"components":{"type":"object","additionalProperties":{"type":"string"}},"methodology":{"type":"string"}}},"Coverage":{"type":"object","required":["network","scope","hyperEvmIncluded","includesSubaccounts","accountsChecked","dexsChecked","skippedAccounts","skippedDexs","currentPortfolioChecksSucceeded","activityChecksSucceeded","historyComplete","history","excluded","failedSources"],"properties":{"network":{"const":"mainnet"},"scope":{"const":"HyperCore"},"hyperEvmIncluded":{"const":false},"includesSubaccounts":{"type":"boolean"},"accountsChecked":{"type":"array","items":{"$ref":"#/components/schemas/Address"}},"dexsChecked":{"type":"array","items":{"type":"string"}},"skippedAccounts":{"type":"array","items":{"$ref":"#/components/schemas/Address"}},"skippedDexs":{"type":"array","items":{"type":"string"}},"currentPortfolioChecksSucceeded":{"type":"boolean"},"activityChecksSucceeded":{"type":"boolean"},"historyComplete":{"const":false},"history":{"type":"object","additionalProperties":{"type":"string"}},"excluded":{"type":"array","items":{"type":"string"}},"failedSources":{"type":"integer","minimum":0}}},"CompatError":{"type":"object","properties":{"error_code":{"type":"integer"},"error_msg":{"type":"string"}},"required":["error_code","error_msg"]},"CompatChain":{"type":"object","properties":{"id":{"type":"string"},"community_id":{"type":"integer"},"name":{"type":["string","null"]},"logo_url":{"type":["string","null"]},"native_token_id":{"type":"string"},"wrapped_token_id":{"type":"string"},"is_support_pre_exec":{"type":"boolean"}},"required":["id","community_id","name","logo_url","native_token_id","wrapped_token_id","is_support_pre_exec"]},"CompatProtocol":{"type":"object","properties":{"id":{"type":"string"},"chain":{"type":"string"},"name":{"type":["string","null"]},"site_url":{"type":["string","null"]},"logo_url":{"type":["string","null"]},"has_supported_portfolio":{"type":"boolean"},"tvl":{"type":"number"}},"required":["id","chain","name","site_url","logo_url","has_supported_portfolio"]},"CompatToken":{"type":"object","properties":{"id":{"type":"string"},"chain":{"type":"string"},"name":{"type":["string","null"]},"symbol":{"type":["string","null"]},"display_symbol":{"type":["string","null"]},"optimized_symbol":{"type":["string","null"]},"decimals":{"type":["integer","null"]},"logo_url":{"type":["string","null"]},"protocol_id":{"type":"string"},"is_verified":{"type":"boolean"},"is_core":{"type":"boolean"},"is_wallet":{"type":"boolean"},"price":{"type":"number"},"time_at":{"type":["integer","null"]}},"required":["id","chain","name","symbol","display_symbol","optimized_symbol","decimals","logo_url","protocol_id","is_verified","is_core","is_wallet","price","time_at"]},"CompatLendingToken":{"type":"object","properties":{"id":{"type":"string"},"chain":{"type":"string"},"name":{"type":["string","null"]},"symbol":{"type":["string","null"]},"display_symbol":{"type":["string","null"]},"optimized_symbol":{"type":["string","null"]},"decimals":{"type":["integer","null"]},"logo_url":{"type":["string","null"]},"protocol_id":{"type":"string"},"is_verified":{"type":"boolean"},"is_core":{"type":"boolean"},"is_wallet":{"type":"boolean"},"price":{"type":"number"},"time_at":{"type":["integer","null"]},"amount":{"type":"number"}},"required":["id","chain","name","symbol","display_symbol","optimized_symbol","decimals","logo_url","protocol_id","is_verified","is_core","is_wallet","price","time_at","amount"]},"CompatUserToken":{"type":"object","properties":{"id":{"type":"string"},"chain":{"type":"string"},"name":{"type":["string","null"]},"symbol":{"type":["string","null"]},"display_symbol":{"type":["string","null"]},"optimized_symbol":{"type":["string","null"]},"decimals":{"type":["integer","null"]},"logo_url":{"type":["string","null"]},"protocol_id":{"type":"string"},"is_verified":{"type":"boolean"},"is_core":{"type":"boolean"},"is_wallet":{"type":"boolean"},"price":{"type":"number"},"time_at":{"type":["integer","null"]},"amount":{"type":"number"},"raw_amount":{"type":"integer"}},"required":["id","chain","name","symbol","display_symbol","optimized_symbol","decimals","logo_url","protocol_id","is_verified","is_core","is_wallet","price","time_at","amount","raw_amount"]},"CompatApp":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"site_url":{"type":"string"},"logo_url":{"type":["string","null"]},"has_supported_portfolio":{"type":"boolean"}},"required":["id","name","site_url","logo_url","has_supported_portfolio"]},"CompatAppToken":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"symbol":{"type":"string"},"display_symbol":{"type":["string","null"]},"optimized_symbol":{"type":"string"},"decimals":{"type":["integer","null"]},"logo_url":{"type":["string","null"]},"app_id":{"const":"hyperliquid"},"price":{"type":"number"},"amount":{"type":"number"}},"required":["id","name","symbol","display_symbol","optimized_symbol","decimals","logo_url","app_id","price","amount"]},"CompatPortfolioItem":{"type":"object","properties":{"stats":{"type":"object","properties":{"asset_usd_value":{"type":"number"},"debt_usd_value":{"type":"number"},"net_usd_value":{"type":"number"}},"required":["asset_usd_value","debt_usd_value","net_usd_value"]},"asset_dict":{"type":"object","additionalProperties":{"type":"number"}},"asset_token_list":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/CompatAppToken"},{"$ref":"#/components/schemas/CompatLendingToken"}]}},"update_at":{"type":"number"},"name":{"type":"string"},"detail_types":{"type":"array","items":{"type":"string"}},"detail":{"type":"object","required":["description"],"properties":{"supply_token_list":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/CompatAppToken"},{"$ref":"#/components/schemas/CompatLendingToken"}]}},"borrow_token_list":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/CompatAppToken"},{"$ref":"#/components/schemas/CompatLendingToken"}]}},"reward_token_list":{"type":"array","items":{"oneOf":[{"$ref":"#/components/schemas/CompatAppToken"},{"$ref":"#/components/schemas/CompatLendingToken"}]}},"description":{"type":"string"}}},"proxy_detail":{"type":"object","additionalProperties":true},"position_index":{"type":"string"}},"required":["stats","asset_dict","asset_token_list","update_at","name","detail_types","detail","proxy_detail","position_index"]},"CompatComplexApp":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"},"site_url":{"type":"string"},"logo_url":{"type":["string","null"]},"has_supported_portfolio":{"type":"boolean"},"portfolio_item_list":{"type":"array","items":{"$ref":"#/components/schemas/CompatPortfolioItem"}}},"required":["id","name","site_url","logo_url","has_supported_portfolio","portfolio_item_list"]},"CompatUserProtocol":{"type":"object","properties":{"id":{"type":"string"},"chain":{"type":"string"},"name":{"type":["string","null"]},"site_url":{"type":["string","null"]},"logo_url":{"type":["string","null"]},"has_supported_portfolio":{"type":"boolean"},"tvl":{"type":"number"},"portfolio_item_list":{"type":"array","items":{"$ref":"#/components/schemas/CompatPortfolioItem"}}},"required":["id","chain","name","site_url","logo_url","has_supported_portfolio","portfolio_item_list"]},"CompatHistory":{"type":"object","properties":{"cate_dict":{"type":"object","additionalProperties":true},"history_list":{"type":"array","items":{"type":"object","additionalProperties":true}},"project_dict":{"type":"object","additionalProperties":true},"token_dict":{"type":"object","additionalProperties":true},"cex_dict":{"type":"object","additionalProperties":true}},"required":["cate_dict","history_list","project_dict","token_dict","cex_dict"]},"CompatNftApprovals":{"type":"object","properties":{"tokens":{"type":"array","items":{"type":"object","additionalProperties":true}},"contracts":{"type":"array","items":{"type":"object","additionalProperties":true}},"total":{"type":"string"}},"required":["tokens","contracts","total"]},"CompatPool":{"type":"object","properties":{"pool_id":{"type":"string"},"chain":{"type":"string"},"protocol_id":{"type":"string"},"contract_ids":{"type":"array","items":{"type":"string"}},"name":{"type":["string","null"]},"stats":{"type":"object","properties":{"deposit_usd_value":{"type":"number"},"deposit_user_count":{"type":"integer"},"deposit_valuable_user_count":{"type":"integer"}},"required":["deposit_usd_value","deposit_user_count","deposit_valuable_user_count"]}},"required":["pool_id","chain","protocol_id","contract_ids","name","stats"]},"CompatTotal":{"type":"object","properties":{"total_usd_value":{"type":"number"},"chain_list":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"community_id":{"type":"integer"},"name":{"type":["string","null"]},"logo_url":{"type":["string","null"]},"native_token_id":{"type":"string"},"wrapped_token_id":{"type":"string"},"is_support_pre_exec":{"type":"boolean"},"usd_value":{"type":"number"}}}}},"required":["total_usd_value","chain_list"]},"CompatSimulation":{"type":"object","properties":{"balance_change":{"type":"object","properties":{"success":{"const":false},"error":{"type":"object","properties":{"code":{"const":2000},"message":{"type":"string"}},"required":["code","message"]},"send_token_list":{"type":"array","items":{"type":"object","additionalProperties":true}},"receive_token_list":{"type":"array","items":{"type":"object","additionalProperties":true}},"send_nft_list":{"type":"array","items":{"type":"object","additionalProperties":true}},"receive_nft_list":{"type":"array","items":{"type":"object","additionalProperties":true}},"usd_value_change":{"type":"number"}},"required":["success","error","send_token_list","receive_token_list","send_nft_list","receive_nft_list","usd_value_change"]},"gas":{"type":"object","properties":{"success":{"const":false},"error":{"type":"object","properties":{"code":{"const":2000},"message":{"type":"string"}},"required":["code","message"]},"gas_used":{"type":"integer"}},"required":["success","error","gas_used"]},"pre_exec":{"type":"object","properties":{"success":{"const":false},"error":{"type":"object","properties":{"code":{"const":2000},"message":{"type":"string"}},"required":["code","message"]}},"required":["success","error"]},"is_multisig":{"const":false},"multisig":{"type":"null"}},"required":["balance_change","gas","pre_exec","is_multisig","multisig"]},"LendingValuation":{"allOf":[{"$ref":"#/components/schemas/Valuation"},{"type":"object","required":["supplyUsd","debtUsd"],"properties":{"supplyUsd":{"type":"string"},"debtUsd":{"type":"string"}}}]},"LendingLookup":{"type":"object","required":["address","complete","protocols","sources","summary","chainsChecked","marketsChecked","totals"],"properties":{"address":{"$ref":"#/components/schemas/Address"},"complete":{"type":"boolean"},"fetchedAt":{"type":"string","format":"date-time"},"protocols":{"type":"array","items":{"$ref":"#/components/schemas/CompatUserProtocol"}},"sources":{"type":"array","items":{"type":"object","required":["type","status","chains","markets"],"properties":{"type":{"type":"string"},"status":{"enum":["ok","error"]},"chains":{"type":"array","items":{"type":"string"}},"markets":{"type":"integer"}}}},"chainsChecked":{"type":"array","items":{"type":"string"}},"marketsChecked":{"type":"integer"},"summary":{"$ref":"#/components/schemas/LendingValuation"},"totals":{"type":"object","required":["asset_usd_value","debt_usd_value","net_usd_value"],"properties":{"asset_usd_value":{"type":"string"},"debt_usd_value":{"type":"string"},"net_usd_value":{"type":"string"}}},"identity":{"$ref":"#/components/schemas/NameResolution"}}},"PortfolioValuation":{"allOf":[{"$ref":"#/components/schemas/LendingValuation"},{"type":"object","required":["walletUsd","knownWalletUsd","walletDiscoveryComplete"],"properties":{"walletUsd":{"type":["string","null"]},"knownWalletUsd":{"type":"string"},"walletDiscoveryComplete":{"const":false}}}]},"WalletBalance":{"type":"object","required":["id","chain","symbol","decimals","native","rawAmount","amount","priceUsd","valueUsd"],"properties":{"id":{"type":"string"},"chain":{"type":"string"},"symbol":{"type":"string"},"decimals":{"type":"integer"},"native":{"type":"boolean"},"rawAmount":{"type":"string","pattern":"^[0-9]+$"},"amount":{"type":"string"},"priceUsd":{"type":["string","null"]},"valueUsd":{"type":["string","null"]},"blockNumber":{"type":"string"},"retained":{"type":"boolean"},"observedAt":{"type":"string","format":"date-time","description":"Original observation time when a combined portfolio retains this row after a failed refresh."},"classification":{"type":"object","properties":{"status":{"const":"spam"},"reason":{"const":"explorer-reputation"},"observedAt":{"type":"number"}}},"pricing":{"type":["object","null"],"properties":{"provider":{"enum":["nobi","defillama","coingecko","dexscreener","chainlink","onchain-conversion","verified-vault-conversion"]},"currency":{"const":"USD"},"code":{"type":"string"},"conversionCode":{"type":"string"},"timestamp":{"type":"number"},"fallbackReason":{"type":"string"}}}}},"WalletSnapshot":{"type":"object","required":["tokens","complete","balancesComplete","valuationComplete","discoveryComplete","totalValueUsd","knownValueUsd"],"properties":{"tokens":{"type":"array","items":{"$ref":"#/components/schemas/WalletBalance"}},"complete":{"type":"boolean"},"balancesComplete":{"type":"boolean"},"valuationComplete":{"type":"boolean"},"discoveryComplete":{"const":false},"spamTokens":{"type":"array","items":{"$ref":"#/components/schemas/WalletBalance"},"description":"Separately flagged spam tokens. Excluded from tokens, pricing and portfolio totals; quantities remain exact and price/value are null. Unpriced tokens without a spam flag remain in tokens and keep totals partial."},"totalValueUsd":{"type":["string","null"]},"knownValueUsd":{"type":"string"},"unpricedTokens":{"type":"integer"}}},"PortfolioLookup":{"allOf":[{"$ref":"#/components/schemas/LendingLookup"},{"type":"object","required":["wallet"],"properties":{"wallet":{"$ref":"#/components/schemas/WalletSnapshot"},"summary":{"$ref":"#/components/schemas/PortfolioValuation"}}}]},"SharedClaimCustody":{"type":"object","required":["key","claimKeys","updateAt","complete"],"properties":{"key":{"type":"string","description":"Canonical protocol, chain and custody address."},"claimKeys":{"type":"array","items":{"type":"string"}},"updateAt":{"type":"number"},"complete":{"type":"boolean","description":"Whether claim membership was fully observed, including an empty set. Incomplete observations cannot establish that older claims disappeared."}}},"DefiAsset":{"type":"object","required":["id","symbol","decimals","rawAmount","amount","priceUsd","valueUsd"],"properties":{"id":{"type":"string","description":"ERC20 contract address or canonical native token ID, e.g. hyper for HYPE"},"native":{"type":"boolean"},"symbol":{"type":"string"},"name":{"type":"string"},"decimals":{"type":"integer","minimum":0,"maximum":36},"rawAmount":{"type":"string"},"amount":{"type":"string"},"priceUsd":{"type":["string","null"]},"valueUsd":{"type":["string","null"]},"pricing":{"type":["object","null"]},"isCollateral":{"type":"boolean"}}},"DefiPosition":{"type":"object","required":["id","protocolId","protocolName","family","chain","supply","borrow","receipts","valuationComplete","stats"],"properties":{"id":{"type":"string"},"protocolId":{"type":"string"},"protocolName":{"type":"string"},"family":{"type":"string"},"chain":{"type":"string"},"name":{"type":"string"},"description":{"type":"string"},"updateAt":{"type":"number"},"retained":{"type":"boolean","description":"Retained from an earlier observation; updateAt remains its original timestamp."},"supply":{"type":"array","items":{"$ref":"#/components/schemas/DefiAsset"}},"borrow":{"type":"array","items":{"$ref":"#/components/schemas/DefiAsset"}},"rewards":{"type":"array","items":{"$ref":"#/components/schemas/DefiAsset"}},"receipts":{"type":"array","items":{"type":"object","required":["chain","id","rawAmount"],"properties":{"chain":{"type":"string"},"id":{"$ref":"#/components/schemas/Address"},"rawAmount":{"type":"string"}}}},"pool":{"type":"object","properties":{"id":{"$ref":"#/components/schemas/Address"},"controller":{"$ref":"#/components/schemas/Address"},"chain":{"type":"string"},"project_id":{"type":"string"}}},"lock":{"type":"object","properties":{"permanent":{"type":"boolean"},"unlockAt":{"type":"number"}}},"rewardClaim":{"type":"object","description":"Published reward allocation and claimed amount at the observed block. Delivered assets are in rewards; never add this allocation again.","properties":{"distributor":{"$ref":"#/components/schemas/Address"},"token":{"$ref":"#/components/schemas/Address"},"recipient":{"$ref":"#/components/schemas/Address"},"root":{"type":"string"},"blockNumber":{"type":"string"},"publishedRaw":{"type":"string"},"claimedRaw":{"type":"string"}}},"freshness":{"type":"object","properties":{"balanceObservedAt":{"type":"number"},"valuationAsOf":{"type":"number"},"valuationStale":{"type":"boolean"},"discoveryAsOf":{"type":"string","format":"date-time"},"discoveryStale":{"type":"boolean"}}},"claim":{"type":"object","description":"Prediction ERC1155 claim, not an ERC20 wallet balance","required":["tokenId","conditionId","amount","priceUsdc","valueUsdc","valueUsd"],"properties":{"wallet":{"$ref":"#/components/schemas/Address"},"sharedKey":{"type":"string"},"tokenId":{"type":"string"},"conditionId":{"type":"string"},"title":{"type":"string"},"outcome":{"type":"string"},"amount":{"type":"string"},"priceUsdc":{"type":"string"},"valueUsdc":{"type":"string"},"valueUsd":{"type":["string","null"]},"redeemable":{"type":"boolean"},"pricing":{"type":["object","null"]}}},"valuationComplete":{"type":"boolean"},"stats":{"type":"object","required":["assetUsd","debtUsd","netUsd"],"properties":{"assetUsd":{"type":"string"},"debtUsd":{"type":"string"},"netUsd":{"type":"string"}}}}},"DefiLookup":{"type":"object","required":["address","fetchedAt","complete","positions","protocols","summary","sources","coverage"],"properties":{"address":{"$ref":"#/components/schemas/Address"},"fetchedAt":{"type":"string","format":"date-time"},"complete":{"type":"boolean"},"positions":{"type":"array","items":{"$ref":"#/components/schemas/DefiPosition"}},"protocols":{"type":"array","items":{"$ref":"#/components/schemas/CompatUserProtocol"}},"sources":{"type":"array","items":{"type":"object"}},"coverage":{"type":"object"},"sharedCustodies":{"type":"array","items":{"$ref":"#/components/schemas/SharedClaimCustody"}},"summary":{"type":"object","required":["knownValueUsd","totalValueUsd","valuationComplete","supplyUsd","debtUsd","positionCount","missing"],"properties":{"knownValueUsd":{"type":"string"},"totalValueUsd":{"type":["string","null"]},"valuationComplete":{"type":"boolean"},"supplyUsd":{"type":"string"},"debtUsd":{"type":"string"},"positionCount":{"type":"integer"},"missing":{"type":"array","items":{"type":"string"}}}},"identity":{"$ref":"#/components/schemas/NameResolution"}}},"ExplorerSnapshotCache":{"type":"object","properties":{"state":{"enum":["miss","hit","stale","bypass"]},"ageSeconds":{"type":"integer","minimum":0,"description":"Age of the original observation."},"freshForSeconds":{"type":"integer","minimum":0,"description":"Remaining reuse window for this wallet."},"expiresInSeconds":{"type":"integer","minimum":0,"description":"Seconds until the current reuse window ends. Zero does not prevent an explicitly stale, partial estimate being returned."},"refreshing":{"type":"boolean"},"refreshError":{"type":"boolean"}}},"ExplorerValuation":{"allOf":[{"$ref":"#/components/schemas/PortfolioValuation"},{"type":"object","required":["knownHyperliquidUsd","hyperliquidUsd","knownEvmUsd","knownDefiUsd","defiUsd","knownPositionsNetUsd","positionsNetUsd"],"properties":{"knownHyperliquidUsd":{"type":"string"},"knownEvmUsd":{"type":"string"},"hyperliquidUsd":{"type":["string","null"]},"knownHyperliquidSupplyUsd":{"type":"string","description":"Known Hyperliquid supplied value, already included in equity and supplyUsd."},"knownHyperliquidDebtUsd":{"type":"string","description":"Known Hyperliquid borrowed value, already deducted from equity and included in debtUsd."},"debtComplete":{"type":"boolean","description":"True when covered borrowing checks and debt prices succeeded, independently of unrelated wallet or supply-only checks. When false, debtUsd is only the known subtotal; zero does not establish no borrowing."},"debtMissing":{"type":"array","items":{"type":"string"},"description":"Reasons borrowing could not be fully established, including stale or in-progress observations."},"hyperliquidAccountDuplicates":{"type":"integer","minimum":0,"description":"Shared Hyperliquid accounts counted once across batch roots; individual wallet rows retain their values."},"hyperliquidAccounts":{"type":"array","description":"Hyperliquid account observations used to count each actual account once across batch roots.","items":{"type":"object","properties":{"address":{"$ref":"#/components/schemas/Address"},"fetchedAt":{"type":"string","format":"date-time"},"knownValueUsd":{"type":"string"},"knownLendingSupplyUsd":{"type":"string"},"knownLendingDebtUsd":{"type":"string"},"knownGrossPositionValueUsd":{"type":"string"},"unrealizedPnlUsd":{"type":["string","null"]},"positionCount":{"type":"integer","minimum":0},"valuationComplete":{"type":"boolean"}}}},"knownDefiUsd":{"type":"string"},"defiUsd":{"type":["string","null"]},"knownPositionsNetUsd":{"type":"string","description":"Known covered value minus known wallet value, including all protocol net positions and HyperCore equity. Borrowing is already deducted; gross exposure is excluded."},"positionsNetUsd":{"type":["string","null"],"description":"Net positions value when the full observation valuation is complete; otherwise null. Known subtotals remain in knownPositionsNetUsd."},"sharedClaimDuplicates":{"type":"integer","minimum":0,"description":"Canonical Polymarket claims removed from the combined batch total, not from individual wallet rows."},"sharedClaimSuperseded":{"type":"integer","minimum":0,"description":"Older claims absent from a newer complete custody observation, removed from the combined batch subtotal. Conflicting observations remain partial."},"sharedCustodies":{"type":"array","items":{"$ref":"#/components/schemas/SharedClaimCustody"},"description":"Complete or partial custody membership observations, including empty sets, retained across snapshot cache hits."},"sharedClaims":{"type":"array","description":"Per-account canonical claim ledger for owner/proxy batch deduplication.","items":{"type":"object","properties":{"key":{"type":"string"},"amount":{"type":"string"},"valueUsd":{"type":["string","null"]},"updateAt":{"type":"number"}}}}}}]},"ExplorerLookup":{"type":"object","required":["address","complete","summary","sources","evm","hyperliquid","defi","coverage"],"properties":{"address":{"$ref":"#/components/schemas/Address"},"fetchedAt":{"type":"string","format":"date-time"},"complete":{"type":"boolean"},"cache":{"$ref":"#/components/schemas/ExplorerSnapshotCache"},"summary":{"$ref":"#/components/schemas/ExplorerValuation"},"evm":{"anyOf":[{"$ref":"#/components/schemas/PortfolioLookup"},{"type":"null"}]},"hyperliquid":{"anyOf":[{"$ref":"#/components/schemas/Lookup"},{"type":"null"}]},"defi":{"anyOf":[{"$ref":"#/components/schemas/DefiLookup"},{"type":"null"}]},"sources":{"type":"array","items":{"type":"object","required":["type","status"],"properties":{"type":{"type":"string"},"status":{"enum":["ok","error"]},"chains":{"type":"array","items":{"type":"string"}},"retained":{"type":"boolean","description":"Some displayed values from this source predate the latest attempt."},"retainedObservedAt":{"type":"string","format":"date-time","description":"Original observation time of retained source data; not renewed by a failed refresh."},"failureKind":{"enum":["access","limit","stale","transient","invalid"]},"checkedTokenIds":{"type":"array","items":{"type":"string"},"description":"Wallet token IDs with a verified current balance, including observed zeroes."}}}},"coverage":{"type":"object","required":["exactAddress","walletDiscoveryComplete","includesSubaccounts","failedSources"],"properties":{"exactAddress":{"type":"boolean"},"evmExactAddress":{"const":true},"walletDiscoveryComplete":{"const":false},"includesSubaccounts":{"type":"boolean"},"historyIncluded":{"const":false},"failedSources":{"type":"integer"},"valuation":{"type":"string"},"protocolProxyDiscovery":{"const":"verified-polymarket-safe-claims-only"}}},"identity":{"$ref":"#/components/schemas/NameResolution"},"entity":{"anyOf":[{"$ref":"#/components/schemas/ExchangeEntity"},{"type":"null"}],"description":"Known published exchange-wallet attribution, or null when no label is known. Not a solvency assessment or proof of ownership on other networks."}}},"LookupIdentifier":{"type":"string","maxLength":512,"description":"EVM address, .eth ENS name or .hl name, including subnames. Names are ENSIP-15 normalized server-side and limited to 255 UTF-8 bytes. URLs and other suffixes are rejected."},"ExchangeEntity":{"type":"object","required":["id","name","category","chains","sources"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"category":{"const":"cex"},"chains":{"type":"array","items":{"type":"string"},"description":"Networks on which this address is published as an exchange wallet."},"sources":{"type":"array","items":{"type":"object","required":["url","observedAt"],"properties":{"url":{"type":"string","format":"uri"},"observedAt":{"type":"string","format":"date-time"}}}}}},"NameResolution":{"type":"object","required":["input","name","kind","address"],"properties":{"input":{"$ref":"#/components/schemas/LookupIdentifier"},"name":{"type":["string","null"]},"kind":{"enum":["address","ens","hl"]},"address":{"$ref":"#/components/schemas/Address"},"lookupName":{"type":"string"},"provider":{"type":"string"},"resolutionChainId":{"const":1},"resolvedAt":{"type":"string","format":"date-time"},"cache":{"type":"object","properties":{"hit":{"type":"boolean"},"ttlSeconds":{"type":"integer"}}}}},"WalletIdentity":{"type":"object","required":["address","displayName","name","kind","names","sources","checkedAt","status"],"properties":{"address":{"$ref":"#/components/schemas/Address"},"entity":{"anyOf":[{"$ref":"#/components/schemas/ExchangeEntity"},{"type":"null"}],"description":"Known published exchange-wallet attribution, or null when no label is known. Not a solvency assessment or proof of ownership on other networks."},"referenceRank":{"type":["object","null"],"description":"Last-recorded external social rank for this exact address, not a net-worth rank.","properties":{"rank":{"type":"integer","minimum":1},"observedAt":{"type":"string","format":"date-time"},"ranking":{"type":"string"},"sourceUrl":{"type":"string","format":"uri"}}},"degenScoreRank":{"type":"null","description":"No verified rank currently available. Null does not mean unranked."},"displayName":{"type":"string"},"name":{"type":["string","null"]},"kind":{"enum":["address","ens","hl"]},"status":{"enum":["verified","unnamed","partial","unavailable","pending"]},"checkedAt":{"type":"string","format":"date-time"},"avatarUrl":{"type":"string","description":"Optional same-origin profile image URL for a confirmed primary ENS name. Images may fall back when unavailable."},"names":{"type":"array","items":{"type":"object","required":["name","kind","primary","verification","provider","resolvedAt"],"properties":{"name":{"type":"string"},"kind":{"enum":["ens","hl"]},"primary":{"type":"boolean"},"verification":{"enum":["forward","forward-and-reverse"]},"provider":{"type":"string"},"resolvedAt":{"type":"string","format":"date-time"},"ttlSeconds":{"type":"integer","minimum":0},"sourceKind":{"enum":["ens","hl"],"description":"Discovery source; a bridged HL name can be confirmed through ENS reverse resolution."},"checkedAt":{"type":"string","format":"date-time"},"cacheExpiresAt":{"type":"string","format":"date-time","description":"Display observation reuse deadline, not a guarantee the name cannot change."},"registrationExpiresAt":{"type":["string","null"],"format":"date-time","description":"Earliest known applicable ENS registration/subname expiry, or null when unavailable."}}}},"sources":{"type":"array","items":{"type":"object","required":["kind","status"],"properties":{"kind":{"enum":["ens","hl"]},"status":{"enum":["verified","not-found","unavailable","pending"]},"checkedAt":{"type":"string","format":"date-time"},"cacheExpiresAt":{"type":"string","format":"date-time"}}}}}},"CompatNftHolding":{"type":"object","required":["id","contract_id","inner_id","chain","name","description","content_type","content","detail_url","contract_name","is_erc1155","amount","protocol","pay_token","usd_price","collection_id","attributes"],"properties":{"id":{"type":"string"},"contract_id":{"$ref":"#/components/schemas/Address"},"inner_id":{"type":"string"},"chain":{"enum":["eth","op"]},"name":{"type":"string"},"description":{"type":"string"},"content_type":{"enum":["image_url",null]},"content":{"type":["string","null"]},"detail_url":{"type":"string"},"contract_name":{"type":"string"},"is_erc1155":{"type":"boolean"},"amount":{"type":"number"},"protocol":{"type":"null"},"pay_token":{"type":"null"},"usd_price":{"type":"null"},"collection_id":{"type":"string"},"attributes":{"type":"array","items":{"type":"object","properties":{"trait_type":{"type":"string"},"value":{"type":"string"}}}}}},"NftHolding":{"type":"object","required":["id","contract","tokenId","chain","type","amount","name","collection","imageUrl","marketplaceUrl","attributes"],"properties":{"id":{"type":"string"},"contract":{"$ref":"#/components/schemas/Address"},"tokenId":{"type":"string","description":"Exact unsigned token ID; keep as a string."},"chain":{"enum":["eth","op"]},"type":{"enum":["ERC-721","ERC-1155"]},"amount":{"type":"string","description":"Exact integer edition quantity."},"name":{"type":"string"},"collection":{"type":"string"},"description":{"type":"string"},"trustedCollection":{"type":"boolean"},"imageUrl":{"type":["string","null"],"description":"Splash-relative image path such as /v1/nft/images/{id}, or null. Resolve against the API base URL."},"marketplaceUrl":{"type":"string","description":"External marketplace page, separate from the Splash image URL."},"attributes":{"type":"array","items":{"type":"object","properties":{"trait_type":{"type":"string"},"value":{"type":"string"}}}}}},"NftGallery":{"type":"object","required":["address","chain","chains","fetchedAt","blockNumber","complete","items","nextCursor","moreAvailable","ownershipChecksComplete","excludedFromPortfolioValue"],"properties":{"address":{"$ref":"#/components/schemas/Address"},"chain":{"enum":["eth","op"]},"chains":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":"string"}}}},"fetchedAt":{"type":"string","format":"date-time"},"blockNumber":{"type":["string","null"]},"complete":{"type":"boolean"},"items":{"type":"array","maxItems":50,"items":{"$ref":"#/components/schemas/NftHolding"}},"nextCursor":{"type":["string","null"]},"moreAvailable":{"type":"boolean"},"ownershipChecksComplete":{"type":"boolean"},"excludedFromPortfolioValue":{"const":true}}},"LeaderboardIdentity":{"type":"object","required":["address","displayName","name","kind","names","sources","status"],"properties":{"address":{"$ref":"#/components/schemas/Address"},"entity":{"anyOf":[{"$ref":"#/components/schemas/ExchangeEntity"},{"type":"null"}],"description":"Known published exchange-wallet attribution, or null when no label is known. Not a solvency assessment or proof of ownership on other networks."},"referenceRank":{"type":["object","null"],"description":"Last-recorded external social rank for this exact address, not a net-worth rank.","properties":{"rank":{"type":"integer","minimum":1},"observedAt":{"type":"string","format":"date-time"},"ranking":{"type":"string"},"sourceUrl":{"type":"string","format":"uri"}}},"degenScoreRank":{"type":"null","description":"No verified rank currently available. Null does not mean unranked."},"displayName":{"type":"string"},"name":{"type":["string","null"]},"kind":{"enum":["address","ens","hl"]},"status":{"enum":["verified","unnamed","partial","unavailable","pending"]},"checkedAt":{"type":"string","format":"date-time"},"avatarUrl":{"type":"string","description":"Optional same-origin profile image URL for a confirmed primary ENS name. Images may fall back when unavailable."},"names":{"type":"array","items":{"type":"object","required":["name","kind","primary","verification","provider","resolvedAt"],"properties":{"name":{"type":"string"},"kind":{"enum":["ens","hl"]},"primary":{"type":"boolean"},"verification":{"enum":["forward","forward-and-reverse"]},"provider":{"type":"string"},"resolvedAt":{"type":"string","format":"date-time"},"ttlSeconds":{"type":"integer","minimum":0},"sourceKind":{"enum":["ens","hl"],"description":"Discovery source; a bridged HL name can be confirmed through ENS reverse resolution."},"checkedAt":{"type":"string","format":"date-time"},"cacheExpiresAt":{"type":"string","format":"date-time","description":"Display observation reuse deadline, not a guarantee the name cannot change."},"registrationExpiresAt":{"type":["string","null"],"format":"date-time","description":"Earliest known applicable ENS registration/subname expiry, or null when unavailable."}}}},"sources":{"type":"array","items":{"type":"object","required":["kind","status"],"properties":{"kind":{"enum":["ens","hl"]},"status":{"enum":["verified","not-found","unavailable","pending"]},"checkedAt":{"type":"string","format":"date-time"},"cacheExpiresAt":{"type":"string","format":"date-time"}}}}}},"LeaderboardWatchlist":{"type":"object","required":["version","kind","valuationScope","entries","refreshEverySeconds","page","pageSize","pageCount","totalEntries","matchedEntries","query"],"properties":{"version":{"const":3},"kind":{"const":"leaderboard"},"valuationScope":{"type":"string"},"refreshEverySeconds":{"const":3600,"description":"Most frequent scheduled update target. Read each entry's refreshEverySeconds for its current window."},"page":{"type":"integer","minimum":1},"pageSize":{"const":20},"pageCount":{"type":"integer","minimum":1},"totalEntries":{"type":"integer","minimum":0},"matchedEntries":{"type":"integer","minimum":0},"query":{"type":"string"},"entries":{"type":"array","maxItems":20,"items":{"type":"object","required":["rank","address","netWorthUsd","valueObservedAt","valueMethod","valuationComplete","stale","refreshFailed","protocols","allocationBasis","identity","refreshEverySeconds"],"properties":{"rank":{"type":"integer","minimum":1,"description":"Position in the whole leaderboard, retained in filtered results."},"address":{"$ref":"#/components/schemas/Address"},"netWorthUsd":{"type":["string","null"],"pattern":"^-?\\d+(?:\\.\\d+)?$","maxLength":2048,"description":"Known wallet-plus-net-position USD value, or null before the first observation. May be negative. Check valuationComplete before treating it as a total."},"valueObservedAt":{"type":["string","null"],"format":"date-time","description":"Original observation time, unchanged on repeated reads; null before the first value."},"valueMethod":{"enum":["splash-portfolio","not-observed"]},"valuationComplete":{"type":"boolean","description":"False for incomplete, expired or failed-update observations."},"stale":{"type":"boolean","description":"True when the observation has reached this entry's refreshEverySeconds window."},"refreshFailed":{"type":"boolean","description":"The latest leaderboard update failed; any previous value is retained."},"identity":{"type":["object","null"]},"lookupHint":{"type":"string"},"entity":{"anyOf":[{"$ref":"#/components/schemas/ExchangeEntity"},{"type":"null"}]},"referenceRank":{"type":["object","null"],"description":"Last-recorded external social rank, independent of the net-value rank. Null means no recorded rank, not proof that the wallet is unranked.","required":["rank","observedAt","ranking","sourceUrl"],"properties":{"rank":{"type":"integer","minimum":1},"observedAt":{"type":"string","format":"date-time"},"ranking":{"const":"web3-social"},"sourceUrl":{"type":"string","format":"uri"}}},"refreshEverySeconds":{"type":"integer","enum":[3600,14400],"description":"Target refresh interval in seconds. Check observation time and status for freshness."},"allocationBasis":{"const":"positive-net-balances"},"protocols":{"type":"array","maxItems":100,"items":{"type":"object","required":["family","name","netValueUsd"],"properties":{"family":{"type":"string"},"name":{"type":"string"},"netValueUsd":{"type":"string","description":"Signed net value in USD. All protocol entries sum to the portfolio estimate; Other includes remaining value and rounding."}}}}}}},"refreshPolicy":{"type":"object","properties":{"topWallets":{"const":32},"topEverySeconds":{"const":3600},"otherEverySeconds":{"const":14400}}}}}}}}