{"openapi":"3.1.0","info":{"title":"Token API","description":"Power your apps & AI agents with real-time token data.","version":"3.17.3+3010390 (2026-05-08)"},"servers":[{"url":"https://token-api.thegraph.com/","description":"Token API - Remote"}],"tags":[{"name":"Documentation"},{"name":"SVM Tokens"},{"name":"SVM Tokens (Native)"},{"name":"SVM DEXs"},{"name":"EVM Tokens (ERC-20)"},{"name":"EVM Tokens (Native)"},{"name":"EVM DEXs"},{"name":"EVM NFTs"},{"name":"TVM Tokens (ERC-20)"},{"name":"TVM Tokens (Native)"},{"name":"TVM DEXs"},{"name":"Polymarket Markets"},{"name":"Polymarket Platform"},{"name":"Polymarket Users"},{"name":"Hyperliquid Markets"},{"name":"Hyperliquid Users"},{"name":"Hyperliquid Vaults"},{"name":"Hyperliquid Platform"},{"name":"Monitoring"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"},"apiKeyAuth":{"type":"apiKey","in":"header","name":"X-Api-Key"}}},"paths":{"/v1/svm/transfers":{"get":{"operationId":"getV1SvmTransfers","summary":"Token Transfers","description":"Returns SPL token transfers with program, authority, and account information.","tags":["SVM Tokens"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"block_num":{"type":"number"},"datetime":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"timestamp":{"type":"number"},"signature":{"type":"string"},"transaction_index":{"type":"number"},"instruction_index":{"type":"number"},"stack_height":{"type":"number"},"signer":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by address","example":"So11111111111111111111111111111111111111112"},"signers":{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by address","example":"So11111111111111111111111111111111111111112"}},"fee":{"type":"number"},"compute_units_consumed":{"type":"number"},"program_id":{"description":"Filter by SPL token program ID","example":"TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb","type":"string","enum":["11111111111111111111111111111111","TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb","TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"]},"mint":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by mint address","example":"pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"},"source":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by address","example":"So11111111111111111111111111111111111111112"},"destination":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by address","example":"So11111111111111111111111111111111111111112"},"authority":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by authority address","example":"GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9"},"multisig_authority":{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by authority address","example":"GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9"}},"amount":{"type":"string"},"value":{"type":"number"},"decimals":{"anyOf":[{"type":"number"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"uri":{"anyOf":[{"type":"string"},{"type":"null"}]},"metadata":{"anyOf":[{"type":"string"},{"type":"null"}]},"network":{"description":"The Graph Network ID for SVM networks https://thegraph.com/networks","example":"solana","type":"string","enum":["solana"]}},"required":["block_num","datetime","timestamp","signature","transaction_index","instruction_index","stack_height","signer","signers","fee","compute_units_consumed","program_id","mint","source","destination","authority","multisig_authority","amount","value","decimals","name","symbol","uri","metadata","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"block_num":413069155,"datetime":"2026-04-14 02:08:00","timestamp":1776132480,"signature":"2HZjoVC9q35EoBDn8z6DfE7jtiua4cZiqBtmpc86cXTF1EoRwK8JPQM9SbTPMhnBMsTk32jtcGQ3sgpKCDK8jULv","transaction_index":171,"instruction_index":2,"stack_height":2,"fee_payer":"3ghZcDUBHDGbgKPzmNnDXpAPb7gp2ApfkRtPWqRrGNTo","signer":"3ghZcDUBHDGbgKPzmNnDXpAPb7gp2ApfkRtPWqRrGNTo","signers":["3ghZcDUBHDGbgKPzmNnDXpAPb7gp2ApfkRtPWqRrGNTo"],"fee":5000,"compute_units_consumed":55785,"program_id":"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA","mint":"So11111111111111111111111111111111111111112","source":"AtpmmidnYUTC1w62zHXfeXygDFQG8H2CU2fseFLwHiat","destination":"GMKAWHL8TKcaDEHoCEkqxSS9QxCppZStXqdF4p4sbLhu","authority":"3ghZcDUBHDGbgKPzmNnDXpAPb7gp2ApfkRtPWqRrGNTo","multisig_authority":[],"amount":"1947170680","network":"solana"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"solana","type":"string","enum":["solana"]},"required":true,"description":"The Graph Network ID for SVM networks https://thegraph.com/networks"},{"in":"query","name":"signature","schema":{"type":"string","format":"svm-signature","pattern":"^[1-9A-HJ-NP-Za-km-z]{87,88}$","example":"4Xj7G5UWDKWbPEKTMie8adzPD27qGRYLE9hpYwuad228Tw96aVBMqhc4XG5daAeLrJXGAqRnQw8Cbi129dQfynAd","anyOf":[{"type":"string","format":"svm-signature","pattern":"^[1-9A-HJ-NP-Za-km-z]{87,88}$","description":"Filter by transaction signature","example":"5pdoVcSiSBr3LMAijdRYKrL5RoLFjLgHxHbZ34dUBVubnsQt3q1v48LuPazebsSiBVuSbSTyJdzf3G9jqqn8o6jA"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-signature","pattern":"^[1-9A-HJ-NP-Za-km-z]{87,88}$","description":"Filter by transaction signature","example":"5pdoVcSiSBr3LMAijdRYKrL5RoLFjLgHxHbZ34dUBVubnsQt3q1v48LuPazebsSiBVuSbSTyJdzf3G9jqqn8o6jA"}}]},"description":"Filter by transaction signature<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"mint","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"So11111111111111111111111111111111111111112","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by mint address","example":"pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by mint address","example":"pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"}}]},"description":"Filter by mint address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"source","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"HuxWhQJLCvuuSzHuBkHX1PVJ2LrpVz8GnTCaEkMRKgM1","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by token account address"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by token account address"}}]},"description":"Filter by token account address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"destination","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"AtpmmidnYUTC1w62zHXfeXygDFQG8H2CU2fseFLwHiat","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by token account address"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by token account address"}}]},"description":"Filter by token account address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"program_id","schema":{"example":"TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb","anyOf":[{"description":"Filter by SPL token program ID","example":"TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb","type":"string","enum":["11111111111111111111111111111111","TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb","TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"]},{"type":"string"},{"type":"array","items":{"description":"Filter by SPL token program ID","example":"TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb","type":"string","enum":["11111111111111111111111111111111","TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb","TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"]}}]},"description":"Filter by SPL token program ID<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"authority","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"HFqU5x63VTqvQss8hp11i4wVV8bD44PvwucfZ2bU7gRe","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by authority address","example":"GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by authority address","example":"GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9"}}]},"description":"Filter by authority address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"fee_payer","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"3ghZcDUBHDGbgKPzmNnDXpAPb7gp2ApfkRtPWqRrGNTo","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by token account address"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by token account address"}}]},"description":"Filter by token account address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"signer","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"3ghZcDUBHDGbgKPzmNnDXpAPb7gp2ApfkRtPWqRrGNTo","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by token account address"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by token account address"}}]},"description":"Filter by token account address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"start_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"end_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"start_block","schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"Filter by block number"},{"in":"query","name":"end_block","schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"Filter by block number"},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/svm/balances":{"get":{"operationId":"getV1SvmBalances","summary":"Token Balances","description":"Returns SPL token balances for Solana token owners with mint and program data.","tags":["SVM Tokens"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"last_update":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"last_update_block_num":{"type":"number"},"last_update_timestamp":{"type":"number"},"program_id":{"description":"Filter by SPL token program ID","example":"TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb","type":"string","enum":["11111111111111111111111111111111","TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb","TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"]},"owner":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by owner address","example":"GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9"},"token_account":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by token account address"},"mint":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by mint address","example":"pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"},"amount":{"type":"string"},"value":{"type":"number"},"decimals":{"anyOf":[{"type":"number"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"uri":{"anyOf":[{"type":"string"},{"type":"null"}]},"network":{"description":"The Graph Network ID for SVM networks https://thegraph.com/networks","example":"solana","type":"string","enum":["solana"]}},"required":["last_update","last_update_block_num","last_update_timestamp","program_id","owner","token_account","mint","amount","value","decimals","name","symbol","uri","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"last_update":"2025-10-09 02:10:01","last_update_block_num":372132067,"last_update_timestamp":1759975801,"program_id":"TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb","owner":"GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9","token_account":"5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW","mint":"pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn","amount":"85605114004","value":85605.114004,"decimals":6,"name":"Pump","symbol":"PUMP","uri":"https://ipfs.io/ipfs/bafkreibcglldkfdekdkxgumlveoe6qv3pbiceypkwtli33clbzul7leo4m","network":"solana"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"solana","type":"string","enum":["solana"]},"required":true,"description":"The Graph Network ID for SVM networks https://thegraph.com/networks"},{"in":"query","name":"owner","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by owner address","example":"GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by owner address","example":"GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9"}}]},"required":true,"description":"Filter by owner address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"token_account","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by token account address"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by token account address"}}]},"description":"Filter by token account address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"mint","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by mint address","example":"pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by mint address","example":"pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"}}]},"description":"Filter by mint address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"program_id","schema":{"example":"TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb","type":"string","enum":["11111111111111111111111111111111","TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb","TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"]},"description":"Filter by SPL token program ID"},{"in":"query","name":"include_null_balances","schema":{"type":"boolean"},"description":"Include zero/null balances in results"},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/svm/holders":{"get":{"operationId":"getV1SvmHolders","summary":"Token Holders","description":"Returns top token holders ranked by balance.","tags":["SVM Tokens"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"last_update":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"last_update_block_num":{"type":"number"},"last_update_timestamp":{"type":"number"},"program_id":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by program ID","example":"JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4"},"mint":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by mint address","example":"pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"},"owner":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by owner address","example":"GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9"},"token_account":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by token account address"},"amount":{"type":"string"},"value":{"type":"number"},"decimals":{"type":"number"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"uri":{"anyOf":[{"type":"string"},{"type":"null"}]},"network":{"description":"The Graph Network ID for SVM networks https://thegraph.com/networks","example":"solana","type":"string","enum":["solana"]}},"required":["last_update","last_update_block_num","last_update_timestamp","program_id","mint","owner","token_account","amount","value","decimals","name","symbol","uri","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"last_update":"2025-09-17 20:06:47","last_update_block_num":367491952,"last_update_timestamp":1758139607,"owner":"7AN6avKCJPMkXkW8kPwMuHmaWvJeHH69e8rKpLf9rdfk","token_account":"BzWtXFf9HL2GGzMGgcGKRnFjrJiZ8U3FG8BQKTbCzW9s","mint":"pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn","program_id":"TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb","amount":"365461857133582111","value":365461857133.5821,"decimals":6,"name":"Pump","symbol":"PUMP","uri":"https://ipfs.io/ipfs/bafkreibcglldkfdekdkxgumlveoe6qv3pbiceypkwtli33clbzul7leo4m","network":"solana"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"solana","type":"string","enum":["solana"]},"required":true,"description":"The Graph Network ID for SVM networks https://thegraph.com/networks"},{"in":"query","name":"mint","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"So11111111111111111111111111111111111111112"},"required":true,"description":"Filter by mint address"},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/svm/owner":{"get":{"operationId":"getV1SvmOwner","summary":"Account Owner Lookup","description":"Returns owner address of an associated token account (ATA) with closure status.","tags":["SVM Tokens"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"last_update":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"last_update_block_num":{"type":"number"},"last_update_timestamp":{"type":"number"},"account":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by token account address"},"owner":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by owner address","example":"GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9"},"is_closed":{"type":"boolean"},"network":{"description":"The Graph Network ID for SVM networks https://thegraph.com/networks","example":"solana","type":"string","enum":["solana"]}},"required":["last_update","last_update_block_num","last_update_timestamp","account","owner","is_closed","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"last_update":"2025-07-14 17:17:19","last_update_block_num":353288878,"last_update_timestamp":1752513439,"account":"5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW","owner":"GXYBNgyYKbSLr938VJCpmGLCUaAHWsncTi7jDoQSdFR9","is_closed":false,"network":"solana"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"solana","type":"string","enum":["solana"]},"required":true,"description":"The Graph Network ID for SVM networks https://thegraph.com/networks"},{"in":"query","name":"account","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"5UZfa66rzeDpD9wKs3Sn3iewmavxYvpAtiF2Lqd2n1wW","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by token account address"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by token account address"}}]},"required":true,"description":"Filter by token account address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/svm/tokens":{"get":{"operationId":"getV1SvmTokens","summary":"Token Metadata","description":"Provides SVM token contract metadata.","tags":["SVM Tokens"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"last_update":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"last_update_block_num":{"type":"number"},"last_update_timestamp":{"type":"number"},"program_id":{"description":"Filter by SPL token program ID","example":"TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb","type":"string","enum":["11111111111111111111111111111111","TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb","TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"]},"mint":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by mint address","example":"pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"},"decimals":{"anyOf":[{"type":"number"},{"type":"null"}]},"circulating_supply":{"type":"number"},"holders":{"type":"number"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"uri":{"anyOf":[{"type":"string"},{"type":"null"}]},"network":{"type":"string"}},"required":["last_update","last_update_block_num","last_update_timestamp","program_id","mint","decimals","circulating_supply","holders","name","symbol","uri","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"last_update":"2026-04-15 18:17:13","last_update_block_num":413435645,"last_update_timestamp":1776277033,"program_id":"TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA","mint":"So11111111111111111111111111111111111111112","circulating_supply":3549470253.660017,"holders":30220960,"decimals":9,"name":"Wrapped SOL","symbol":"SOL","uri":"","network":"solana"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"solana","type":"string","enum":["solana"]},"required":true,"description":"The Graph Network ID for SVM networks https://thegraph.com/networks"},{"in":"query","name":"mint","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"So11111111111111111111111111111111111111112","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by mint address","example":"pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by mint address","example":"pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"}}]},"description":"Filter by mint address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."}]}},"/v1/svm/transfers/native":{"get":{"operationId":"getV1SvmTransfersNative","summary":"Native Transfers","description":"Returns Native transfers with transaction and block data.","tags":["SVM Tokens (Native)"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"block_num":{"type":"number"},"datetime":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"timestamp":{"type":"number"},"signature":{"type":"string"},"transaction_index":{"type":"number"},"instruction_index":{"type":"number"},"stack_height":{"type":"number"},"fee_payer":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by address","example":"So11111111111111111111111111111111111111112"},"signer":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by address","example":"So11111111111111111111111111111111111111112"},"signers":{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by address","example":"So11111111111111111111111111111111111111112"}},"fee":{"type":"number"},"compute_units_consumed":{"type":"number"},"program_id":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by address","example":"11111111111111111111111111111111"},"mint":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by address","example":"So11111111111111111111111111111111111111111"},"source":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by address","example":"So11111111111111111111111111111111111111112"},"destination":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by address","example":"So11111111111111111111111111111111111111112"},"amount":{"type":"string"},"value":{"type":"number"},"decimals":{"anyOf":[{"type":"number"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"network":{"description":"The Graph Network ID for SVM networks https://thegraph.com/networks","example":"solana","type":"string","enum":["solana"]}},"required":["block_num","datetime","timestamp","signature","transaction_index","instruction_index","stack_height","fee_payer","signer","signers","fee","compute_units_consumed","program_id","mint","source","destination","amount","value","decimals","name","symbol","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"block_num":411665924,"datetime":"2026-04-07 16:17:08","timestamp":1775578628,"signature":"5wzpiQF3tjfyk94V7vpwVSeFBvZk8B7mNXEsBdKcX2cAkgY2m7xFQQ4eas7GHEqVdPHgKc1dJoak89hQP2JwMPjK","transaction_index":409,"instruction_index":0,"stack_height":0,"program_id":"11111111111111111111111111111111","source":"BMnT51N4iSNhWU5PyFFgWwFvN1jgaiiDr9ZHgnkm3iLJ","destination":"HFqU5x63VTqvQss8hp11i4wVV8bD44PvwucfZ2bU7gRe","fee_payer":"BMnT51N4iSNhWU5PyFFgWwFvN1jgaiiDr9ZHgnkm3iLJ","signer":"BMnT51N4iSNhWU5PyFFgWwFvN1jgaiiDr9ZHgnkm3iLJ","signers":["BMnT51N4iSNhWU5PyFFgWwFvN1jgaiiDr9ZHgnkm3iLJ"],"amount":"4182522","value":0.004182522,"decimals":9,"name":"Native","symbol":"SOL","fee":5000,"compute_units_consumed":27160,"network":"solana"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"solana","type":"string","enum":["solana"]},"required":true,"description":"The Graph Network ID for SVM networks https://thegraph.com/networks"},{"in":"query","name":"signature","schema":{"type":"string","format":"svm-signature","pattern":"^[1-9A-HJ-NP-Za-km-z]{87,88}$","example":"5wzpiQF3tjfyk94V7vpwVSeFBvZk8B7mNXEsBdKcX2cAkgY2m7xFQQ4eas7GHEqVdPHgKc1dJoak89hQP2JwMPjK","anyOf":[{"type":"string","format":"svm-signature","pattern":"^[1-9A-HJ-NP-Za-km-z]{87,88}$","description":"Filter by transaction signature","example":"5pdoVcSiSBr3LMAijdRYKrL5RoLFjLgHxHbZ34dUBVubnsQt3q1v48LuPazebsSiBVuSbSTyJdzf3G9jqqn8o6jA"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-signature","pattern":"^[1-9A-HJ-NP-Za-km-z]{87,88}$","description":"Filter by transaction signature","example":"5pdoVcSiSBr3LMAijdRYKrL5RoLFjLgHxHbZ34dUBVubnsQt3q1v48LuPazebsSiBVuSbSTyJdzf3G9jqqn8o6jA"}}]},"description":"Filter by transaction signature<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"source","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"BMnT51N4iSNhWU5PyFFgWwFvN1jgaiiDr9ZHgnkm3iLJ","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by token account address"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by token account address"}}]},"description":"Filter by token account address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"destination","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"HFqU5x63VTqvQss8hp11i4wVV8bD44PvwucfZ2bU7gRe","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by token account address"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by token account address"}}]},"description":"Filter by token account address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"fee_payer","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"BMnT51N4iSNhWU5PyFFgWwFvN1jgaiiDr9ZHgnkm3iLJ","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by token account address"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by token account address"}}]},"description":"Filter by token account address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"signer","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"BMnT51N4iSNhWU5PyFFgWwFvN1jgaiiDr9ZHgnkm3iLJ","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by token account address"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by token account address"}}]},"description":"Filter by token account address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"start_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"end_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"start_block","schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"Filter by block number"},{"in":"query","name":"end_block","schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"Filter by block number"},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/svm/balances/native":{"get":{"operationId":"getV1SvmBalancesNative","summary":"Native Balances","description":"Returns SOL native balances for wallet addresses.","tags":["SVM Tokens (Native)"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"last_update":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"last_update_block_num":{"type":"number"},"last_update_timestamp":{"type":"number"},"program_id":{"description":"Filter by SPL token program ID","example":"TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb","type":"string","enum":["11111111111111111111111111111111","TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb","TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"]},"address":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by address","example":"So11111111111111111111111111111111111111112"},"mint":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by mint address","example":"pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"},"amount":{"type":"string"},"value":{"type":"number"},"decimals":{"anyOf":[{"type":"number"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"network":{"description":"The Graph Network ID for SVM networks https://thegraph.com/networks","example":"solana","type":"string","enum":["solana"]}},"required":["last_update","last_update_block_num","last_update_timestamp","program_id","address","mint","amount","value","decimals","name","symbol","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"last_update":"2025-10-16 08:20:15","last_update_block_num":373711220,"last_update_timestamp":1760602815,"program_id":"11111111111111111111111111111111","address":"So11111111111111111111111111111111111111112","mint":"So11111111111111111111111111111111111111111","amount":"1173096711863","value":1173.096711863,"decimals":9,"name":"SOL","symbol":"SOL","network":"solana"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"solana","type":"string","enum":["solana"]},"required":true,"description":"The Graph Network ID for SVM networks https://thegraph.com/networks"},{"in":"query","name":"address","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"So11111111111111111111111111111111111111112","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by address","example":"So11111111111111111111111111111111111111112"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by address","example":"So11111111111111111111111111111111111111112"}}]},"required":true,"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"include_null_balances","schema":{"type":"boolean"},"description":"Include zero/null balances in results"},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/svm/holders/native":{"get":{"operationId":"getV1SvmHoldersNative","summary":"Native Holders","description":"Returns top token holders ranked by Native balance.","tags":["SVM Tokens (Native)"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"last_update":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"last_update_block_num":{"type":"number"},"last_update_timestamp":{"type":"number"},"program_id":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by program ID","example":"JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4"},"mint":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by mint address","example":"pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"},"token_account":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by token account address"},"amount":{"type":"string"},"value":{"type":"number"},"decimals":{"type":"number"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"network":{"description":"The Graph Network ID for SVM networks https://thegraph.com/networks","example":"solana","type":"string","enum":["solana"]}},"required":["last_update","last_update_block_num","last_update_timestamp","program_id","mint","token_account","amount","value","decimals","name","symbol","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"last_update":"2026-04-14 05:23:33","last_update_block_num":413099031,"last_update_timestamp":1776144213,"program_id":"11111111111111111111111111111111","mint":"So11111111111111111111111111111111111111111","token_account":"9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM","amount":"15742688816057762","value":15742688.816057762,"decimals":9,"name":"SOL","symbol":"SOL","network":"solana"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"solana","type":"string","enum":["solana"]},"required":true,"description":"The Graph Network ID for SVM networks https://thegraph.com/networks"},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/svm/tokens/native":{"get":{"operationId":"getV1SvmTokensNative","summary":"Native Metadata","description":"Returns Native metadata including supply and holder count.","tags":["SVM Tokens (Native)"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"last_update":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"last_update_block_num":{"type":"number"},"last_update_timestamp":{"type":"number"},"program_id":{"description":"Filter by SPL token program ID","example":"TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb","type":"string","enum":["11111111111111111111111111111111","TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb","TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA"]},"mint":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by mint address","example":"pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"},"decimals":{"anyOf":[{"type":"number"},{"type":"null"}]},"circulating_supply":{"type":"number"},"holders":{"type":"number"},"name":{"type":"string"},"symbol":{"type":"string"},"network":{"type":"string"}},"required":["last_update","last_update_block_num","last_update_timestamp","program_id","mint","decimals","circulating_supply","holders","name","symbol","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"last_update":"2026-04-15 18:15:06","last_update_block_num":413435325,"last_update_timestamp":1776276906,"program_id":"11111111111111111111111111111111","mint":"So11111111111111111111111111111111111111111","decimals":9,"circulating_supply":655531029.8522874,"holders":1115989639,"name":"Native","symbol":"SOL","network":"solana"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"solana","type":"string","enum":["solana"]},"required":true,"description":"The Graph Network ID for SVM networks https://thegraph.com/networks"}]}},"/v1/svm/swaps":{"get":{"operationId":"getV1SvmSwaps","summary":"Swap Events","description":"Returns AMM swap events from Solana DEXs with input/output tokens and amounts.","tags":["SVM DEXs"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"block_num":{"type":"number"},"datetime":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"timestamp":{"type":"number"},"signature":{"type":"string","format":"svm-signature","pattern":"^[1-9A-HJ-NP-Za-km-z]{87,88}$","description":"Filter by transaction signature","example":"5pdoVcSiSBr3LMAijdRYKrL5RoLFjLgHxHbZ34dUBVubnsQt3q1v48LuPazebsSiBVuSbSTyJdzf3G9jqqn8o6jA"},"transaction_index":{"type":"number"},"instruction_index":{"type":"number"},"stack_height":{"type":"number"},"fee_payer":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by address","example":"So11111111111111111111111111111111111111112"},"signer":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by address","example":"So11111111111111111111111111111111111111112"},"signers":{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by address","example":"So11111111111111111111111111111111111111112"}},"fee":{"type":"number"},"compute_units_consumed":{"type":"number"},"program_id":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by program ID","example":"JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4"},"program_name":{"type":"string"},"amm":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by AMM address","example":"675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8"},"amm_pool":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by AMM pool address","example":"AmmpSnW5xVeKHTAU9fMjyKEMPgrzmUj3ah5vgvHhAB5J"},"input_token":{"type":"object","properties":{"address":{"anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by address","example":"So11111111111111111111111111111111111111112"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"decimals":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["address","symbol","decimals"]},"output_token":{"type":"object","properties":{"address":{"anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by address","example":"So11111111111111111111111111111111111111112"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"decimals":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["address","symbol","decimals"]},"user":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by address","example":"So11111111111111111111111111111111111111112"},"input_mint":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by mint address","example":"pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"},"input_amount":{"type":"string"},"input_value":{"type":"number"},"output_mint":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by mint address","example":"pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"},"output_amount":{"type":"string"},"output_value":{"type":"number"},"protocol":{"description":"Protocol name","example":"raydium_amm_v4","type":"string","enum":["jupiter_v4","jupiter_v6","pumpfun","pumpfun_amm","raydium_amm_v4","raydium_clmm","raydium_cpmm","raydium_launchpad","meteora_daam","meteora_dlmm","meteora_amm","orca_whirlpool","boop","byreal","darklake","dumpfun","moonshot","pancakeswap","spl_token_swap","okx_dex"]},"summary":{"type":"string"},"network":{"description":"The Graph Network ID for SVM networks https://thegraph.com/networks","example":"solana","type":"string","enum":["solana"]}},"required":["block_num","datetime","timestamp","signature","transaction_index","instruction_index","stack_height","fee_payer","signer","signers","fee","compute_units_consumed","program_id","program_name","amm","amm_pool","input_token","output_token","user","input_mint","input_amount","input_value","output_mint","output_amount","output_value","protocol","summary","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"block_num":413234732,"datetime":"2026-04-14 20:14:22","timestamp":1776197662,"signature":"2NJ58GcdxigtZGba2hoodBU88Sb69U7NzF5XM1AgnnUaeNNXVkzmwrNKsm1L5bfgzWuy6qdUmDkDLPd2njpAFY7s","transaction_index":5,"instruction_index":0,"stack_height":2,"fee_payer":"5sk1rcXG9cJmdEvSa6Z2SwU8JehfvGVzN269yADA248v","signer":"5sk1rcXG9cJmdEvSa6Z2SwU8JehfvGVzN269yADA248v","signers":["5sk1rcXG9cJmdEvSa6Z2SwU8JehfvGVzN269yADA248v"],"fee":6000,"compute_units_consumed":104279,"program_id":"JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4","program_name":"Jupiter Aggregator v6","amm":"HpNfyc2Saw7RKkQd8nEL4khUcuPhQ7WwY1B2qjx8jxFq","amm_pool":"","input_token":{"address":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","symbol":"USDC","decimals":6},"output_token":{"address":"So11111111111111111111111111111111111111112","symbol":"SOL","decimals":9},"user":"5sk1rcXG9cJmdEvSa6Z2SwU8JehfvGVzN269yADA248v","input_mint":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","input_amount":"11880","input_value":0.01188,"output_mint":"So11111111111111111111111111111111111111112","output_amount":"141217","output_value":0.000141217,"protocol":"jupiter_v6","summary":"Swap 0.01188 USDC for 0.000141217 SOL on Jupiter V6","network":"solana"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"solana","type":"string","enum":["solana"]},"required":true,"description":"The Graph Network ID for SVM networks https://thegraph.com/networks"},{"in":"query","name":"signature","schema":{"type":"string","format":"svm-signature","pattern":"^[1-9A-HJ-NP-Za-km-z]{87,88}$","example":"5pdoVcSiSBr3LMAijdRYKrL5RoLFjLgHxHbZ34dUBVubnsQt3q1v48LuPazebsSiBVuSbSTyJdzf3G9jqqn8o6jA","anyOf":[{"type":"string","format":"svm-signature","pattern":"^[1-9A-HJ-NP-Za-km-z]{87,88}$","description":"Filter by transaction signature","example":"5pdoVcSiSBr3LMAijdRYKrL5RoLFjLgHxHbZ34dUBVubnsQt3q1v48LuPazebsSiBVuSbSTyJdzf3G9jqqn8o6jA"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-signature","pattern":"^[1-9A-HJ-NP-Za-km-z]{87,88}$","description":"Filter by transaction signature","example":"5pdoVcSiSBr3LMAijdRYKrL5RoLFjLgHxHbZ34dUBVubnsQt3q1v48LuPazebsSiBVuSbSTyJdzf3G9jqqn8o6jA"}}]},"description":"Filter by transaction signature<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"amm","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by AMM address","example":"675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by AMM address","example":"675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8"}}]},"description":"Filter by AMM address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"amm_pool","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by AMM pool address","example":"AmmpSnW5xVeKHTAU9fMjyKEMPgrzmUj3ah5vgvHhAB5J"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by AMM pool address","example":"AmmpSnW5xVeKHTAU9fMjyKEMPgrzmUj3ah5vgvHhAB5J"}}]},"description":"Filter by AMM pool address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"user","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"5MGfsuYNRhbuN6x1M6WaR3721dSDGtXpcsHxNsgkjsXC","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by address","example":"So11111111111111111111111111111111111111112"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by address","example":"So11111111111111111111111111111111111111112"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"fee_payer","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"So11111111111111111111111111111111111111112","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by address","example":"So11111111111111111111111111111111111111112"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by address","example":"So11111111111111111111111111111111111111112"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"signer","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"So11111111111111111111111111111111111111112","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by address","example":"So11111111111111111111111111111111111111112"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by address","example":"So11111111111111111111111111111111111111112"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"input_mint","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"HmrzeZapM1EygFc4tBJUXwWTzv5Ahy8axLSAadBx51sw","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by mint address","example":"pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by mint address","example":"pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"}}]},"description":"Filter by mint address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"protocol","schema":{"example":"raydium_amm_v4","type":"string","enum":["jupiter_v4","jupiter_v6","pumpfun","pumpfun_amm","raydium_amm_v4","raydium_clmm","raydium_cpmm","raydium_launchpad","meteora_daam","meteora_dlmm","meteora_amm","orca_whirlpool","boop","byreal","darklake","dumpfun","moonshot","pancakeswap","spl_token_swap","okx_dex"]},"description":"Protocol name"},{"in":"query","name":"output_mint","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by mint address","example":"pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by mint address","example":"pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"}}]},"description":"Filter by mint address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"program_id","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by program ID","example":"JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by program ID","example":"JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4"}}]},"description":"Filter by program ID<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"start_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"end_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"start_block","schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"Filter by block number"},{"in":"query","name":"end_block","schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"Filter by block number"},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/svm/pools":{"get":{"operationId":"getV1SvmPools","summary":"Liquidity Pools","description":"Returns AMM pool information from Solana DEX protocols with transaction counts.","tags":["SVM DEXs"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"program_id":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by program ID","example":"JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4"},"program_name":{"type":"string"},"amm":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by AMM address","example":"675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8"},"amm_name":{"type":"string"},"amm_pool":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by AMM pool address","example":"AmmpSnW5xVeKHTAU9fMjyKEMPgrzmUj3ah5vgvHhAB5J"},"input_mint":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by mint address","example":"pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"},"output_mint":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by mint address","example":"pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"},"transactions":{"type":"number"},"network":{"description":"The Graph Network ID for SVM networks https://thegraph.com/networks","example":"solana","type":"string","enum":["solana"]}},"required":["program_id","program_name","amm","amm_name","amm_pool","input_mint","output_mint","transactions","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"program_id":"675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8","program_name":"Raydium Liquidity Pool V4","protocol":"raydium_amm_v4","amm":"675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8","amm_name":"Raydium Liquidity Pool V4","amm_pool":"Dqb7bL7MZkuDgHrZZphRMRViJnepHxf9odx3RRwmifur","input_mint":"9bJKq2eLbLFKbcD9zYBNTrQ5Pua7hXMeivu7Fk3iWWoQ","output_mint":"Fm34vVNQYoEkenNjCeM8MVP8mBV5EGLwA86WFHwyMcz4","transactions":43062555,"network":"solana"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"solana","type":"string","enum":["solana"]},"required":true,"description":"The Graph Network ID for SVM networks https://thegraph.com/networks"},{"in":"query","name":"amm","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by AMM address","example":"675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by AMM address","example":"675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8"}}]},"description":"Filter by AMM address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"amm_pool","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by AMM pool address","example":"AmmpSnW5xVeKHTAU9fMjyKEMPgrzmUj3ah5vgvHhAB5J"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by AMM pool address","example":"AmmpSnW5xVeKHTAU9fMjyKEMPgrzmUj3ah5vgvHhAB5J"}}]},"description":"Filter by AMM pool address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"mint","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"So11111111111111111111111111111111111111112","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by mint address","example":"pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by mint address","example":"pumpCmXqMfrsAkQ5r49WcJnRayYRqmXz6ae8H7H9Dfn"}}]},"description":"Filter by mint address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"program_id","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4","anyOf":[{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by program ID","example":"JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4"},{"type":"string"},{"type":"array","items":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by program ID","example":"JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4"}}]},"description":"Filter by program ID<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"protocol","schema":{"example":"raydium_amm_v4","type":"string","enum":["pumpfun","pumpfun_amm","raydium_amm_v4","raydium_clmm","raydium_cpmm","raydium_launchpad","meteora_daam","meteora_dlmm","meteora_amm","orca_whirlpool","boop","byreal","darklake","dumpfun","moonshot","pancakeswap","spl_token_swap","okx_dex"]},"description":"Protocol name"},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/svm/pools/ohlc":{"get":{"operationId":"getV1SvmPoolsOhlc","summary":"Pool OHLCV","description":"Provides pricing data in the Open/High/Low/Close/Volume (OHCLV) format for DEX pools.","tags":["SVM DEXs"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"datetime":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"program_id":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by program ID","example":"JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4"},"amm":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by AMM address","example":"675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8"},"amm_pool":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by AMM pool address","example":"AmmpSnW5xVeKHTAU9fMjyKEMPgrzmUj3ah5vgvHhAB5J"},"token0":{"type":"string"},"token0_decimals":{"type":"number"},"token1":{"type":"string"},"token1_decimals":{"type":"number"},"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"},"uaw":{"type":"number"},"transactions":{"type":"number"}},"required":["datetime","program_id","amm","amm_pool","token0","token0_decimals","token1","token1_decimals","open","high","low","close","volume","uaw","transactions"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"datetime":"2025-07-03 00:00:00","amm":"pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA","amm_pool":"AmmpSnW5xVeKHTAU9fMjyKEMPgrzmUj3ah5vgvHhAB5J","token0":"GfMuixkXCBb612QNnPUTG696mn3R7ptnvsK31KN1e3q9","token0_decimals":9,"token1":"So11111111111111111111111111111111111111112","token1_decimals":9,"open":0.12678061315003716,"high":0.12836499025514422,"low":0.12403664449646414,"close":0.12422606595970508,"volume":0.029977608000000003,"uaw":1,"transactions":9}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"solana","type":"string","enum":["solana"]},"required":true,"description":"The Graph Network ID for SVM networks https://thegraph.com/networks"},{"in":"query","name":"amm_pool","schema":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","example":"AmmpSnW5xVeKHTAU9fMjyKEMPgrzmUj3ah5vgvHhAB5J"},"required":true,"description":"Filter by AMM pool address"},{"in":"query","name":"interval","schema":{"type":"string","enum":["1m","5m","10m","30m","1h","4h","1d","1w"],"default":"1d"},"description":"The interval* for which to aggregate price data (1-minute, 5-minutes, 10-minutes, 30-minutes, hourly, 4-hours, daily or weekly).<br>*Plan restricted."},{"in":"query","name":"start_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"end_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/svm/dexes":{"get":{"operationId":"getV1SvmDexes","summary":"Supported DEXs","description":"Returns all supported Solana DEXs.","tags":["SVM DEXs"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"program_id":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by program ID","example":"JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4"},"program_name":{"type":"string"},"amm":{"type":"string","format":"svm-address","pattern":"^[1-9A-HJ-NP-Za-km-z]{32,44}$","description":"Filter by AMM address","example":"675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8"},"amm_name":{"type":"string"},"is_aggregator":{"type":"boolean"},"transactions":{"type":"number"}},"required":["program_id","program_name","amm","amm_name","is_aggregator","transactions"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"program_id":"JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4","program_name":"Jupiter Aggregator v6","amm":"675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8","amm_name":"Raydium Liquidity Pool V4","is_aggregator":true,"transactions":1008573050}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"solana","type":"string","enum":["solana"]},"required":true,"description":"The Graph Network ID for SVM networks https://thegraph.com/networks"},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/evm/transfers":{"get":{"operationId":"getV1EvmTransfers","summary":"Token Transfers","description":"Returns ERC-20 transfers with transaction and block data.","tags":["EVM Tokens (ERC-20)"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"block_num":{"type":"number"},"datetime":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"timestamp":{"type":"number"},"transaction_id":{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$","description":"Filter by transaction hash","example":"0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca"},"contract":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},"from":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"to":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"decimals":{"anyOf":[{"type":"number"},{"type":"null"}]},"amount":{"type":"string"},"value":{"type":"number"},"network":{"description":"The Graph Network ID for EVM networks https://thegraph.com/networks","example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]}},"required":["block_num","datetime","timestamp","transaction_id","contract","from","to","name","symbol","decimals","amount","value","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"block_num":24278225,"datetime":"2026-01-20 19:57:11","timestamp":1768939031,"transaction_id":"0x589cbe12efa0cca5a29b17bf7ee49c99566f0e05e937d54104134a2d916ab265","log_index":24,"contract":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","type":"transfer","from":"0x2393d38400cad1d0ffae85b37d76de05bb7eddc6","to":"0xd4f1171683f1bc07b77d0307a01b64dba5369cf8","name":"USD Coin","symbol":"USDC","decimals":6,"amount":"2686","value":0.002686,"network":"mainnet"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]},"required":true,"description":"The Graph Network ID for EVM networks https://thegraph.com/networks"},{"in":"query","name":"transaction_id","schema":{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$","example":"0x96b1b180d22dae2b18a783ebdd5ae33f6867f3572f87c69a135c6c0a15a63c8e","anyOf":[{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$","description":"Filter by transaction hash","example":"0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$","description":"Filter by transaction hash","example":"0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca"}}]},"description":"Filter by transaction hash<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"contract","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"}}]},"description":"Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"from_address","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"to_address","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xdadb0d80178819f2319190d340ce9a924f783711","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"start_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"end_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"start_block","schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"Filter by block number"},{"in":"query","name":"end_block","schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"Filter by block number"},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/evm/balances":{"get":{"operationId":"getV1EvmBalances","summary":"Token Balances","description":"Returns ERC-20 token balances for a wallet address.","tags":["EVM Tokens (ERC-20)"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"last_update":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"last_update_block_num":{"type":"number"},"last_update_timestamp":{"type":"number"},"address":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"contract":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},"amount":{"type":"string"},"value":{"type":"number"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"decimals":{"anyOf":[{"type":"number"},{"type":"null"}]},"network":{"description":"The Graph Network ID for EVM networks https://thegraph.com/networks","example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]}},"required":["last_update","last_update_block_num","last_update_timestamp","address","contract","amount","value","name","symbol","decimals","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"last_update":"2025-10-08 07:49:47","last_update_block_num":23531651,"last_update_timestamp":1759909787,"address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","contract":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","amount":"17058407780","value":17058.40778,"name":"USD Coin","symbol":"USDC","decimals":6,"network":"mainnet"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]},"required":true,"description":"The Graph Network ID for EVM networks https://thegraph.com/networks"},{"in":"query","name":"address","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"}}]},"required":true,"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"contract","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"}}]},"description":"Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"include_null_balances","schema":{"type":"boolean"},"description":"Include zero/null balances in results"},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/evm/holders":{"get":{"operationId":"getV1EvmHolders","summary":"Token Holders","description":"Returns top token holders ranked by ERC-20 balance.","tags":["EVM Tokens (ERC-20)"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"last_update":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"last_update_block_num":{"type":"number"},"last_update_timestamp":{"type":"number"},"address":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"contract":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},"amount":{"type":"string"},"value":{"type":"number"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"decimals":{"anyOf":[{"type":"number"},{"type":"null"}]},"network":{"description":"The Graph Network ID for EVM networks https://thegraph.com/networks","example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]}},"required":["last_update","last_update_block_num","last_update_timestamp","address","contract","amount","value","name","symbol","decimals","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"last_update":"2026-01-23 06:37:11","last_update_block_num":24295739,"last_update_timestamp":1769150231,"address":"0xf977814e90da44bfa03b6295a0616a897441acec","contract":"0xdac17f958d2ee523a2206206994597c13d831ec7","amount":"20000000000000000","value":20000000000,"name":"Tether USD","symbol":"USDT","decimals":6,"network":"mainnet"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]},"required":true,"description":"The Graph Network ID for EVM networks https://thegraph.com/networks"},{"in":"query","name":"contract","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xdac17f958d2ee523a2206206994597c13d831ec7"},"required":true,"description":"Filter by contract address"},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/evm/tokens":{"get":{"operationId":"getV1EvmTokens","summary":"Token Metadata","description":"Returns ERC-20 token metadata including supply and holder count.","tags":["EVM Tokens (ERC-20)"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"last_update":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"last_update_block_num":{"type":"number"},"last_update_timestamp":{"type":"number"},"contract":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"decimals":{"anyOf":[{"type":"number"},{"type":"null"}]},"circulating_supply":{"type":"number"},"total_supply":{"type":"number"},"holders":{"type":"number"},"total_transfers":{"type":"number"},"network":{"description":"The Graph Network ID for EVM networks https://thegraph.com/networks","example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]},"icon":{"type":"object","properties":{"web3icon":{"type":"string"}},"required":["web3icon"]}},"required":["last_update","last_update_block_num","last_update_timestamp","contract","name","symbol","decimals","circulating_supply","total_supply","holders","total_transfers","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"last_update":"2026-02-13 20:22:47","last_update_block_num":24450218,"last_update_timestamp":1771014167,"contract":"0xdac17f958d2ee523a2206206994597c13d831ec7","circulating_supply":96130932922.42769,"holders":12473360,"total_transfers":430131249,"name":"Tether USD","symbol":"USDT","decimals":6,"network":"mainnet","icon":{"web3icon":"usdt"}}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]},"required":true,"description":"The Graph Network ID for EVM networks https://thegraph.com/networks"},{"in":"query","name":"contract","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xdac17f958d2ee523a2206206994597c13d831ec7","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"}}]},"required":true,"description":"Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."}]}},"/v1/evm/balances/historical":{"get":{"operationId":"getV1EvmBalancesHistorical","summary":"Historical Token Balances","description":"Returns wallet ERC-20 token balance changes over time in OHLCV format.\n\nOHLCV historical depth is subject to plan restrictions.","tags":["EVM Tokens (ERC-20)"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"datetime":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"address":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"contract":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},"decimals":{"type":"number"},"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"network":{"description":"The Graph Network ID for EVM networks https://thegraph.com/networks","example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]}},"required":["datetime","address","contract","decimals","open","high","low","close","name","symbol","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"datetime":"2026-01-09 00:00:00","address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","contract":"0xdac17f958d2ee523a2206206994597c13d831ec7","open":269.18034,"high":269.18034,"low":269.18034,"close":269.18034,"name":"Tether USD","symbol":"USDT","decimals":6,"network":"mainnet"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]},"required":true,"description":"The Graph Network ID for EVM networks https://thegraph.com/networks"},{"in":"query","name":"address","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"required":true,"description":"Filter by address"},{"in":"query","name":"contract","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xdac17f958d2ee523a2206206994597c13d831ec7","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"}}]},"description":"Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"interval","schema":{"type":"string","enum":["1h","4h","1d","1w"],"example":"1d","default":"1d"},"description":"The interval* for which to aggregate price data (hourly, 4-hours, daily or weekly).<br>*Plan restricted."},{"in":"query","name":"start_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"end_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/evm/transfers/native":{"get":{"operationId":"getV1EvmTransfersNative","summary":"Native Transfers","description":"Returns Native transfers with transaction and block data.","tags":["EVM Tokens (Native)"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"block_num":{"type":"number"},"datetime":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"timestamp":{"type":"number"},"transaction_id":{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$","description":"Filter by transaction hash","example":"0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca"},"from":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"to":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"decimals":{"anyOf":[{"type":"number"},{"type":"null"}]},"amount":{"type":"string"},"value":{"type":"number"},"network":{"description":"The Graph Network ID for EVM networks https://thegraph.com/networks","example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]}},"required":["block_num","datetime","timestamp","transaction_id","from","to","name","symbol","decimals","amount","value","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"block_num":24280071,"datetime":"2026-01-21 02:07:35","timestamp":1768961255,"transaction_id":"0x73d346e1d286b893a3a0bb6b022845dc84cded73757b9ad89ae2c958fe266edf","transaction_index":251,"call_index":3,"type":"call","from":"0xd2b37ade14708bf18904047b1e31f8166d39612b","to":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2","name":"Ethereum","symbol":"ETH","decimals":18,"amount":"25000000000000","value":0.000025,"network":"mainnet"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]},"required":true,"description":"The Graph Network ID for EVM networks https://thegraph.com/networks"},{"in":"query","name":"transaction_id","schema":{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$","example":"0xd671e7314849d87f852c3674fd98157f1faf512364640c37ea38e997f67bd088","anyOf":[{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$","description":"Filter by transaction hash","example":"0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$","description":"Filter by transaction hash","example":"0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca"}}]},"description":"Filter by transaction hash<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"from_address","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"to_address","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xdadb0d80178819f2319190d340ce9a924f783711","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"start_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"end_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"start_block","schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"Filter by block number"},{"in":"query","name":"end_block","schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"Filter by block number"},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/evm/balances/native":{"get":{"operationId":"getV1EvmBalancesNative","summary":"Native Balances","description":"Returns EVM native balances for wallet addresses.","tags":["EVM Tokens (Native)"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"last_update":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"last_update_block_num":{"type":"number"},"last_update_timestamp":{"type":"number"},"address":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"amount":{"type":"string"},"value":{"type":"number"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"decimals":{"anyOf":[{"type":"number"},{"type":"null"}]},"network":{"description":"The Graph Network ID for EVM networks https://thegraph.com/networks","example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]}},"required":["last_update","last_update_block_num","last_update_timestamp","address","amount","value","name","symbol","decimals","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"last_update":"2026-01-22 11:00:11","last_update_block_num":24289888,"last_update_timestamp":1769079611,"address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","amount":"32112523848657725248","value":32.11252384865772,"name":"Ethereum","symbol":"ETH","decimals":18,"network":"mainnet"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]},"required":true,"description":"The Graph Network ID for EVM networks https://thegraph.com/networks"},{"in":"query","name":"address","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"}}]},"required":true,"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."}]}},"/v1/evm/holders/native":{"get":{"operationId":"getV1EvmHoldersNative","summary":"Native Holders","description":"Returns top token holders ranked by Native balance.","tags":["EVM Tokens (Native)"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"last_update":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"last_update_block_num":{"type":"number"},"last_update_timestamp":{"type":"number"},"address":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"amount":{"type":"string"},"value":{"type":"number"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"decimals":{"anyOf":[{"type":"number"},{"type":"null"}]},"network":{"description":"The Graph Network ID for EVM networks https://thegraph.com/networks","example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]}},"required":["last_update","last_update_block_num","last_update_timestamp","address","amount","value","name","symbol","decimals","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"last_update":"2026-01-23 20:25:35","last_update_block_num":24299860,"last_update_timestamp":1769199935,"address":"0x00000000219ab540356cbb839cbe05303d7705fa","amount":"78761803578844096172899779","value":78761803.5788441,"name":"Ethereum","symbol":"ETH","decimals":18,"network":"mainnet"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]},"required":true,"description":"The Graph Network ID for EVM networks https://thegraph.com/networks"},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/evm/tokens/native":{"get":{"operationId":"getV1EvmTokensNative","summary":"Native Metadata","description":"Returns Native metadata including supply and holder count.","tags":["EVM Tokens (Native)"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"last_update":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"last_update_block_num":{"type":"number"},"last_update_timestamp":{"type":"number"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"decimals":{"anyOf":[{"type":"number"},{"type":"null"}]},"circulating_supply":{"type":"number"},"total_supply":{"type":"number"},"holders":{"type":"number"},"network":{"description":"The Graph Network ID for EVM networks https://thegraph.com/networks","example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]},"icon":{"type":"object","properties":{"web3icon":{"type":"string"}},"required":["web3icon"]}},"required":["last_update","last_update_block_num","last_update_timestamp","name","symbol","decimals","circulating_supply","total_supply","holders","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"last_update":"2026-01-25 14:19:11","last_update_block_num":24312379,"last_update_timestamp":1769350751,"circulating_supply":161355003.5024305,"holders":176087418,"name":"Ethereum","symbol":"ETH","decimals":18,"network":"mainnet","icon":{"web3icon":"ETH"}}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]},"required":true,"description":"The Graph Network ID for EVM networks https://thegraph.com/networks"}]}},"/v1/evm/balances/historical/native":{"get":{"operationId":"getV1EvmBalancesHistoricalNative","summary":"Historical Native Balances","description":"Returns wallet Native balance changes over time in OHLCV format.\n\nOHLCV historical depth is subject to plan restrictions.","tags":["EVM Tokens (Native)"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"datetime":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"address":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"contract":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},"decimals":{"type":"number"},"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"network":{"description":"The Graph Network ID for EVM networks https://thegraph.com/networks","example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]}},"required":["datetime","address","contract","decimals","open","high","low","close","name","symbol","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"datetime":"2026-01-21 00:00:00","address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","open":33.11251005136684,"high":33.11251115136684,"low":32.11250812040242,"close":32.112509521402416,"name":"Ethereum","symbol":"ETH","decimals":18,"network":"mainnet"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]},"required":true,"description":"The Graph Network ID for EVM networks https://thegraph.com/networks"},{"in":"query","name":"address","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"required":true,"description":"Filter by address"},{"in":"query","name":"interval","schema":{"type":"string","enum":["1h","4h","1d","1w"],"example":"1d","default":"1d"},"description":"The interval* for which to aggregate price data (hourly, 4-hours, daily or weekly).<br>*Plan restricted."},{"in":"query","name":"start_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"end_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/evm/swaps":{"get":{"operationId":"getV1EvmSwaps","summary":"Swap Events","description":"Returns DEX swaps events with input & output token amounts.","tags":["EVM DEXs"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"block_num":{"type":"number"},"datetime":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"timestamp":{"type":"number"},"transaction_id":{"type":"string"},"transaction_index":{"type":"number"},"transaction_from":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Onchain transaction initiator address.","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"call_index":{"anyOf":[{"type":"number"},{"type":"null"}]},"log_index":{"type":"number"},"log_ordinal":{"type":"number"},"log_block_index":{"type":"number"},"log_topic0":{"type":"string"},"factory":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by factory address","example":"0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f"},"pool":{"description":"Filter by pool address","type":"string","example":"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$"},{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$"}]},"input_token":{"type":"object","properties":{"address":{"anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"decimals":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["address","symbol","decimals"]},"output_token":{"type":"object","properties":{"address":{"anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"decimals":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["address","symbol","decimals"]},"caller":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Account or contract that calls the swap-relevant contract.","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"user":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Normalized user-oriented swap address. Prefer this field for integrations; sender and recipient remain legacy compatibility fields and are planned for deprecation in a future major release.","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"sender":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Legacy compatibility field for swap sender semantics. Prefer user for a normalized user-oriented swap address.","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"recipient":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Legacy compatibility field for swap recipient semantics. Prefer user for a normalized user-oriented swap address.","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"input_amount":{"type":"string"},"input_value":{"type":"number"},"output_amount":{"type":"string"},"output_value":{"type":"number"},"price":{"type":"number"},"price_inv":{"type":"number"},"protocol":{"description":"Protocol name","example":"uniswap_v3","type":"string","enum":["uniswap_v1","uniswap_v2","uniswap_v3","uniswap_v4","curvefi","balancer","bancor","cow","aerodrome","dodo","woofi","traderjoe","kyber_elastic"]},"summary":{"type":"string"},"network":{"description":"The Graph Network ID for EVM networks https://thegraph.com/networks","example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]}},"required":["block_num","datetime","timestamp","transaction_id","transaction_index","transaction_from","call_index","log_index","log_ordinal","log_block_index","log_topic0","factory","pool","input_token","output_token","caller","user","sender","recipient","input_amount","input_value","output_amount","output_value","price","price_inv","protocol","summary","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"block_num":23590326,"datetime":"2025-10-16 12:48:47","timestamp":1760618927,"transaction_id":"0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca","transaction_index":143,"transaction_from":"0xa69babef1ca67a37ffaf7a485dfff3382056e78c","call_index":null,"log_ordinal":42,"log_block_index":0,"log_index":42,"log_topic0":"0xc42079f94a6350d7e6235f29174924f928cc2ac818eb64fed8004e115fbcca67","factory":"0x1f98431c8ad98523631ae4a59f267346ea31f984","pool":"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640","input_token":{"address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","symbol":"USDC","decimals":6},"output_token":{"address":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2","symbol":"WETH","decimals":18},"caller":"0xa69babef1ca67a37ffaf7a485dfff3382056e78c","user":"0xa69babef1ca67a37ffaf7a485dfff3382056e78c","sender":"0xa69babef1ca67a37ffaf7a485dfff3382056e78c","recipient":"0xa69babef1ca67a37ffaf7a485dfff3382056e78c","input_amount":"40735537734","input_value":40735.537734,"output_amount":"10042247631260591234","output_value":10.042247631260592,"price":246517483.4798306,"price_inv":4.0565074163667475e-9,"protocol":"uniswap_v3","summary":"Swap 40.74 thousand USDC for 10.042247631260592 WETH on Uniswap V3","network":"mainnet"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]},"required":true,"description":"The Graph Network ID for EVM networks https://thegraph.com/networks"},{"in":"query","name":"transaction_id","schema":{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$","example":"0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca","anyOf":[{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$","description":"Filter by transaction hash","example":"0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$","description":"Filter by transaction hash","example":"0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca"}}]},"description":"Filter by transaction hash<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"factory","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by factory address","example":"0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by factory address","example":"0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f"}}]},"description":"Filter by factory address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"pool","schema":{"type":"string","example":"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640","anyOf":[{"description":"Filter by pool address","type":"string","example":"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$"},{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$"}]},{"type":"string"},{"type":"array","items":{"description":"Filter by pool address","type":"string","example":"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$"},{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$"}]}}]},"description":"Filter by pool address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"caller","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0x7a250d5630b4cf539739df2c5dacb4c659f2488d","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"transaction_from","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0x7a250d5630b4cf539739df2c5dacb4c659f2488d","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"user","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0x7a250d5630b4cf539739df2c5dacb4c659f2488d","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"sender","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0x7a250d5630b4cf539739df2c5dacb4c659f2488d","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"recipient","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0x7a250d5630b4cf539739df2c5dacb4c659f2488d","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"input_contract","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"}}]},"description":"Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"output_contract","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"}}]},"description":"Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"protocol","schema":{"example":"uniswap_v3","type":"string","enum":["uniswap_v1","uniswap_v2","uniswap_v3","uniswap_v4","curvefi","balancer","bancor","cow","aerodrome","dodo","woofi","traderjoe","kyber_elastic"]},"description":"Protocol name"},{"in":"query","name":"start_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"end_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"start_block","schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"Filter by block number"},{"in":"query","name":"end_block","schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"Filter by block number"},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/evm/pools":{"get":{"operationId":"getV1EvmPools","summary":"Liquidity Pools","description":"Returns DEX pool metadata including tokens, fees and protocol.","tags":["EVM DEXs"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"pool":{"description":"Filter by pool address","type":"string","example":"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$"},{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$"}]},"factory":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by factory address","example":"0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f"},"protocol":{"description":"Protocol name","example":"uniswap_v3","type":"string","enum":["uniswap_v1","uniswap_v2","uniswap_v3","uniswap_v4","curvefi","balancer","bancor","cow","aerodrome","dodo","woofi","traderjoe","kyber_elastic"]},"input_token":{"type":"object","properties":{"address":{"anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"decimals":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["address","symbol","decimals"]},"output_token":{"type":"object","properties":{"address":{"anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"decimals":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["address","symbol","decimals"]},"network":{"description":"The Graph Network ID for EVM networks https://thegraph.com/networks","example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]}},"required":["pool","factory","protocol","input_token","output_token","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"pool":"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640","factory":"0x1f98431c8ad98523631ae4a59f267346ea31f984","protocol":"uniswap_v3","input_token":{"address":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","symbol":"USDC","decimals":6},"output_token":{"address":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2","symbol":"WETH","decimals":18},"fee":500,"network":"mainnet"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]},"required":true,"description":"The Graph Network ID for EVM networks https://thegraph.com/networks"},{"in":"query","name":"factory","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0x1f98431c8ad98523631ae4a59f267346ea31f984","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by factory address","example":"0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by factory address","example":"0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f"}}]},"description":"Filter by factory address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"pool","schema":{"type":"string","example":"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640","anyOf":[{"description":"Filter by pool address","type":"string","example":"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$"},{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$"}]},{"type":"string"},{"type":"array","items":{"description":"Filter by pool address","type":"string","example":"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$"},{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$"}]}}]},"description":"Filter by pool address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"input_token","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"}}]},"description":"Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"output_token","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"}}]},"description":"Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"protocol","schema":{"example":"uniswap_v3","type":"string","enum":["uniswap_v1","uniswap_v2","uniswap_v3","uniswap_v4","curvefi","balancer","bancor","cow","aerodrome","dodo","woofi","traderjoe","kyber_elastic"]},"description":"Protocol name"},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/evm/pools/ohlc":{"get":{"operationId":"getV1EvmPoolsOhlc","summary":"Pool OHLCV","description":"Returns OHLCV price data for liquidity pools.\n\nOHLCV historical depth is subject to plan restrictions.","tags":["EVM DEXs"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"datetime":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"ticker":{"type":"string"},"pool":{"description":"Filter by pool address","type":"string","example":"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$"},{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$"}]},"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"},"transactions":{"type":"number"},"network":{"description":"The Graph Network ID for EVM networks https://thegraph.com/networks","example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]}},"required":["datetime","ticker","pool","open","high","low","close","volume","transactions","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"datetime":"2025-10-16 00:00:00","ticker":"USDCWETH","pool":"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640","open":3986.8562193110524,"high":4067.092237083535,"low":3959.52075942394,"close":3989.7646037044765,"volume":32956701.586648002,"transactions":3066,"network":"mainnet"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]},"required":true,"description":"The Graph Network ID for EVM networks https://thegraph.com/networks"},{"in":"query","name":"pool","schema":{"type":"string","example":"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$"},{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$"}]},"required":true,"description":"Filter by pool address"},{"in":"query","name":"interval","schema":{"type":"string","enum":["1m","5m","10m","30m","1h","4h","1d","1w"],"default":"1d"},"description":"The interval* for which to aggregate price data (1-minute, 5-minutes, 10-minutes, 30-minutes, hourly, 4-hours, daily or weekly).<br>*Plan restricted."},{"in":"query","name":"start_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"end_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/evm/dexes":{"get":{"operationId":"getV1EvmDexes","summary":"Supported DEXs","description":"Returns all supported EVM DEXs.","tags":["EVM DEXs"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"factory":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"protocol":{"description":"Protocol name","example":"uniswap_v3","type":"string","enum":["uniswap_v1","uniswap_v2","uniswap_v3","uniswap_v4","curvefi","balancer","bancor","cow","aerodrome","dodo","woofi","traderjoe","kyber_elastic"]},"uaw":{"type":"number"},"transactions":{"type":"number"},"last_activity":{"description":"ISO 8601 datetime string","type":"string"},"network":{"description":"The Graph Network ID for EVM networks https://thegraph.com/networks","example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]}},"required":["factory","protocol","uaw","transactions","last_activity","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"factory":"0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f","protocol":"uniswap_v2","uaw":10432787,"transactions":16029788,"last_activity":"2025-11-06 16:00:00","network":"mainnet"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]},"required":true,"description":"The Graph Network ID for EVM networks https://thegraph.com/networks"},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/evm/nft/collections":{"get":{"operationId":"getV1EvmNftCollections","summary":"NFT Collection","description":"Returns NFT collection metadata, supply stats, owner count, and transfer history.","tags":["EVM NFTs"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"contract_creation":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"contract_creator":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"contract":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"owners":{"type":"number"},"total_supply":{"type":"number"},"total_unique_supply":{"type":"number"},"total_transfers":{"type":"number"},"network":{"description":"The Graph Network ID for EVM networks https://thegraph.com/networks","example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]}},"required":["contract_creation","contract_creator","contract","name","symbol","owners","total_supply","total_unique_supply","total_transfers","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"contract_creation":"2021-07-22 12:26:01","contract_creator":"0xe9da256a28630efdc637bfd4c65f0887be1aeda8","contract":"0xbd3531da5cf5857e7cfaa92426877b022e612cf8","name":"PudgyPenguins","symbol":"PPG","token_standard":"ERC721","owners":4952,"total_supply":8888,"total_unique_supply":8888,"total_transfers":193641,"network":"mainnet"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]},"required":true,"description":"The Graph Network ID for EVM networks https://thegraph.com/networks"},{"in":"query","name":"contract","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xbd3531da5cf5857e7cfaa92426877b022e612cf8"},"required":true,"description":"Filter by contract address"},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/evm/nft/holders":{"get":{"operationId":"getV1EvmNftHolders","summary":"NFT Holders","description":"Returns wallet addresses holding NFT collection tokens with quantity and percentage distribution.","tags":["EVM NFTs"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"contract":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},"token_standard":{"description":"Token standard","example":"ERC721","type":"string","enum":["ERC721","ERC1155"]},"address":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"quantity":{"description":"Number of tokens held by this address","type":"number"},"unique_tokens":{"description":"Number of unique token IDs held by this address","type":"number"},"percentage":{"description":"Percentage of total supply held by this address","type":"number"},"network":{"description":"The Graph Network ID for EVM networks https://thegraph.com/networks","example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]}},"required":["contract","token_standard","address","quantity","unique_tokens","percentage","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"contract":"0xbd3531da5cf5857e7cfaa92426877b022e612cf8","token_standard":"ERC721","address":"0x29469395eaf6f95920e59f858042f0e28d98a20b","quantity":358,"unique_tokens":358,"percentage":4.027902790279028,"network":"mainnet"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]},"required":true,"description":"The Graph Network ID for EVM networks https://thegraph.com/networks"},{"in":"query","name":"contract","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xbd3531da5cf5857e7cfaa92426877b022e612cf8"},"required":true,"description":"Filter by contract address"},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/evm/nft/items":{"get":{"operationId":"getV1EvmNftItems","summary":"NFT Items","description":"Returns NFT token metadata, attributes, current owner, and media URIs.","tags":["EVM NFTs"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"contract":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},"token_id":{"description":"Token ID","type":"string","example":"5712"},"token_standard":{"description":"Token standard","example":"ERC721","type":"string","enum":["ERC721","ERC1155"]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"description":{"anyOf":[{"type":"string"},{"type":"null"}]},"image":{"anyOf":[{"type":"string"},{"type":"null"}]},"uri":{"anyOf":[{"type":"string"},{"type":"null"}]},"attributes":{"type":"array","items":{"type":"object","properties":{"trait_type":{"type":"string"},"value":{"type":"string"},"display_type":{"type":"string"}},"required":["trait_type","value"]}},"network":{"description":"The Graph Network ID for EVM networks https://thegraph.com/networks","example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]}},"required":["address","contract","token_id","token_standard","name","description","image","uri","attributes","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"address":"0x9379557bdf32f5ee296ca7b360ccb8dcb9543d8e","contract":"0xbd3531da5cf5857e7cfaa92426877b022e612cf8","token_id":"5712","token_standard":"ERC721","name":"Pudgy Penguin #5712","description":"A collection 8888 Cute Chubby Pudgy Penquins sliding around on the freezing ETH blockchain.","image":"ipfs://QmNf1UsmdGaMbpatQ6toXSkzDpizaGmC9zfunCyoz1enD5/penguin/5712.png","uri":"ipfs://bafybeibc5sgo2plmjkq2tzmhrn54bk3crhnc23zd2msg4ea7a4pxrkgfna/5712","attributes":[{"trait_type":"Background","value":"Blue"},{"trait_type":"Skin","value":"Olive Green"},{"trait_type":"Body","value":"Turtleneck Green"},{"trait_type":"Face","value":"Scar"},{"trait_type":"Head","value":"Party Hat"}],"network":"mainnet"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]},"required":true,"description":"The Graph Network ID for EVM networks https://thegraph.com/networks"},{"in":"query","name":"contract","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xbd3531da5cf5857e7cfaa92426877b022e612cf8"},"required":true,"description":"Filter by contract address"},{"in":"query","name":"token_id","schema":{"type":"string","example":"5712","anyOf":[{"description":"Token ID","type":"string","example":"5712"},{"type":"string"},{"type":"array","items":{"description":"Token ID","type":"string","example":"5712"}}]},"description":"Token ID<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/evm/nft/ownerships":{"get":{"operationId":"getV1EvmNftOwnerships","summary":"NFT Ownerships by Address","description":"Returns NFT tokens owned by a wallet address with metadata and ownership information.","tags":["EVM NFTs"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"address":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"contract":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},"token_id":{"description":"Token ID","type":"string","example":"5712"},"token_standard":{"description":"Token standard","example":"ERC721","type":"string","enum":["ERC721","ERC1155"]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"network":{"description":"The Graph Network ID for EVM networks https://thegraph.com/networks","example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]}},"required":["address","contract","token_id","token_standard","name","symbol","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"address":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","contract":"0x000386e3f7559d9b6a2f5c46b4ad1a9587d59dc3","token_id":"12","token_standard":"ERC721","name":"Bored Ape Nike Club","symbol":"BANC","network":"mainnet"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]},"required":true,"description":"The Graph Network ID for EVM networks https://thegraph.com/networks"},{"in":"query","name":"address","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"}}]},"required":true,"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"contract","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0x000386e3f7559d9b6a2f5c46b4ad1a9587d59dc3","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"}}]},"description":"Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"token_id","schema":{"type":"string","example":"12","anyOf":[{"description":"Token ID","type":"string","example":"5712"},{"type":"string"},{"type":"array","items":{"description":"Token ID","type":"string","example":"5712"}}]},"description":"Token ID<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"token_standard","schema":{"example":"ERC721","type":"string","enum":["ERC721","ERC1155"]},"description":"Token standard"},{"in":"query","name":"include_null_balances","schema":{"type":"boolean"},"description":"Include zero/null balances in results"},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/evm/nft/sales":{"get":{"operationId":"getV1EvmNftSales","summary":"NFT Sales","description":"Returns NFT marketplace sales with price, buyer, seller, and transaction data.","tags":["EVM NFTs"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"block_num":{"type":"number"},"datetime":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"timestamp":{"type":"number"},"transaction_id":{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$","description":"Filter by transaction hash","example":"0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca"},"contract":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},"token_id":{"description":"Token ID","type":"string","example":"5712"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"offerer":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"recipient":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"sale_amount":{"type":"number"},"sale_currency":{"type":"string"},"network":{"description":"The Graph Network ID for EVM networks https://thegraph.com/networks","example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]}},"required":["block_num","datetime","timestamp","transaction_id","contract","token_id","name","symbol","offerer","recipient","sale_amount","sale_currency","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"block_num":22098625,"datetime":"2025-03-21 23:46:11","timestamp":1742600771,"transaction_id":"0x8cc8b83e7b7fec752bd689700156990e7ce4d6b890f7b5ab58adf2fb602a98b9","contract":"0xbd3531da5cf5857e7cfaa92426877b022e612cf8","token_id":"5712","name":"PudgyPenguins","symbol":"PPG","offerer":"0x355062b5d0e324815290b96370e87607a71d613d","recipient":"0x7ccde43632b3287fda060719d802b2c4cb6f769b","sale_amount":9.73,"sale_currency":"ETH","network":"mainnet"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]},"required":true,"description":"The Graph Network ID for EVM networks https://thegraph.com/networks"},{"in":"query","name":"transaction_id","schema":{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$","example":"0x8cc8b83e7b7fec752bd689700156990e7ce4d6b890f7b5ab58adf2fb602a98b9","anyOf":[{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$","description":"Filter by transaction hash","example":"0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$","description":"Filter by transaction hash","example":"0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca"}}]},"description":"Filter by transaction hash<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"contract","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xbd3531da5cf5857e7cfaa92426877b022e612cf8","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"}}]},"description":"Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"token_id","schema":{"type":"string","example":"5712","anyOf":[{"description":"Token ID","type":"string","example":"5712"},{"type":"string"},{"type":"array","items":{"description":"Token ID","type":"string","example":"5712"}}]},"description":"Token ID<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"address","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0x355062b5d0e324815290b96370e87607a71d613d","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"from_address","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0x355062b5d0e324815290b96370e87607a71d613d","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"to_address","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0x7ccde43632b3287fda060719d802b2c4cb6f769b","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"start_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"end_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"start_block","schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"Filter by block number"},{"in":"query","name":"end_block","schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"Filter by block number"},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/evm/nft/transfers":{"get":{"operationId":"getV1EvmNftTransfers","summary":"NFT Transfers","description":"Returns NFT transfer events including mints, burns, and ownership changes.","tags":["EVM NFTs"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"block_num":{"type":"number"},"datetime":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"timestamp":{"type":"number"},"@type":{"description":"Transfer category","example":"TRANSFER","type":"string","enum":["BURN","MINT","TRANSFER"]},"transfer_type":{"type":"string"},"transaction_id":{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$","description":"Filter by transaction hash","example":"0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca"},"contract":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},"token_id":{"description":"Token ID","type":"string","example":"5712"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"token_standard":{"description":"Token standard","example":"ERC721","type":"string","enum":["ERC721","ERC1155"]},"from":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"to":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"amount":{"type":"number"},"network":{"description":"The Graph Network ID for EVM networks https://thegraph.com/networks","example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]}},"required":["block_num","datetime","timestamp","@type","transfer_type","transaction_id","contract","token_id","name","symbol","token_standard","from","to","amount","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"block_num":22098625,"datetime":"2025-03-21 23:46:11","timestamp":1742600771,"@type":"TRANSFER","transfer_type":"Single","transaction_id":"0x8cc8b83e7b7fec752bd689700156990e7ce4d6b890f7b5ab58adf2fb602a98b9","contract":"0xbd3531da5cf5857e7cfaa92426877b022e612cf8","token_id":"5712","name":"PudgyPenguins","symbol":"PPG","token_standard":"ERC721","from":"0x355062b5d0e324815290b96370e87607a71d613d","to":"0x7ccde43632b3287fda060719d802b2c4cb6f769b","amount":1,"network":"mainnet"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]},"required":true,"description":"The Graph Network ID for EVM networks https://thegraph.com/networks"},{"in":"query","name":"type","schema":{"example":"TRANSFER","type":"string","enum":["BURN","MINT","TRANSFER"]},"description":"Transfer category"},{"in":"query","name":"transaction_id","schema":{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$","example":"0x8cc8b83e7b7fec752bd689700156990e7ce4d6b890f7b5ab58adf2fb602a98b9","anyOf":[{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$","description":"Filter by transaction hash","example":"0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$","description":"Filter by transaction hash","example":"0xf6374799c227c9db38ff5ac1d5bebe8b607a1de1238cd861ebd1053ec07305ca"}}]},"description":"Filter by transaction hash<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"contract","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xbd3531da5cf5857e7cfaa92426877b022e612cf8","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by contract address","example":"0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"}}]},"description":"Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"token_id","schema":{"type":"string","example":"5712","anyOf":[{"description":"Token ID","type":"string","example":"5712"},{"type":"string"},{"type":"array","items":{"description":"Token ID","type":"string","example":"5712"}}]},"description":"Token ID<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"address","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0x355062b5d0e324815290b96370e87607a71d613d","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"from_address","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0x355062b5d0e324815290b96370e87607a71d613d","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"to_address","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0x7ccde43632b3287fda060719d802b2c4cb6f769b","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},{"type":"string"},{"type":"array","items":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"start_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"end_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"start_block","schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"Filter by block number"},{"in":"query","name":"end_block","schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"Filter by block number"},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/tvm/transfers":{"get":{"operationId":"getV1TvmTransfers","summary":"Token Transfers","description":"Returns ERC-20 transfers with transaction and block data.","tags":["TVM Tokens (ERC-20)"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"block_num":{"type":"number"},"datetime":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"timestamp":{"type":"number"},"transaction_id":{"type":"string","format":"tvm-tx-hash","pattern":"^[0-9a-fA-F]{64}$","description":"Filter by transaction hash","example":"daddbf0810fb73620ebb1ad3c915afd32f3cf13a267d740f27284583df97a01a"},"transaction_index":{"type":"number"},"log_index":{"type":"number"},"log_ordinal":{"type":"number"},"contract":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by contract address","example":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"},"from":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"},"to":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"},"amount":{"type":"string"},"value":{"type":"number"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"decimals":{"anyOf":[{"type":"number"},{"type":"null"}]},"network":{"description":"The Graph Network ID for TVM networks https://thegraph.com/networks","example":"tron","type":"string","enum":["tron"]}},"required":["block_num","datetime","timestamp","transaction_id","transaction_index","log_index","log_ordinal","contract","from","to","amount","value","name","symbol","decimals","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"block_num":49014118,"datetime":"2023-03-01 06:55:06","timestamp":1677653706,"transaction_id":"0xa85ee0572469b128690c00a80f03a328c882b7339496faf64a1ad0707b537329","log_index":0,"contract":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t","type":"transfer","from":"THx5jmvnQkRjDpYEpkaLn7yCvgafXzxiAF","to":"TCc3eBTbWXcUwfmgWP58VnyVGS6HE3gGe3","name":"Tether USD","symbol":"USDT","decimals":6,"amount":"10000000000","value":10000,"network":"tron"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"tron","type":"string","enum":["tron"]},"required":true,"description":"The Graph Network ID for TVM networks https://thegraph.com/networks"},{"in":"query","name":"transaction_id","schema":{"type":"string","format":"tvm-tx-hash","pattern":"^[0-9a-fA-F]{64}$","example":"46c608cd66c873753f7d86a3dc6b46453052505730cc5f6e951533083b1d40ab","anyOf":[{"type":"string","format":"tvm-tx-hash","pattern":"^[0-9a-fA-F]{64}$","description":"Filter by transaction hash","example":"daddbf0810fb73620ebb1ad3c915afd32f3cf13a267d740f27284583df97a01a"},{"type":"string"},{"type":"array","items":{"type":"string","format":"tvm-tx-hash","pattern":"^[0-9a-fA-F]{64}$","description":"Filter by transaction hash","example":"daddbf0810fb73620ebb1ad3c915afd32f3cf13a267d740f27284583df97a01a"}}]},"description":"Filter by transaction hash<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"contract","schema":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","example":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t","anyOf":[{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by contract address","example":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"},{"type":"string"},{"type":"array","items":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by contract address","example":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"}}]},"description":"Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"from_address","schema":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","example":"TAYtGZzxZf1GhPfGwZKskWQnz7Qj3rwLDh","anyOf":[{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"},{"type":"string"},{"type":"array","items":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"to_address","schema":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","example":"THWuviP5wEiPBLZ1g1iPPiH4kV7FRXWFP1","anyOf":[{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"},{"type":"string"},{"type":"array","items":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"start_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"end_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"start_block","schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"Filter by block number"},{"in":"query","name":"end_block","schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"Filter by block number"},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/tvm/tokens":{"get":{"operationId":"getV1TvmTokens","summary":"Token Metadata","description":"Provides ERC-20 token contract metadata.","tags":["TVM Tokens (ERC-20)"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"last_update":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"last_update_block_num":{"type":"number"},"last_update_timestamp":{"type":"number"},"contract":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by contract address","example":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"},"total_transfers":{"type":"number"},"decimals":{"anyOf":[{"type":"number"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"network":{"description":"The Graph Network ID for TVM networks https://thegraph.com/networks","example":"tron","type":"string","enum":["tron"]},"icon":{"type":"object","properties":{"web3icon":{"type":"string"}},"required":["web3icon"]}},"required":["last_update","last_update_block_num","last_update_timestamp","contract","total_transfers","decimals","name","symbol","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"last_update":"2026-02-13 20:52:42","last_update_block_num":80117031,"last_update_timestamp":1771015962,"contract":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t","total_transfers":3051378972,"name":"Tether USD","symbol":"USDT","decimals":6,"network":"tron","icon":{"web3icon":"usdt"}}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"tron","type":"string","enum":["tron"]},"required":true,"description":"The Graph Network ID for TVM networks https://thegraph.com/networks"},{"in":"query","name":"contract","schema":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","example":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t","anyOf":[{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by contract address","example":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"},{"type":"string"},{"type":"array","items":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by contract address","example":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"}}]},"required":true,"description":"Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."}]}},"/v1/tvm/transfers/native":{"get":{"operationId":"getV1TvmTransfersNative","summary":"Native Transfers","description":"Returns Native transfers with transaction and block data.","tags":["TVM Tokens (Native)"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"block_num":{"type":"number"},"datetime":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"timestamp":{"type":"number"},"transaction_id":{"type":"string","format":"tvm-tx-hash","pattern":"^[0-9a-fA-F]{64}$","description":"Filter by transaction hash","example":"daddbf0810fb73620ebb1ad3c915afd32f3cf13a267d740f27284583df97a01a"},"transaction_index":{"type":"number"},"from":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"},"to":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"},"amount":{"type":"string"},"value":{"type":"number"},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"decimals":{"anyOf":[{"type":"number"},{"type":"null"}]},"network":{"description":"The Graph Network ID for TVM networks https://thegraph.com/networks","example":"tron","type":"string","enum":["tron"]}},"required":["block_num","datetime","timestamp","transaction_id","transaction_index","from","to","amount","value","name","symbol","decimals","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"block_num":79432572,"datetime":"2026-01-21 02:12:54","timestamp":1768961574,"transaction_id":"0x0909857e613151f23c51d30829de6a7ba5307cbf74de1fd67dcf67aadfbaa55a","transaction_index":131,"call_index":null,"type":"transaction","from":"0x177b7305b003d1e61941c5eec3737e482a1fe947","to":"0xb41393b990cb28881458313d77910c6164772036","name":"Tron","symbol":"TRX","decimals":6,"amount":"5000000","value":5,"network":"tron"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"tron","type":"string","enum":["tron"]},"required":true,"description":"The Graph Network ID for TVM networks https://thegraph.com/networks"},{"in":"query","name":"transaction_id","schema":{"type":"string","format":"tvm-tx-hash","pattern":"^[0-9a-fA-F]{64}$","example":"7504152368a31f51dc0128f07b01815a4f1033c8247a7c2f415a55d59cfe4351","anyOf":[{"type":"string","format":"tvm-tx-hash","pattern":"^[0-9a-fA-F]{64}$","description":"Filter by transaction hash","example":"daddbf0810fb73620ebb1ad3c915afd32f3cf13a267d740f27284583df97a01a"},{"type":"string"},{"type":"array","items":{"type":"string","format":"tvm-tx-hash","pattern":"^[0-9a-fA-F]{64}$","description":"Filter by transaction hash","example":"daddbf0810fb73620ebb1ad3c915afd32f3cf13a267d740f27284583df97a01a"}}]},"description":"Filter by transaction hash<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"from_address","schema":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","example":"TAYtGZzxZf1GhPfGwZKskWQnz7Qj3rwLDh","anyOf":[{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"},{"type":"string"},{"type":"array","items":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"to_address","schema":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","example":"TMXZAySpsog7WtaeKb8WotoHepNsD1jjTc","anyOf":[{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"},{"type":"string"},{"type":"array","items":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"start_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"end_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"start_block","schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"Filter by block number"},{"in":"query","name":"end_block","schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"Filter by block number"},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/tvm/tokens/native":{"get":{"operationId":"getV1TvmTokensNative","summary":"Native Metadata","description":"Provides Native metadata.","tags":["TVM Tokens (Native)"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"last_update":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"last_update_block_num":{"type":"number"},"last_update_timestamp":{"type":"number"},"decimals":{"anyOf":[{"type":"number"},{"type":"null"}]},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"network":{"type":"string"}},"required":["last_update","last_update_block_num","last_update_timestamp","decimals","name","symbol","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"last_update":"2026-01-25 14:51:18","last_update_block_num":79562903,"last_update_timestamp":1769352678,"name":"Tron","symbol":"TRX","decimals":6,"network":"tron"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"tron","type":"string","enum":["tron"]},"required":true,"description":"The Graph Network ID for TVM networks https://thegraph.com/networks"}]}},"/v1/tvm/swaps":{"get":{"operationId":"getV1TvmSwaps","summary":"Swap Events","description":"Returns DEX swaps events with input & output token amounts.\n\nAddress semantics: `transaction_from` is the onchain transaction initiator and `user` is the normalized user-oriented swap address. `sender` and `recipient` remain available for legacy compatibility, but new integrations should prefer `user` and plan for `sender`/`recipient` deprecation in a future major release.","tags":["TVM DEXs"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"block_num":{"type":"number"},"datetime":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"timestamp":{"type":"number"},"transaction_id":{"type":"string"},"transaction_index":{"type":"number"},"transaction_from":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Onchain transaction initiator address.","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"},"log_index":{"type":"number"},"log_ordinal":{"type":"number"},"log_block_index":{"type":"number"},"log_topic0":{"type":"string"},"factory":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by factory address","example":"TKWJdrQkqHisa1X8HUdHEfREvTzw4pMAaY"},"pool":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by pool address","example":"TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ"},"input_token":{"type":"object","properties":{"address":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"},"symbol":{"type":"string"},"name":{"type":"string"},"decimals":{"type":"number"}},"required":["address","symbol","name","decimals"]},"output_token":{"type":"object","properties":{"address":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"},"symbol":{"type":"string"},"name":{"type":"string"},"decimals":{"type":"number"}},"required":["address","symbol","name","decimals"]},"user":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Normalized user-oriented swap address. Prefer this field for integrations; sender and recipient remain legacy compatibility fields and are planned for deprecation in a future major release.","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"},"sender":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Legacy compatibility field for swap sender semantics. Prefer user for a normalized user-oriented swap address.","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"},"recipient":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Legacy compatibility field for swap recipient semantics. Prefer user for a normalized user-oriented swap address.","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"},"input_amount":{"type":"string"},"input_value":{"type":"number"},"output_amount":{"type":"string"},"output_value":{"type":"number"},"price":{"type":"number"},"price_inv":{"type":"number"},"protocol":{"description":"Protocol name","example":"uniswap_v2","type":"string","enum":["uniswap_v1","uniswap_v2","uniswap_v3","uniswap_v4","sunpump"]},"summary":{"type":"string"},"network":{"description":"The Graph Network ID for TVM networks https://thegraph.com/networks","example":"tron","type":"string","enum":["tron"]}},"required":["block_num","datetime","timestamp","transaction_id","transaction_index","transaction_from","log_index","log_ordinal","log_block_index","log_topic0","factory","pool","input_token","output_token","user","sender","recipient","input_amount","input_value","output_amount","output_value","price","price_inv","protocol","summary","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"block_num":28320009,"datetime":"2021-03-10 04:43:33","timestamp":1615351413,"transaction_id":"0x3e0f39b48dae8c49d3f95bc6206a632af484059764487b0c7d3e3c97bb433130","transaction_index":10,"transaction_from":"TSLjVj4sL7uDWQXDbHyV3Kbgz1KL9jB78w","log_ordinal":0,"log_block_index":0,"log_index":0,"log_topic0":"d78ad95fa46c994b6551d0da85fc275fe613ce37657fb8d5e3d130840159d822","factory":"TXk8rQSAvPvBBNtqSoY6nCfsXWCSSpTVQF","pool":"TAqCH2kadHAugPEorFrpT7Kogqo2FckxWA","user":"TSLjVj4sL7uDWQXDbHyV3Kbgz1KL9jB78w","sender":"TSLjVj4sL7uDWQXDbHyV3Kbgz1KL9jB78w","recipient":"TSLjVj4sL7uDWQXDbHyV3Kbgz1KL9jB78w","input_token":{"address":"TGc9XV7skLENAHPj4afCpBS8JSHv6box9C","symbol":"","decimals":0},"output_token":{"address":"T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb","symbol":"TRX","decimals":6},"input_amount":"20000000","input_value":20000000,"output_amount":"1258054968","output_value":1258.054968,"price":0.0000629027484,"price_inv":15897.556552552798,"protocol":"uniswap_v1","summary":"Swap 20.00 million  for 1.26 thousand TRX on Uniswap V1","network":"tron"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"tron","type":"string","enum":["tron"]},"required":true,"description":"The Graph Network ID for TVM networks https://thegraph.com/networks"},{"in":"query","name":"transaction_id","schema":{"type":"string","format":"tvm-tx-hash","pattern":"^[0-9a-fA-F]{64}$","example":"e74815245a8f1321ce5ede99cde8e021f75bf8e3d4f94cd8949d283eb56fee63","anyOf":[{"type":"string","format":"tvm-tx-hash","pattern":"^[0-9a-fA-F]{64}$","description":"Filter by transaction hash","example":"daddbf0810fb73620ebb1ad3c915afd32f3cf13a267d740f27284583df97a01a"},{"type":"string"},{"type":"array","items":{"type":"string","format":"tvm-tx-hash","pattern":"^[0-9a-fA-F]{64}$","description":"Filter by transaction hash","example":"daddbf0810fb73620ebb1ad3c915afd32f3cf13a267d740f27284583df97a01a"}}]},"description":"Filter by transaction hash<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"factory","schema":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","example":"TKWJdrQkqHisa1X8HUdHEfREvTzw4pMAaY","anyOf":[{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"},{"type":"string"},{"type":"array","items":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"pool","schema":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","example":"TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ","anyOf":[{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by pool address","example":"TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ"},{"type":"string"},{"type":"array","items":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by pool address","example":"TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ"}}]},"description":"Filter by pool address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"transaction_from","schema":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","example":"TXF1xDbVGdxFGbovmmmXvBGu8ZiE3Lq4mR","anyOf":[{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"},{"type":"string"},{"type":"array","items":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"user","schema":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","example":"TXF1xDbVGdxFGbovmmmXvBGu8ZiE3Lq4mR","anyOf":[{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"},{"type":"string"},{"type":"array","items":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"sender","schema":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","example":"TXF1xDbVGdxFGbovmmmXvBGu8ZiE3Lq4mR","anyOf":[{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"},{"type":"string"},{"type":"array","items":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"recipient","schema":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","example":"TXF1xDbVGdxFGbovmmmXvBGu8ZiE3Lq4mR","anyOf":[{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"},{"type":"string"},{"type":"array","items":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"input_contract","schema":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","example":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t","anyOf":[{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"},{"type":"string"},{"type":"array","items":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"output_contract","schema":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","example":"TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR","anyOf":[{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"},{"type":"string"},{"type":"array","items":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"}}]},"description":"Filter by address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"protocol","schema":{"example":"uniswap_v2","type":"string","enum":["uniswap_v1","uniswap_v2","uniswap_v3","uniswap_v4","sunpump"]},"description":"Protocol name"},{"in":"query","name":"start_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"end_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"start_block","schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"Filter by block number"},{"in":"query","name":"end_block","schema":{"type":"integer","minimum":0,"maximum":9007199254740991},"description":"Filter by block number"},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/tvm/pools":{"get":{"operationId":"getV1TvmPools","summary":"Liquidity Pools","description":"Returns DEX pool metadata including tokens, fees and protocol.","tags":["TVM DEXs"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"factory":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by factory address","example":"0x5c69bee701ef814a2b6a3edd4b1652cb9cc5aa6f"},"pool":{"description":"Filter by pool address","type":"string","example":"0x88e6a0c2ddd26feeb64f039a2c41296fcb3f5640","anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$"},{"type":"string","format":"evm-tx-hash","pattern":"^(0[xX])?[0-9a-fA-F]{64}$"}]},"input_token":{"type":"object","properties":{"address":{"anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"decimals":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["address","symbol","decimals"]},"output_token":{"type":"object","properties":{"address":{"anyOf":[{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},{"type":"null"}]},"symbol":{"anyOf":[{"type":"string"},{"type":"null"}]},"decimals":{"anyOf":[{"type":"number"},{"type":"null"}]}},"required":["address","symbol","decimals"]},"fee":{"type":"number"},"protocol":{"description":"Protocol name","example":"uniswap_v3","type":"string","enum":["uniswap_v1","uniswap_v2","uniswap_v3","uniswap_v4","curvefi","balancer","bancor","cow","aerodrome","dodo","woofi","traderjoe","kyber_elastic"]},"network":{"description":"The Graph Network ID for EVM networks https://thegraph.com/networks","example":"mainnet","type":"string","enum":["arbitrum-one","avalanche","base","bsc","mainnet","optimism","polygon","unichain"]}},"required":["factory","pool","input_token","output_token","fee","protocol","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"pool":"TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE","factory":"TXk8rQSAvPvBBNtqSoY6nCfsXWCSSpTVQF","protocol":"uniswap_v1","input_token":{"address":"T9yD14Nj9j7xAB4dbGeiX9h8unkKHxuWwb","symbol":"TRX","decimals":6},"output_token":{"address":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t","symbol":"USDT","decimals":6},"fee":3000,"network":"tron"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"tron","type":"string","enum":["tron"]},"required":true,"description":"The Graph Network ID for TVM networks https://thegraph.com/networks"},{"in":"query","name":"factory","schema":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","example":"TKWJdrQkqHisa1X8HUdHEfREvTzw4pMAaY","anyOf":[{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by factory address","example":"TKWJdrQkqHisa1X8HUdHEfREvTzw4pMAaY"},{"type":"string"},{"type":"array","items":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by factory address","example":"TKWJdrQkqHisa1X8HUdHEfREvTzw4pMAaY"}}]},"description":"Filter by factory address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"pool","schema":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","example":"TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ","anyOf":[{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by pool address","example":"TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ"},{"type":"string"},{"type":"array","items":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by pool address","example":"TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ"}}]},"description":"Filter by pool address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"input_token","schema":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","example":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t","anyOf":[{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by contract address","example":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"},{"type":"string"},{"type":"array","items":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by contract address","example":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"}}]},"description":"Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"output_token","schema":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","example":"TNUC9Qb1rRpS5CbWLmNMxXBjyFoydXjWFR","anyOf":[{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by contract address","example":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"},{"type":"string"},{"type":"array","items":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by contract address","example":"TR7NHqjeKQxGTCi8q8ZY4pL8otSzgjLj6t"}}]},"description":"Filter by contract address<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"protocol","schema":{"example":"uniswap_v2","type":"string","enum":["uniswap_v1","uniswap_v2","uniswap_v3","uniswap_v4","sunpump"]},"description":"Protocol name"},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/tvm/pools/ohlc":{"get":{"operationId":"getV1TvmPoolsOhlc","summary":"Pool OHLCV","description":"Returns OHLCV price data for liquidity pools.\n\nOHLCV historical depth is subject to plan restrictions.","tags":["TVM DEXs"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"datetime":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"ticker":{"type":"string"},"pool":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by pool address","example":"TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ"},"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"},"transactions":{"type":"number"},"network":{"description":"The Graph Network ID for TVM networks https://thegraph.com/networks","example":"tron","type":"string","enum":["tron"]}},"required":["datetime","ticker","pool","open","high","low","close","volume","transactions","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"datetime":"2025-11-05 00:00:00","ticker":"WTRXUSDT","pool":"TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ","open":0.2858162052159799,"high":0.2880636266155062,"low":0.28099080983643465,"close":0.2880636266155062,"volume":15584135805763,"transactions":102081,"network":"tron"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"tron","type":"string","enum":["tron"]},"required":true,"description":"The Graph Network ID for TVM networks https://thegraph.com/networks"},{"in":"query","name":"pool","schema":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","example":"TFGDbUyP8xez44C76fin3bn3Ss6jugoUwJ"},"required":true,"description":"Filter by pool address"},{"in":"query","name":"interval","schema":{"type":"string","enum":["1m","5m","10m","30m","1h","4h","1d","1w"],"default":"1d"},"description":"The interval* for which to aggregate price data (1-minute, 5-minutes, 10-minutes, 30-minutes, hourly, 4-hours, daily or weekly).<br>*Plan restricted."},{"in":"query","name":"start_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"end_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/tvm/dexes":{"get":{"operationId":"getV1TvmDexes","summary":"Supported DEXs","description":"Returns all supported TVM DEXs.","tags":["TVM DEXs"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"factory":{"type":"string","format":"tvm-address","pattern":"^T[1-9A-HJ-NP-Za-km-z]{33}$","description":"Filter by address","example":"TRX9Uehj3GuFVh5jjVjNqb6q9cgVHJ4jGX"},"protocol":{"description":"Protocol name","example":"uniswap_v2","type":"string","enum":["uniswap_v1","uniswap_v2","uniswap_v3","uniswap_v4","sunpump"]},"transactions":{"type":"number"},"uaw":{"type":"number"},"last_activity":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"network":{"description":"The Graph Network ID for TVM networks https://thegraph.com/networks","example":"tron","type":"string","enum":["tron"]}},"required":["factory","protocol","transactions","uaw","last_activity","network"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"example":{"value":{"data":[{"protocol":"uniswap_v1","factory":"TXk8rQSAvPvBBNtqSoY6nCfsXWCSSpTVQF","last_activity":"2025-12-16 05:16:18","transactions":48269088,"uaw":2848148,"network":"tron"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"tron","type":"string","enum":["tron"]},"required":true,"description":"The Graph Network ID for TVM networks https://thegraph.com/networks"},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/hyperliquid/dexes":{"get":{"operationId":"getV1HyperliquidDexes","summary":"Supported DEXs","description":"Returns the list of perpetuals DEXs and spot, each with 24h activity stats (volume, trade count, unique users, asset count). Hyperliquid hosts a core perpetuals venue (`dex=perps`) alongside builder-deployed perpetuals DEXs that each list their own asset universe — `xyz` (commodities and macro indices), `cash` (tokenized equities), `km`, and others.\n\nUse this endpoint to discover valid `dex` filter values for venue-scoped queries on `/markets`, `/markets/activity`, `/markets/liquidations`, `/users`, and `/users/positions`.\n\nFor platform-wide totals across all DEXs over arbitrary intervals, use `/v1/hyperliquid/platform`.\n\n**Public — no auth required.**","tags":["Hyperliquid Markets"],"security":[],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"dex":{"type":"string","description":"DEX identifier. `perps` for core perps, `spot` for `@N` spot pairs, or a builder DEX name (e.g. `xyz`, `cash`). New builder DEXs are added on Hyperliquid permissionlessly — call `/v1/hyperliquid/dexes` for the live set.","examples":["perps","spot","xyz","cash","km","hyna","flx","vntl","para"],"minLength":1},"assets":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"volume_24h":{"type":"number"},"trades_24h":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unique_users_24h":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["dex","assets","volume_24h","trades_24h","unique_users_24h"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"default":{"value":{"data":[{"dex":"perps","assets":192,"volume_24h":3587190584.83,"trades_24h":1780780,"unique_users_24h":7663},{"dex":"xyz","assets":48,"volume_24h":412857192.13,"trades_24h":245118,"unique_users_24h":1842},{"dex":"spot","assets":275,"volume_24h":89724108.55,"trades_24h":154297,"unique_users_24h":943}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}}}},"/v1/hyperliquid/markets":{"get":{"operationId":"getV1HyperliquidMarkets","summary":"Market Lookup","description":"Returns the latest snapshot per market: last trade price, 24h change versus the prior-day close, 24h volume (split by side), trade and unique-user counts, and the most recent open interest and funding rate observed at the last funding snapshot.\n\nFilters compose additively — pass `coin`, `dex`, `base_token`, and/or `quote_token` to narrow the scope. A mismatched combination (e.g. `coin=cash:TSLA&dex=xyz`) returns empty. Omit all for a full listing sorted by 24h volume.\n\n`base_token` and `quote_token` are spot-discovery filters: `?base_token=HYPE` returns every spot pair where HYPE sits on the base side (HYPE/USDC, HYPE/USDT0, …). Use the `coin` from the result as the identifier on the rest of the `/v1/hyperliquid/*` endpoints.","tags":["Hyperliquid Markets"],"security":[],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"coin":{"type":"string"},"market_name":{"type":"string"},"dex":{"type":"string"},"base_token":{"anyOf":[{"type":"string"},{"type":"null"}]},"quote_token":{"anyOf":[{"type":"string"},{"type":"null"}]},"price":{"type":"number"},"price_24h":{"anyOf":[{"type":"number"},{"type":"null"}]},"price_24h_change":{"type":"number"},"volume_24h":{"type":"number"},"buy_volume_24h":{"type":"number"},"sell_volume_24h":{"type":"number"},"trades_24h":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unique_users_24h":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"open_interest":{"anyOf":[{"type":"number"},{"type":"null"}]},"funding_rate":{"anyOf":[{"type":"number"},{"type":"null"}]},"funding_snapshot_time":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},{"type":"null"}]}},"required":["coin","market_name","dex","base_token","quote_token","price","price_24h","price_24h_change","volume_24h","buy_volume_24h","sell_volume_24h","trades_24h","unique_users_24h","open_interest","funding_rate","funding_snapshot_time"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"default":{"value":{"data":[{"coin":"BTC","market_name":"BTC","dex":"perps","base_token":null,"quote_token":null,"price":75944,"price_24h":76765,"price_24h_change":-0.010695,"volume_24h":2322418448.58,"buy_volume_24h":1106113114.59,"sell_volume_24h":1216305333.99,"trades_24h":454294,"unique_users_24h":4581,"open_interest":27608.56,"funding_rate":0.0000037749,"funding_snapshot_time":"2026-04-28 15:00:00"},{"coin":"@107","market_name":"HYPE/USDC","dex":"spot","base_token":"HYPE","quote_token":"USDC","price":22.41,"price_24h":22.85,"price_24h_change":-0.01926,"volume_24h":18452113.47,"buy_volume_24h":9071010.97,"sell_volume_24h":9381102.5,"trades_24h":28412,"unique_users_24h":1267,"open_interest":null,"funding_rate":null,"funding_snapshot_time":null}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"coin","schema":{"type":"string","example":"BTC","minLength":1},"description":"Hyperliquid coin identifier. Core perps have no prefix (`BTC`, `HYPE`); spot pairs use `@N` (`@107`); builder DEXs prefix the symbol with the DEX name (`xyz:SILVER`)."},{"in":"query","name":"dex","schema":{"type":"string","examples":["perps","spot","xyz","cash","km","hyna","flx","vntl","para"],"minLength":1},"description":"DEX identifier. `perps` for core perps, `spot` for `@N` spot pairs, or a builder DEX name (e.g. `xyz`, `cash`). New builder DEXs are added on Hyperliquid permissionlessly — call `/v1/hyperliquid/dexes` for the live set."},{"in":"query","name":"base_token","schema":{"type":"string","examples":["HYPE","USDC","PURR"],"minLength":1},"description":"Spot token symbol (e.g. `HYPE`, `USDC`). Use to discover all spot pairs with this token on a given side via `/v1/hyperliquid/markets?base_token=...` or `?quote_token=...`."},{"in":"query","name":"quote_token","schema":{"type":"string","examples":["HYPE","USDC","PURR"],"minLength":1},"description":"Spot token symbol (e.g. `HYPE`, `USDC`). Use to discover all spot pairs with this token on a given side via `/v1/hyperliquid/markets?base_token=...` or `?quote_token=...`."},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/hyperliquid/markets/ohlc":{"get":{"operationId":"getV1HyperliquidMarketsOhlc","summary":"Market OHLCV","description":"Returns OHLCV candles for a single coin and interval, derived from regular trade fills. Volume is broken down both by side (`buy_volume`, `ask_volume`) and — on perpetuals — by directional intent (`open_long_volume`, `close_long_volume`, `open_short_volume`, `close_short_volume`) so consumers can distinguish whether price moves are driven by fresh exposure or position unwinds. On spot markets the directional-intent fields are zero; the side-volume fields carry the buy/sell breakdown directly.\n\nFor liquidation-only candles (with mark-price OHLC), use `/v1/hyperliquid/markets/liquidations/ohlc`.","tags":["Hyperliquid Markets"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"coin":{"type":"string"},"market_name":{"type":"string"},"dex":{"type":"string"},"interval_min":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"buy_volume":{"type":"number"},"sell_volume":{"type":"number"},"gross_volume":{"type":"number"},"net_volume":{"type":"number"},"open_long_volume":{"type":"number"},"close_long_volume":{"type":"number"},"open_short_volume":{"type":"number"},"close_short_volume":{"type":"number"},"transactions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"buys":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sells":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unique_users":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"total_fees":{"type":"number"}},"required":["timestamp","coin","market_name","dex","interval_min","open","high","low","close","buy_volume","sell_volume","gross_volume","net_volume","open_long_volume","close_long_volume","open_short_volume","close_short_volume","transactions","buys","sells","unique_users","total_fees"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"default":{"value":{"data":[{"timestamp":"2026-04-30 23:00:00","coin":"BTC","market_name":"BTC","dex":"perps","interval_min":60,"open":76184,"high":76286,"low":76178,"close":76257,"buy_volume":28447564.19,"sell_volume":10848062.98,"gross_volume":39295627.17,"net_volume":17599501.21,"open_long_volume":4495886.85,"close_long_volume":11423420.07,"open_short_volume":13640171.56,"close_short_volume":5181222.62,"transactions":5544,"buys":2170,"sells":3374,"unique_users":1183,"total_fees":111.23}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"coin","schema":{"type":"string","example":"BTC","minLength":1},"required":true,"description":"Hyperliquid coin identifier. Core perps have no prefix (`BTC`, `HYPE`); spot pairs use `@N` (`@107`); builder DEXs prefix the symbol with the DEX name (`xyz:SILVER`)."},{"in":"query","name":"dex","schema":{"type":"string","examples":["perps","spot","xyz","cash","km","hyna","flx","vntl","para"],"minLength":1},"description":"DEX identifier. `perps` for core perps, `spot` for `@N` spot pairs, or a builder DEX name (e.g. `xyz`, `cash`). New builder DEXs are added on Hyperliquid permissionlessly — call `/v1/hyperliquid/dexes` for the live set."},{"in":"query","name":"interval","schema":{"type":"string","enum":["1m","5m","10m","30m","1h","4h","1d","1w"],"default":"1d"},"description":"The interval* for which to aggregate price data (1-minute, 5-minutes, 10-minutes, 30-minutes, hourly, 4-hours, daily or weekly).<br>*Plan restricted."},{"in":"query","name":"start_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"end_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/hyperliquid/markets/oi":{"get":{"operationId":"getV1HyperliquidMarketsOi","summary":"Market Open Interest","description":"Returns the historical open-interest and funding-rate time series for a coin at the requested interval. `open_interest` is the sum of absolute signed position sizes across all users at each funding snapshot.\n\nEach row also exposes the directional positioning split (`long_size`, `short_size`, `net_position`, plus `long_positions` and `short_positions` as user counts) and funding aggregates (`funding_rate`, `total_funding`, `positive_funding`, `negative_funding`) — useful for detecting crowded sides, funding pressure, and position flushes.","tags":["Hyperliquid Markets"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"coin":{"type":"string"},"market_name":{"type":"string"},"dex":{"type":"string"},"interval_min":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"open_interest":{"type":"number"},"net_position":{"type":"number"},"long_size":{"type":"number"},"short_size":{"type":"number"},"long_positions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"short_positions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"funding_rate":{"type":"number"},"total_funding":{"type":"number"},"positive_funding":{"type":"number"},"negative_funding":{"type":"number"},"funding_events":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["timestamp","coin","market_name","dex","interval_min","open_interest","net_position","long_size","short_size","long_positions","short_positions","funding_rate","total_funding","positive_funding","negative_funding","funding_events"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"default":{"value":{"data":[{"timestamp":"2026-04-30 23:00:00","coin":"BTC","market_name":"BTC","dex":"perps","interval_min":60,"open_interest":27984.45,"net_position":0,"long_size":13992.23,"short_size":-13992.23,"long_positions":16381,"short_positions":14034,"funding_rate":-0.0000154515,"total_funding":-0.001199,"positive_funding":16482.55,"negative_funding":-16482.55,"funding_events":30415}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"coin","schema":{"type":"string","example":"BTC","minLength":1},"required":true,"description":"Hyperliquid coin identifier. Core perps have no prefix (`BTC`, `HYPE`); spot pairs use `@N` (`@107`); builder DEXs prefix the symbol with the DEX name (`xyz:SILVER`)."},{"in":"query","name":"dex","schema":{"type":"string","examples":["perps","spot","xyz","cash","km","hyna","flx","vntl","para"],"minLength":1},"description":"DEX identifier. `perps` for core perps, `spot` for `@N` spot pairs, or a builder DEX name (e.g. `xyz`, `cash`). New builder DEXs are added on Hyperliquid permissionlessly — call `/v1/hyperliquid/dexes` for the live set."},{"in":"query","name":"interval","schema":{"type":"string","enum":["1m","5m","10m","30m","1h","4h","1d","1w"],"default":"1h"},"description":"The interval* for which to aggregate price data (1-minute, 5-minutes, 10-minutes, 30-minutes, hourly, 4-hours, daily or weekly).<br>*Plan restricted."},{"in":"query","name":"start_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"end_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/hyperliquid/markets/activity":{"get":{"operationId":"getV1HyperliquidMarketsActivity","summary":"Market Activity","description":"Returns a chronological fill feed, filterable by `coin`, `dex`, and/or `user`. Each row is a single fill carrying price, size, side (`BID` or `ASK`), directional intent (`OPEN_LONG`, `CLOSE_SHORT`, `LIQUIDATED_CROSS_LONG`, `AUTO_DELEVERAGING`, and others), closed PnL, fees (negative values represent maker rebates), and order-level metadata (`order_id`, `client_order_id`, `twap_id`, `crossed`).\n\nFor balance-changing events on a user (deposits, withdrawals, funding payments, vault flows), use `/v1/hyperliquid/users/activity`.\n\nAt least one of `coin`, `dex`, or `user` is required. Filters compose additively — pass any combination to narrow further; a mismatched pair (e.g. `coin=cash:TSLA&dex=xyz`) returns empty.\n\nDefaults to the last 24 hours when no time range is specified — provide `start_time` and `end_time` to query older data.","tags":["Hyperliquid Markets"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"block_num":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"timestamp":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"transaction_hash":{"type":"string"},"transaction_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"coin":{"type":"string"},"market_name":{"type":"string"},"dex":{"type":"string"},"user":{"type":"string"},"side":{"type":"string"},"direction":{"type":"string"},"price":{"type":"number"},"size":{"type":"number"},"notional":{"type":"number"},"start_position":{"type":"string"},"closed_pnl":{"type":"number"},"fee":{"type":"number"},"fee_token":{"type":"string"},"order_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"client_order_id":{"type":"string"},"twap_id":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"crossed":{"type":"boolean"}},"required":["block_num","timestamp","transaction_hash","transaction_id","coin","market_name","dex","user","side","direction","price","size","notional","start_position","closed_pnl","fee","fee_token","order_id","client_order_id","twap_id","crossed"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"default":{"value":{"data":[{"block_num":979136485,"timestamp":"2026-04-30 23:26:59","transaction_hash":"0x0000000000000000000000000000000000000000000000000000000000000000","transaction_id":494766926007210,"coin":"BTC","market_name":"BTC","dex":"perps","user":"0xd8592afc09c864df215d8012122aed08e4ae453f","side":"ASK","direction":"OPEN_SHORT","price":76257,"size":0.01424,"notional":1085.9,"start_position":"-0.60385","closed_pnl":0,"fee":0.380064,"fee_token":"USDC","order_id":405525134401,"client_order_id":"","twap_id":1781070,"crossed":true}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"coin","schema":{"type":"string","example":"BTC","minLength":1},"description":"Hyperliquid coin identifier. Core perps have no prefix (`BTC`, `HYPE`); spot pairs use `@N` (`@107`); builder DEXs prefix the symbol with the DEX name (`xyz:SILVER`)."},{"in":"query","name":"dex","schema":{"type":"string","examples":["perps","spot","xyz","cash","km","hyna","flx","vntl","para"],"minLength":1},"description":"DEX identifier. `perps` for core perps, `spot` for `@N` spot pairs, or a builder DEX name (e.g. `xyz`, `cash`). New builder DEXs are added on Hyperliquid permissionlessly — call `/v1/hyperliquid/dexes` for the live set."},{"in":"query","name":"user","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"description":"Filter by address"},{"in":"query","name":"start_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"end_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/hyperliquid/markets/liquidations":{"get":{"operationId":"getV1HyperliquidMarketsLiquidations","summary":"Market Liquidations","description":"Returns one row per liquidation event, aggregated across the multiple fills that walk the book during a liquidation. Only the liquidated user's side is returned — counterparty fills are excluded.\n\nEach row surfaces the coin, liquidated user, transaction hash, liquidation kind (`CROSS_LONG`, `ISOLATED_SHORT`, and others), total size and notional, size-weighted average fill price, the mark price at liquidation, and the liquidation method reported by the venue (`backstop` and others).\n\nFilter by `coin`, `dex`, and/or `liquidated_user` — filters compose additively. Sort by `notional` (default — largest events first) or `time` (most recent first).","tags":["Hyperliquid Markets"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"block_num":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"timestamp":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"event_hash":{"type":"string"},"coin":{"type":"string"},"market_name":{"type":"string"},"dex":{"type":"string"},"liquidated_user":{"type":"string"},"direction":{"type":"string"},"liquidation_kind":{"type":"string"},"fills":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"total_size":{"type":"number"},"notional":{"type":"number"},"avg_fill_price":{"type":"number"},"mark_price":{"type":"number"},"liquidation_method":{"type":"string"},"total_fees":{"type":"number"}},"required":["block_num","timestamp","event_hash","coin","market_name","dex","liquidated_user","direction","liquidation_kind","fills","total_size","notional","avg_fill_price","mark_price","liquidation_method","total_fees"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"default":{"value":{"data":[{"block_num":880714128,"timestamp":"2026-02-06 00:19:53","event_hash":"0x37cd3a3ffeb5bee739460434c180bf000008522599b8ddb9db95e592bdb998d1","coin":"BTC","market_name":"BTC","dex":"perps","liquidated_user":"0x7ba283114573bde6fd304ad7b188a763e5402a52","direction":"LIQUIDATED_CROSS_LONG","liquidation_kind":"CROSS_LONG","fills":2,"total_size":0.2203,"notional":13116.86,"avg_fill_price":59540.9,"mark_price":60114,"liquidation_method":"backstop","total_fees":0}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"coin","schema":{"type":"string","example":"BTC","minLength":1},"description":"Hyperliquid coin identifier. Core perps have no prefix (`BTC`, `HYPE`); spot pairs use `@N` (`@107`); builder DEXs prefix the symbol with the DEX name (`xyz:SILVER`)."},{"in":"query","name":"dex","schema":{"type":"string","examples":["perps","spot","xyz","cash","km","hyna","flx","vntl","para"],"minLength":1},"description":"DEX identifier. `perps` for core perps, `spot` for `@N` spot pairs, or a builder DEX name (e.g. `xyz`, `cash`). New builder DEXs are added on Hyperliquid permissionlessly — call `/v1/hyperliquid/dexes` for the live set."},{"in":"query","name":"liquidated_user","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"description":"Filter by address"},{"in":"query","name":"sort_by","schema":{"type":"string","enum":["notional","time"],"default":"notional"}},{"in":"query","name":"start_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"end_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/hyperliquid/markets/liquidations/ohlc":{"get":{"operationId":"getV1HyperliquidMarketsLiquidationsOhlc","summary":"Market Liquidations OHLCV","description":"Returns liquidation-only OHLCV candles for a single coin and interval. Adds mark-price OHLC (`mark_price_open`, `mark_price_high`, `mark_price_low`, `mark_price_close`) — the price feed used for margining at liquidation time — alongside the standard trade-price OHLC. Volume and counts cover the liquidation fills only.\n\nFor all-fill candles, use `/v1/hyperliquid/markets/ohlc`.","tags":["Hyperliquid Markets"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"coin":{"type":"string"},"market_name":{"type":"string"},"dex":{"type":"string"},"interval_min":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"mark_price_open":{"type":"number"},"mark_price_high":{"type":"number"},"mark_price_low":{"type":"number"},"mark_price_close":{"type":"number"},"buy_volume":{"type":"number"},"sell_volume":{"type":"number"},"gross_volume":{"type":"number"},"net_volume":{"type":"number"},"open_long_volume":{"type":"number"},"close_long_volume":{"type":"number"},"open_short_volume":{"type":"number"},"close_short_volume":{"type":"number"},"transactions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"buys":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sells":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unique_liquidators":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unique_liquidated":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"total_fees":{"type":"number"}},"required":["timestamp","coin","market_name","dex","interval_min","open","high","low","close","mark_price_open","mark_price_high","mark_price_low","mark_price_close","buy_volume","sell_volume","gross_volume","net_volume","open_long_volume","close_long_volume","open_short_volume","close_short_volume","transactions","buys","sells","unique_liquidators","unique_liquidated","total_fees"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"default":{"value":{"data":[{"timestamp":"2026-04-30 19:00:00","coin":"BTC","market_name":"BTC","dex":"perps","interval_min":60,"open":76395,"high":76395,"low":76395,"close":76395,"mark_price_open":76390,"mark_price_high":76390,"mark_price_low":76390,"mark_price_close":76390,"buy_volume":16.81,"sell_volume":0,"gross_volume":16.81,"net_volume":16.81,"open_long_volume":0,"close_long_volume":0,"open_short_volume":16.81,"close_short_volume":0,"transactions":1,"buys":0,"sells":1,"unique_liquidators":1,"unique_liquidated":1,"total_fees":-0.000336}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"coin","schema":{"type":"string","example":"BTC","minLength":1},"required":true,"description":"Hyperliquid coin identifier. Core perps have no prefix (`BTC`, `HYPE`); spot pairs use `@N` (`@107`); builder DEXs prefix the symbol with the DEX name (`xyz:SILVER`)."},{"in":"query","name":"dex","schema":{"type":"string","examples":["perps","spot","xyz","cash","km","hyna","flx","vntl","para"],"minLength":1},"description":"DEX identifier. `perps` for core perps, `spot` for `@N` spot pairs, or a builder DEX name (e.g. `xyz`, `cash`). New builder DEXs are added on Hyperliquid permissionlessly — call `/v1/hyperliquid/dexes` for the live set."},{"in":"query","name":"interval","schema":{"type":"string","enum":["1m","5m","10m","30m","1h","4h","1d","1w"],"default":"1d"},"description":"The interval* for which to aggregate price data (1-minute, 5-minutes, 10-minutes, 30-minutes, hourly, 4-hours, daily or weekly).<br>*Plan restricted."},{"in":"query","name":"start_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"end_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/hyperliquid/users":{"get":{"operationId":"getV1HyperliquidUsers","summary":"User Lookup","description":"Returns trading aggregates per user: fill count, volume broken down by side, total fees (negative values represent net maker rebates), realized PnL, net funding paid or received, liquidation-fill count, distinct coins traded, and first/last trade timestamps.\n\nOmit `user` for leaderboard mode — returns a paginated list sorted by `sort_by`. Provide `user` for profile mode — returns a single row. Filters `coin` and `dex` compose additively — pass either or both to narrow the scope (`coin=BTC` for one market, `dex=xyz` for one venue, both together for redundancy). A mismatched combination (e.g. `coin=cash:TSLA&dex=xyz`) returns an empty result.\n\nAggregation windows are fixed via the `interval` parameter — `1h`, `1d`, `1w`, `30d`, or omit for all-time. Data is refreshed hourly, so `1h` lags up to 1h.\n\nVaults trade as normal accounts, so passing a vault address as `user` returns its trading performance — pair with `/v1/hyperliquid/vaults` for depositor-side stats.","tags":["Hyperliquid Users"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"user":{"type":"string"},"coin":{"anyOf":[{"type":"string"},{"type":"null"}]},"dex":{"anyOf":[{"type":"string"},{"type":"null"}]},"interval":{"anyOf":[{"type":"string"},{"type":"null"}]},"transactions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"buys":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sells":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"volume_bought":{"type":"number"},"volume_sold":{"type":"number"},"total_volume":{"type":"number"},"total_fees":{"type":"number"},"realized_pnl":{"type":"number"},"total_funding":{"type":"number"},"liquidation_fills":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"coins_traded":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"first_trade":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"last_trade":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"}},"required":["user","coin","dex","interval","transactions","buys","sells","volume_bought","volume_sold","total_volume","total_fees","realized_pnl","total_funding","liquidation_fills","coins_traded","first_trade","last_trade"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"leaderboard":{"summary":"Leaderboard mode (no filter)","value":{"data":[{"user":"0x3029df6146509f4bd9bc39d85dd01fc9e9639a2f","coin":null,"dex":null,"interval":null,"transactions":969,"buys":488,"sells":481,"volume_bought":102292.57,"volume_sold":107984.47,"total_volume":210277.03,"total_fees":11.88,"realized_pnl":153.34,"total_funding":0.14,"liquidation_fills":0,"coins_traded":6,"first_trade":"2026-02-22 02:01:26","last_trade":"2026-04-30 05:39:27"}]}},"filtered_by_coin":{"summary":"Filtered by coin=BTC","value":{"data":[{"user":"0x3029df6146509f4bd9bc39d85dd01fc9e9639a2f","coin":"BTC","dex":null,"interval":null,"transactions":412,"buys":208,"sells":204,"volume_bought":48173.21,"volume_sold":50624.09,"total_volume":98797.3,"total_fees":5.92,"realized_pnl":78.41,"total_funding":0.06,"liquidation_fills":0,"coins_traded":1,"first_trade":"2026-02-22 02:01:26","last_trade":"2026-04-30 05:39:27"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"user","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"description":"Filter by address"},{"in":"query","name":"interval","schema":{"type":"string","enum":["1h","1d","1w","30d"]},"description":"Lookback window for user statistics (1 hour, 1 day, 1 week, 30 days). Omit for all-time."},{"in":"query","name":"sort_by","schema":{"type":"string","enum":["total_volume","transactions","total_fees","realized_pnl","total_funding","liquidation_fills"],"default":"total_volume"}},{"in":"query","name":"coin","schema":{"type":"string","example":"BTC","minLength":1},"description":"Hyperliquid coin identifier. Core perps have no prefix (`BTC`, `HYPE`); spot pairs use `@N` (`@107`); builder DEXs prefix the symbol with the DEX name (`xyz:SILVER`)."},{"in":"query","name":"dex","schema":{"type":"string","examples":["perps","spot","xyz","cash","km","hyna","flx","vntl","para"],"minLength":1},"description":"DEX identifier. `perps` for core perps, `spot` for `@N` spot pairs, or a builder DEX name (e.g. `xyz`, `cash`). New builder DEXs are added on Hyperliquid permissionlessly — call `/v1/hyperliquid/dexes` for the live set."},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/hyperliquid/users/positions":{"get":{"operationId":"getV1HyperliquidUsersPositions","summary":"User Positions","description":"Returns the current signed position (`position_size`) per coin for a user, reconstructed from the latest funding snapshot per `(user, coin)` pair. Positive `position_size` indicates a long position, negative indicates a short. Each row also carries the funding rate applied at that snapshot and the snapshot timestamp.\n\nFilter by `coin` for a single coin, or `dex` to return only positions on one venue (`xyz`, `cash`, etc.).\n\nCaveat: positions opened and fully closed between two funding snapshots are never observed during settlement and will not appear here.","tags":["Hyperliquid Users"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"user":{"type":"string"},"coin":{"type":"string"},"market_name":{"type":"string"},"dex":{"type":"string"},"position_size":{"type":"number"},"funding_rate":{"type":"number"},"last_update":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"}},"required":["user","coin","market_name","dex","position_size","funding_rate","last_update"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"default":{"value":{"data":[{"user":"0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00","coin":"PUMP","market_name":"PUMP","dex":"perps","position_size":-998618146,"funding_rate":0.0000125,"last_update":"2026-04-30 23:00:00"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"user","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"required":true,"description":"Filter by address"},{"in":"query","name":"coin","schema":{"type":"string","example":"BTC","minLength":1},"description":"Hyperliquid coin identifier. Core perps have no prefix (`BTC`, `HYPE`); spot pairs use `@N` (`@107`); builder DEXs prefix the symbol with the DEX name (`xyz:SILVER`)."},{"in":"query","name":"dex","schema":{"type":"string","examples":["perps","spot","xyz","cash","km","hyna","flx","vntl","para"],"minLength":1},"description":"DEX identifier. `perps` for core perps, `spot` for `@N` spot pairs, or a builder DEX name (e.g. `xyz`, `cash`). New builder DEXs are added on Hyperliquid permissionlessly — call `/v1/hyperliquid/dexes` for the live set."},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/hyperliquid/users/activity":{"get":{"operationId":"getV1HyperliquidUsersActivity","summary":"User Activity","description":"Returns a chronological feed of balance-changing events for a user — bridge deposits/withdrawals, on-chain account deposits/withdrawals, vault deposits/withdrawals, liquidations, and funding payments. Each row carries an `event_type` discriminator and a `notes` field with type-specific extras (e.g. funding rate and position size for funding events).\n\nFor trade fills, use `/v1/hyperliquid/markets/activity` instead.\n\nSupply `event_types` (comma-separated) to filter to a subset. Defaults to the last 30 days when no time range is specified — provide `start_time` and `end_time` to query older data.","tags":["Hyperliquid Users"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"block_num":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"timestamp":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"transaction_hash":{"type":"string"},"event_index":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"event_type":{"type":"string","enum":["bridge_deposit","bridge_withdraw_pending","bridge_withdraw_finalized","deposit","withdraw","vault_deposit","vault_withdraw","liquidation","funding"],"description":"Filter by balance-event type."},"user":{"type":"string"},"counterparty":{"type":"string"},"amount":{"type":"number"},"token":{"type":"string"},"notes":{"type":"string"}},"required":["block_num","timestamp","transaction_hash","event_index","event_type","user","counterparty","amount","token","notes"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"default":{"value":{"data":[{"block_num":979112711,"timestamp":"2026-04-30 23:00:00","transaction_hash":"0x0000000000000000000000000000000000000000000000000000000000000000","event_index":7001290,"event_type":"funding","user":"0xecb63caa47c7c4e77f60f1ce858cf28dc2b82b00","counterparty":"cash:SILVER","amount":-0.31788,"token":"USDC","notes":"position_size=685.52,rate=0.00000625"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"user","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"required":true,"description":"Filter by address"},{"in":"query","name":"event_types","schema":{"type":"string","enum":["bridge_deposit","bridge_withdraw_pending","bridge_withdraw_finalized","deposit","withdraw","vault_deposit","vault_withdraw","liquidation","funding"],"anyOf":[{"type":"string","enum":["bridge_deposit","bridge_withdraw_pending","bridge_withdraw_finalized","deposit","withdraw","vault_deposit","vault_withdraw","liquidation","funding"],"description":"Filter by balance-event type."},{"type":"string"},{"type":"array","items":{"type":"string","enum":["bridge_deposit","bridge_withdraw_pending","bridge_withdraw_finalized","deposit","withdraw","vault_deposit","vault_withdraw","liquidation","funding"],"description":"Filter by balance-event type."}}]},"description":"Filter by balance-event type.<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."},{"in":"query","name":"start_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"end_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/hyperliquid/vaults":{"get":{"operationId":"getV1HyperliquidVaults","summary":"Vault Listings","description":"Returns vault summaries — leader, lifetime flow totals (deposits, withdrawals, distributions, leader commissions), depositor and event counts, and last-activity timestamp.\n\nVault trading PnL/volume is exposed via `/v1/hyperliquid/users` with the vault address as `user` (vaults trade as normal accounts on Hyperliquid). Per-depositor breakdowns live on `/v1/hyperliquid/vaults/depositors`.\n\nVaults predating our indexer cutover (2026-02-02) have no `ledger_vault_creates` row and come back with `leader`/`created_at` as null and `initial_deposit`/`create_fee` as 0.","tags":["Hyperliquid Vaults"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"vault":{"type":"string"},"leader":{"anyOf":[{"type":"string"},{"type":"null"}]},"created_at":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},{"type":"null"}]},"initial_deposit":{"type":"number"},"create_fee":{"type":"number"},"lifetime_deposits":{"type":"number"},"lifetime_withdrawals":{"type":"number"},"lifetime_distributions":{"type":"number"},"lifetime_leader_commissions":{"type":"number"},"depositor_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"deposit_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"withdrawal_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"last_activity_at":{"anyOf":[{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},{"type":"null"}]}},"required":["vault","leader","created_at","initial_deposit","create_fee","lifetime_deposits","lifetime_withdrawals","lifetime_distributions","lifetime_leader_commissions","depositor_count","deposit_count","withdrawal_count","last_activity_at"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"default":{"value":{"data":[{"vault":"0xdfc24b077bc1425ad1dea75bcb6f8158e10df303","leader":null,"created_at":null,"initial_deposit":0,"create_fee":0,"lifetime_deposits":434257950.87,"lifetime_withdrawals":363605603.15,"lifetime_distributions":0,"lifetime_leader_commissions":0,"depositor_count":9088,"deposit_count":14829,"withdrawal_count":12601,"last_activity_at":"2026-04-30 22:59:21"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"vault","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"description":"Filter by address"},{"in":"query","name":"sort_by","schema":{"type":"string","enum":["lifetime_deposits","lifetime_withdrawals","lifetime_distributions","depositor_count","last_activity_at"],"default":"lifetime_deposits"}},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/hyperliquid/vaults/depositors":{"get":{"operationId":"getV1HyperliquidVaultsDepositors","summary":"Vault Depositors","description":"Returns the per-depositor breakdown for a single vault — one row per `(user, vault)` pair with lifetime deposits, lifetime net withdrawals (after vault commission and closing cost), distributions received, deposit and withdrawal counts, and last-activity timestamp.\n\nFor the vault-level summary, see `/v1/hyperliquid/vaults`.","tags":["Hyperliquid Vaults"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"user":{"type":"string"},"vault":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","description":"Filter by address","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"deposits":{"type":"number"},"deposit_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"withdrawals":{"type":"number"},"withdrawal_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"distributions_received":{"type":"number"},"last_activity_at":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"}},"required":["user","vault","deposits","deposit_count","withdrawals","withdrawal_count","distributions_received","last_activity_at"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"default":{"value":{"data":[{"user":"0xa97d92e993f487d4cdbdb381c77972d4fc3b39dd","vault":"0xdfc24b077bc1425ad1dea75bcb6f8158e10df303","deposits":1423386.01,"deposit_count":12,"withdrawals":885623.07,"withdrawal_count":5,"distributions_received":0,"last_activity_at":"2026-04-29 11:42:29"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"vault","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$","example":"0xd8da6bf26964af9d7eed9e03e53415d37aa96045"},"required":true,"description":"Filter by address"},{"in":"query","name":"sort_by","schema":{"type":"string","enum":["deposits","withdrawals","distributions_received","last_activity_at"],"default":"deposits"}},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/hyperliquid/platform":{"get":{"operationId":"getV1HyperliquidPlatform","summary":"Platform Activity","description":"Returns a platform-wide time series aggregating all coins and DEXs into one row per `timestamp`. Each row carries trade volume (split by side), trade and counterparty counts, distinct active coins, total fees, and a liquidation slice (`liquidations_volume`, `liquidations_count`, `unique_liquidated_users`).\n\nUse this endpoint instead of summing per-coin or per-DEX data client-side when you need cross-market totals. Per-coin OHLCV lives on `/v1/hyperliquid/markets/ohlc`; per-DEX on `/v1/hyperliquid/dexes`.","tags":["Hyperliquid Platform"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"interval_min":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"volume":{"type":"number"},"buy_volume":{"type":"number"},"sell_volume":{"type":"number"},"transactions":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"buys":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"sells":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"active_coins":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"total_fees":{"type":"number"},"liquidations_volume":{"type":"number"},"liquidations_count":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991},"unique_liquidated_users":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991}},"required":["timestamp","interval_min","volume","buy_volume","sell_volume","transactions","buys","sells","active_coins","total_fees","liquidations_volume","liquidations_count","unique_liquidated_users"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"default":{"value":{"data":[{"timestamp":"2026-04-30 00:00:00","interval_min":1440,"volume":8137264556.87,"buy_volume":4191715134.16,"sell_volume":3945549422.71,"transactions":5881845,"buys":2928397,"sells":2953448,"active_coins":391,"total_fees":469081.69,"liquidations_volume":16898784.51,"liquidations_count":3950,"unique_liquidated_users":1956}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"interval","schema":{"type":"string","enum":["1m","5m","10m","30m","1h","4h","1d","1w"],"default":"1d"},"description":"The interval* for which to aggregate price data (1-minute, 5-minutes, 10-minutes, 30-minutes, hourly, 4-hours, daily or weekly).<br>*Plan restricted."},{"in":"query","name":"start_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"end_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/polymarket/markets":{"get":{"operationId":"getV1PolymarketMarkets","summary":"Market Lookup","description":"Returns market metadata including question, outcomes with token IDs, volume, and status. Each market has exactly two outcomes (binary); multi-outcome scenarios are modeled as multiple markets grouped under one event.\n\nUse this to discover `token_id` values needed for OHLCV and position queries, or to resolve a slug to identifiers. When no identifier is provided, returns a paginated list for discovery.","tags":["Polymarket Markets"],"security":[],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"condition_id":{"type":"string"},"market_slug":{"type":"string"},"event_slug":{"anyOf":[{"type":"string"},{"type":"null"}]},"event_title":{"anyOf":[{"type":"string"},{"type":"null"}]},"question":{"type":"string"},"description":{"type":"string"},"outcomes":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"token_id":{"type":"string"}},"required":["label","token_id"]}},"closed":{"type":"boolean"},"neg_risk":{"type":"boolean"},"accepting_orders":{"type":"boolean"},"fees_enabled":{"type":"boolean"},"volume":{"type":"number"},"start_date":{"type":"string"},"end_date":{"type":"string"}},"required":["condition_id","market_slug","event_slug","event_title","question","description","outcomes","closed","neg_risk","accepting_orders","fees_enabled","volume","start_date","end_date"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"by_slug":{"value":{"data":[{"condition_id":"0x6331a779482df72d904c3c1e12b6409ff836bc06f8c97945cba9b25ada2c605c","market_slug":"will-the-portland-trail-blazers-win-the-2026-nba-finals","event_slug":"2026-nba-champion","event_title":"2026 NBA Champion","question":"Will the Portland Trail Blazers win the 2026 NBA Finals?","description":"","outcomes":[{"label":"Yes","token_id":"82402823484466457361170410951601106261368113664328436062375970009969959380598"},{"label":"No","token_id":"48262548906086150698299934962091284390063927164151224719187427455086357699251"}],"closed":false,"neg_risk":true,"accepting_orders":true,"fees_enabled":false,"volume":5483559.78,"start_date":"2025-06-23T16:02:41.286933Z","end_date":"2026-07-01T00:00:00Z"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"condition_id","schema":{"type":"string","example":"0x9708334534b504e2025a5a6af92f8600808c10be577e5066f920c40625fbec16"}},{"in":"query","name":"market_slug","schema":{"type":"string","example":"will-bitcoin-reach-150k-in-january-2026"}},{"in":"query","name":"token_id","schema":{"type":"string","example":"53342136288932702007624506186417846874594504126387502748453102780630218207922"}},{"in":"query","name":"event_slug","schema":{"type":"string","example":"will-bitcoin-reach-150k-in-january-2026"}},{"in":"query","name":"closed","schema":{"type":"boolean"}},{"in":"query","name":"sort_by","schema":{"type":"string","enum":["volume","end_date","start_date"],"default":"volume"}},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/polymarket/markets/ohlc":{"get":{"operationId":"getV1PolymarketMarketsOhlc","summary":"Market OHLCV","description":"Returns OHLCV price data for a single outcome token. Each market has two outcome tokens (e.g. Yes and No) — use `/v1/polymarket/markets` to discover them.\n\nPrices are in USD per share (0 to 1). Volume and fees are in USDC.","tags":["Polymarket Markets"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"open":{"type":"number"},"high":{"type":"number"},"low":{"type":"number"},"close":{"type":"number"},"volume":{"type":"number"},"trades":{"type":"number"},"buys":{"type":"number"},"sells":{"type":"number"},"unique_makers":{"type":"number"},"unique_takers":{"type":"number"},"total_fees":{"type":"number"},"total_refunds":{"type":"number"},"net_fees":{"type":"number"},"fee_count":{"type":"number"},"effective_fee_rate_gross":{"type":"number"},"effective_fee_rate":{"type":"number"},"market":{"type":"object","properties":{"condition_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"market_slug":{"anyOf":[{"type":"string"},{"type":"null"}]},"token_id":{"type":"string"},"outcome_label":{"anyOf":[{"type":"string"},{"type":"null"}]},"closed":{"type":"boolean"}},"required":["condition_id","market_slug","token_id","outcome_label","closed"]}},"required":["timestamp","open","high","low","close","volume","trades","buys","sells","unique_makers","unique_takers","total_fees","total_refunds","net_fees","fee_count","effective_fee_rate_gross","effective_fee_rate","market"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"daily":{"value":{"data":[{"timestamp":"2026-04-01 00:00:00","open":0.997,"high":0.998,"low":0.997,"close":0.998,"volume":295143.37,"trades":1206,"buys":498,"sells":708,"unique_makers":592,"unique_takers":121,"total_fees":0,"total_refunds":0,"net_fees":0,"fee_count":0,"effective_fee_rate_gross":0,"effective_fee_rate":0,"market":{"condition_id":"0x6331a779482df72d904c3c1e12b6409ff836bc06f8c97945cba9b25ada2c605c","market_slug":"will-the-portland-trail-blazers-win-the-2026-nba-finals","token_id":"48262548906086150698299934962091284390063927164151224719187427455086357699251","outcome_label":"No","closed":false}}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"token_id","schema":{"type":"string","example":"53342136288932702007624506186417846874594504126387502748453102780630218207922"},"required":true},{"in":"query","name":"interval","schema":{"type":"string","enum":["1m","5m","10m","30m","1h","4h","1d","1w"],"default":"1d"},"description":"The interval* for which to aggregate price data (1-minute, 5-minutes, 10-minutes, 30-minutes, hourly, 4-hours, daily or weekly).<br>*Plan restricted."},{"in":"query","name":"start_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"end_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/polymarket/markets/oi":{"get":{"operationId":"getV1PolymarketMarketsOi","summary":"Market Open Interest","description":"Returns open interest time-series for a market. Open interest is the USDC collateral locked into conditional token positions — it increases on splits (deposit USDC to mint Yes+No pairs) and decreases on merges (return pairs to withdraw USDC) or redemptions.\n\nProvide **one** of `condition_id` or `market_slug`.","tags":["Polymarket Markets"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"net_open_interest":{"type":"number"},"split_amount":{"type":"number"},"merge_amount":{"type":"number"},"split_count":{"type":"number"},"merge_count":{"type":"number"},"transactions":{"type":"number"},"unique_stakeholders":{"type":"number"},"market":{"type":"object","properties":{"condition_id":{"type":"string"},"market_slug":{"anyOf":[{"type":"string"},{"type":"null"}]},"token_id":{"type":"null"},"outcome_label":{"type":"null"},"closed":{"type":"boolean"}},"required":["condition_id","market_slug","token_id","outcome_label","closed"]}},"required":["timestamp","net_open_interest","split_amount","merge_amount","split_count","merge_count","transactions","unique_stakeholders","market"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"bitcoin_threshold":{"value":{"data":[{"timestamp":"2025-04-04 00:00:00","net_open_interest":43835.62,"split_amount":292320.96,"merge_amount":248485.34,"split_count":989,"merge_count":172,"transactions":1161,"unique_stakeholders":14,"market":{"condition_id":"0x39e227f0e4a6c0a7b282d77ae0e7d247d0cc4b8e69a348e853442bbd4db10f6a","market_slug":"bitcoin-above-86000-on-april-4","token_id":null,"outcome_label":null,"closed":false}}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"condition_id","schema":{"type":"string","example":"0x9708334534b504e2025a5a6af92f8600808c10be577e5066f920c40625fbec16"}},{"in":"query","name":"market_slug","schema":{"type":"string","example":"will-bitcoin-reach-150k-in-january-2026"}},{"in":"query","name":"interval","schema":{"type":"string","enum":["1m","5m","10m","30m","1h","4h","1d","1w"],"default":"1d"},"description":"The interval* for which to aggregate price data (1-minute, 5-minutes, 10-minutes, 30-minutes, hourly, 4-hours, daily or weekly).<br>*Plan restricted."},{"in":"query","name":"start_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"end_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/polymarket/markets/activity":{"get":{"operationId":"getV1PolymarketMarketsActivity","summary":"Market Activity","description":"Returns a chronological feed of on-chain trades, position splits, merges, and redemptions. Each row includes the transaction hash, block number, and scaled amounts.\n\nFor trades, `market.token_id` and `market.outcome_label` identify the specific outcome token. For splits, merges, and redemptions, these are null because the operation applies to the market as a whole.\n\nAt least one of `user`, `token_id`, or `condition_id` is required. Defaults to the last 24 hours when no time range is specified — provide `start_time` and `end_time` to query older data.","tags":["Polymarket Markets"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"event_type":{"type":"string"},"timestamp":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"block_num":{"type":"number"},"tx_hash":{"type":"string"},"user":{"type":"string"},"amount":{"type":"string"},"value":{"type":"number"},"fee_amount":{"type":"string"},"fee_value":{"type":"number"},"market":{"type":"object","properties":{"condition_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"market_slug":{"anyOf":[{"type":"string"},{"type":"null"}]},"token_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"outcome_label":{"anyOf":[{"type":"string"},{"type":"null"}]},"closed":{"type":"boolean"}},"required":["condition_id","market_slug","token_id","outcome_label","closed"]}},"required":["event_type","timestamp","block_num","tx_hash","user","amount","value","fee_amount","fee_value","market"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"recent_activity":{"value":{"data":[{"event_type":"trade","timestamp":"2026-04-02 16:51:31","block_num":85014327,"tx_hash":"0xf190865afd395e2f4b8f2e5f8ceb2c05a86d94a73ea411e8a8a3fc649924c420","user":"0x38e598961dd0456a7fb2e758bd433d3e59fb8a4a","amount":"3976744","value":3.98,"fee_amount":"526315","fee_value":0.53,"market":{"condition_id":"0xcb37916b953e6b37a5be32ceabc5a093614be15d9e6abb7668bf6400fbf36d46","market_slug":"bitcoin-up-or-down-on-april-3-2026","token_id":"3861173442961229042274748637211736540847931193208187121747580704941582603312","outcome_label":"Down","closed":false}},{"event_type":"split","timestamp":"2026-04-02 16:54:27","block_num":85014415,"tx_hash":"0x144e86c0cd14880a6615dc1853e4438287efde3a9fb0ddca618a1b48d22d59bf","user":"0x4bfb41d5b3570defd03c39a9a4d8de6bd8b8982e","amount":"680000","value":0.68,"fee_amount":"0","fee_value":0,"market":{"condition_id":"0xb03edede6288cd4e3af35e9aa2d8eeb1a8a0fcde8ba270cc2ae3677bd6dc44f0","market_slug":"btc-updown-5m-1775148600","token_id":null,"outcome_label":null,"closed":false}}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"user","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$"}},{"in":"query","name":"token_id","schema":{"type":"string","example":"53342136288932702007624506186417846874594504126387502748453102780630218207922"}},{"in":"query","name":"condition_id","schema":{"type":"string","example":"0x9708334534b504e2025a5a6af92f8600808c10be577e5066f920c40625fbec16"}},{"in":"query","name":"event_type","schema":{"type":"string","enum":["trade","split","merge","redeem"]},"description":"Filter by event type"},{"in":"query","name":"start_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"end_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/polymarket/markets/positions":{"get":{"operationId":"getV1PolymarketMarketsPositions","summary":"Market Positions","description":"Returns all user positions for a specific outcome token — a leaderboard view. Each row is one user's cumulative position: cost basis, PNL, shares held, and current value.\n\nFor a user's portfolio across all markets, use `/v1/polymarket/positions` instead.","tags":["Polymarket Markets"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"user":{"type":"string"},"buy_cost":{"type":"number"},"sell_revenue":{"type":"number"},"realized_pnl":{"type":"number"},"unrealized_pnl":{"type":"number"},"total_pnl":{"type":"number"},"pnl_pct":{"type":"number"},"net_position":{"type":"number"},"avg_price":{"type":"number"},"current_price":{"type":"number"},"position_value":{"type":"number"},"active":{"type":"boolean"},"buys":{"type":"number"},"sells":{"type":"number"},"transactions":{"type":"number"},"market":{"type":"object","properties":{"condition_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"market_slug":{"anyOf":[{"type":"string"},{"type":"null"}]},"token_id":{"type":"string"},"outcome_label":{"anyOf":[{"type":"string"},{"type":"null"}]},"closed":{"type":"boolean"}},"required":["condition_id","market_slug","token_id","outcome_label","closed"]}},"required":["user","buy_cost","sell_revenue","realized_pnl","unrealized_pnl","total_pnl","pnl_pct","net_position","avg_price","current_price","position_value","active","buys","sells","transactions","market"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"top_holders":{"value":{"data":[{"user":"0xe8dd7741ccb12350957ec71e9ee332e0d1e6ec86","buy_cost":235027.61,"sell_revenue":0,"realized_pnl":-235027.61,"unrealized_pnl":235202.69,"total_pnl":175.08,"pnl_pct":-1,"net_position":235910.42,"avg_price":0.996,"current_price":0.997,"position_value":235202.69,"active":true,"buys":4573,"sells":0,"transactions":4573,"market":{"condition_id":"0x6331a779482df72d904c3c1e12b6409ff836bc06f8c97945cba9b25ada2c605c","market_slug":"will-the-portland-trail-blazers-win-the-2026-nba-finals","token_id":"48262548906086150698299934962091284390063927164151224719187427455086357699251","outcome_label":"No","closed":false}}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"token_id","schema":{"type":"string","example":"53342136288932702007624506186417846874594504126387502748453102780630218207922"},"required":true},{"in":"query","name":"closed","schema":{"type":"boolean"}},{"in":"query","name":"sort_by","schema":{"type":"string","enum":["position_value","realized_pnl","unrealized_pnl","total_pnl","pnl_pct","transactions","avg_price"],"default":"position_value"}},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/polymarket/platform":{"get":{"operationId":"getV1PolymarketPlatform","summary":"Platform Aggregates","description":"Returns platform-wide time-series combining trading volume, open interest, and fee aggregates across all Polymarket markets.","tags":["Polymarket Platform"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"timestamp":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}[T ]\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?(?:Z|[+-]\\d{2}:\\d{2})?$"},"volume":{"type":"number"},"buy_volume":{"type":"number"},"sell_volume":{"type":"number"},"trades":{"type":"number"},"buys":{"type":"number"},"sells":{"type":"number"},"net_open_interest":{"type":"number"},"split_amount":{"type":"number"},"merge_amount":{"type":"number"},"split_count":{"type":"number"},"merge_count":{"type":"number"},"oi_transactions":{"type":"number"},"total_fees":{"type":"number"},"total_refunds":{"type":"number"},"net_fees":{"type":"number"},"fee_count":{"type":"number"},"effective_fee_rate_gross":{"type":"number"},"effective_fee_rate":{"type":"number"}},"required":["timestamp","volume","buy_volume","sell_volume","trades","buys","sells","net_open_interest","split_amount","merge_amount","split_count","merge_count","oi_transactions","total_fees","total_refunds","net_fees","fee_count","effective_fee_rate_gross","effective_fee_rate"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"daily":{"value":{"data":[{"timestamp":"2026-04-15 00:00:00","volume":148067185.09,"buy_volume":39470527.47,"sell_volume":108596657.62,"trades":3065040,"buys":638547,"sells":2426493,"net_open_interest":161012348.11,"split_amount":222905687.23,"merge_amount":61893339.12,"split_count":4045998,"merge_count":338837,"oi_transactions":4384835,"total_fees":20602487.78,"total_refunds":17060492.91,"net_fees":3541994.86,"fee_count":7360794,"effective_fee_rate_gross":0.139,"effective_fee_rate":0.024}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"interval","schema":{"type":"string","enum":["1m","5m","10m","30m","1h","4h","1d","1w"],"default":"1d"},"description":"The interval* for which to aggregate price data (1-minute, 5-minutes, 10-minutes, 30-minutes, hourly, 4-hours, daily or weekly).<br>*Plan restricted."},{"in":"query","name":"start_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"end_time","schema":{"type":"string"},"description":"UNIX timestamp in seconds or date string (e.g. \"2025-01-01T00:00:00Z\", \"2025-01-01\", ...)."},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/polymarket/users":{"get":{"operationId":"getV1PolymarketUsers","summary":"User Lookup","description":"Returns trading statistics per user: volume, PNL (realized, unrealized, total), trade counts, and activity window. When no user address is provided, returns a paginated leaderboard for discovery.\n\nSupports lookback windows via `interval`: `1h`, `1d`, `1w`, `30d`. Omit for all-time. Data refreshes hourly.","tags":["Polymarket Users"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"user":{"type":"string"},"buys":{"type":"number"},"sells":{"type":"number"},"transactions":{"type":"number"},"volume_bought":{"type":"number"},"volume_sold":{"type":"number"},"total_volume":{"type":"number"},"realized_pnl":{"type":"number"},"unrealized_pnl":{"type":"number"},"total_pnl":{"type":"number"},"first_trade":{"type":"string"},"last_trade":{"type":"string"}},"required":["user","buys","sells","transactions","volume_bought","volume_sold","total_volume","realized_pnl","unrealized_pnl","total_pnl","first_trade","last_trade"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"leaderboard":{"value":{"data":[{"user":"0x4ce73141dbfce41e65db3723e31059a730f0abad","buys":32168,"sells":294299,"transactions":326467,"volume_bought":11882418.59,"volume_sold":35795922.98,"total_volume":47678341.57,"realized_pnl":23913504.39,"unrealized_pnl":12090462.43,"total_pnl":36003966.82,"first_trade":"2024-05-30 00:00:00","last_trade":"2024-11-28 00:00:00"}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"user","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$"}},{"in":"query","name":"interval","schema":{"type":"string","enum":["1h","1d","1w","30d"]},"description":"Lookback window for user statistics (1 hour, 1 day, 1 week, 30 days). Omit for all-time."},{"in":"query","name":"sort_by","schema":{"type":"string","enum":["total_volume","realized_pnl","unrealized_pnl","total_pnl","transactions"],"default":"total_volume"}},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/polymarket/users/positions":{"get":{"operationId":"getV1PolymarketUsersPositions","summary":"User Positions","description":"Returns a user's positions with PNL breakdown per outcome token. Each row is one token's cumulative position: cost basis, realized PNL, net shares held, average entry price, and current market price.\n\nUse `closed=false` for positions on live markets, or `closed=true` for resolved markets.","tags":["Polymarket Users"],"security":[{"bearerAuth":[]}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object","properties":{"user":{"type":"string"},"buy_cost":{"type":"number"},"sell_revenue":{"type":"number"},"realized_pnl":{"type":"number"},"unrealized_pnl":{"type":"number"},"total_pnl":{"type":"number"},"pnl_pct":{"type":"number"},"net_position":{"type":"number"},"avg_price":{"type":"number"},"current_price":{"type":"number"},"position_value":{"type":"number"},"active":{"type":"boolean"},"buys":{"type":"number"},"sells":{"type":"number"},"transactions":{"type":"number"},"market":{"type":"object","properties":{"condition_id":{"anyOf":[{"type":"string"},{"type":"null"}]},"market_slug":{"anyOf":[{"type":"string"},{"type":"null"}]},"token_id":{"type":"string"},"outcome_label":{"anyOf":[{"type":"string"},{"type":"null"}]},"closed":{"type":"boolean"}},"required":["condition_id","market_slug","token_id","outcome_label","closed"]}},"required":["user","buy_cost","sell_revenue","realized_pnl","unrealized_pnl","total_pnl","pnl_pct","net_position","avg_price","current_price","position_value","active","buys","sells","transactions","market"]}},"statistics":{"type":"object","properties":{"elapsed":{"type":"number"},"rows_read":{"type":"number"},"bytes_read":{"type":"number"}}},"pagination":{"type":"object","properties":{"previous_page":{"type":"integer","minimum":1,"maximum":9007199254740991},"current_page":{"type":"integer","minimum":1,"maximum":9007199254740991}},"required":["previous_page","current_page"]},"results":{"type":"number"},"request_time":{"description":"ISO 8601 datetime string","type":"string"},"duration_ms":{"type":"number"}},"required":["data","statistics","pagination","results","request_time","duration_ms"]},"examples":{"user_positions":{"value":{"data":[{"user":"0x38e598961dd0456a7fb2e758bd433d3e59fb8a4a","buy_cost":6438.35,"sell_revenue":247.09,"realized_pnl":-6191.26,"unrealized_pnl":9005.64,"total_pnl":2814.38,"pnl_pct":-0.96,"net_position":9096.61,"avg_price":0.68,"current_price":0.99,"position_value":9005.64,"active":true,"buys":693,"sells":20,"transactions":713,"market":{"condition_id":"0x59feadddd58e7821c086ee9f3dc4f544514b94ebd0e8d645a3c4d80ebdd354a2","market_slug":"btc-updown-5m-1771359600","token_id":"25362470215305294361999917933416973453076214567033270695579745712197481070383","outcome_label":"Up","closed":false}}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"user","schema":{"type":"string","format":"evm-address","pattern":"^(0[xX])?[0-9a-fA-F]{40}$"},"required":true},{"in":"query","name":"token_id","schema":{"type":"string","example":"53342136288932702007624506186417846874594504126387502748453102780630218207922"}},{"in":"query","name":"condition_id","schema":{"type":"string","example":"0x9708334534b504e2025a5a6af92f8600808c10be577e5066f920c40625fbec16"}},{"in":"query","name":"market_slug","schema":{"type":"string","example":"will-bitcoin-reach-150k-in-january-2026"}},{"in":"query","name":"closed","schema":{"type":"boolean"}},{"in":"query","name":"sort_by","schema":{"type":"string","enum":["position_value","realized_pnl","unrealized_pnl","total_pnl","pnl_pct","transactions","avg_price","current_price"],"default":"position_value"}},{"in":"query","name":"limit","schema":{"default":10,"type":"integer","minimum":1,"maximum":1000},"description":"Number of items* returned in a single request.<br>*Plan restricted."},{"in":"query","name":"page","schema":{"default":1,"type":"integer","minimum":1,"maximum":767465558638},"description":"Page number to fetch.<br>Empty `data` array signifies end of results."}]}},"/v1/health":{"get":{"operationId":"getV1Health","summary":"Health Check","description":"Verifies that all database connections are established.","tags":["Monitoring"],"responses":{"200":{"description":"All database connections are healthy","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"}},"required":["status"]},"examples":{"example":{"summary":"Healthy","value":{"status":"OK"}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}},"503":{"description":"One or more database connections failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"type":"string"},"error":{"type":"string"}},"required":["status","error"]},"examples":{"example":{"summary":"Unhealthy","value":{"status":"ERROR","error":"Database ping failed for cluster default"}}}}}}}}},"/v1/version":{"get":{"operationId":"getV1Version","summary":"API Version Info","description":"Returns API version, build date, and commit information.","tags":["Monitoring"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"version":{"type":"string"},"date":{"type":"string"},"commit":{"type":"string"}},"required":["version","date","commit"]},"examples":{"example":{"value":{"version":"3.17.3","commit":"3010390","date":"2026-05-08","repo":"pinax-network/token-api"}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}}}},"/v1/networks":{"get":{"operationId":"getV1Networks","summary":"Supported Networks","description":"Returns supported blockchain networks with identifiers, metadata, and indexed block information per database category.","tags":["Monitoring"],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","properties":{"networks":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"fullName":{"type":"string"},"shortName":{"type":"string"},"caip2Id":{"type":"string"},"networkType":{"type":"string"},"icon":{"type":"object","properties":{"web3Icons":{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]}},"required":["web3Icons"]},"aliases":{"type":"array","items":{"type":"string"}},"indexed_to":{"type":"array","items":{"type":"object","properties":{"category":{"type":"string"},"version":{"type":"string"},"block_num":{"type":"number"},"datetime":{"type":"string"},"timestamp":{"type":"number"}},"required":["category","version","block_num","datetime","timestamp"]}}},"required":["id","fullName","shortName","caip2Id","networkType","icon","aliases","indexed_to"]}}},"required":["networks"]},"examples":{"example":{"value":{"networks":[{"id":"mainnet","fullName":"Ethereum Mainnet","shortName":"Ethereum","networkType":"mainnet","nativeToken":"ETH","caip2Id":"eip155:1","icon":{"web3Icons":{"name":"ethereum"}},"aliases":["ethereum","eth","eth-mainnet","evm-1"],"indexed_to":[{"category":"transfers","version":"0.2.2","block_num":24278225,"datetime":"2026-01-20 19:57:11","timestamp":1768939031}]}]}}}}}},"400":{"description":"Client side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":400,"code":"bad_query_input","message":"Invalid query parameter provided"}}}}}},"401":{"description":"Authentication failed","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":401,"code":"unauthorized","message":"Authentication required"}}}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":403,"code":"forbidden","message":"Access denied"}}}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":400},{"type":"number","const":401},{"type":"number","const":403},{"type":"number","const":404},{"type":"number","const":405}]},"code":{"type":"string","enum":["authentication_failed","bad_header","missing_required_header","bad_query_input","forbidden","method_not_allowed","route_not_found","unauthorized","not_found_data"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":404,"code":"not_found_data","message":"Resource not found"}}}}}},"500":{"description":"Server side error","content":{"application/json":{"schema":{"type":"object","properties":{"status":{"anyOf":[{"type":"number","const":500},{"type":"number","const":502},{"type":"number","const":504}]},"code":{"type":"string","enum":["bad_database_response","connection_refused","database_timeout","internal_server_error"]},"message":{"type":"string"}},"required":["status","code","message"]},"examples":{"example":{"value":{"status":500,"code":"internal_server_error","message":"An unexpected error occurred"}}}}}}},"parameters":[{"in":"query","name":"network","schema":{"example":"arbitrum-one","anyOf":[{"description":"Network ID to filter by","example":"arbitrum-one","type":"string"},{"type":"string"},{"type":"array","items":{"description":"Network ID to filter by","example":"arbitrum-one","type":"string"}}]},"description":"Network ID to filter by<br>Single value or array of values* (separate multiple values with `,`)<br>*Plan restricted."}]}},"/SKILLS.md":{"get":{"operationId":"getSkillsMarkdown","summary":"Agent Skills Reference","description":"Returns the public Markdown reference for AI agents integrating with Token API.","tags":["Documentation"],"security":[],"responses":{"200":{"description":"Successful Response","content":{"text/markdown; charset=UTF-8":{"schema":{"type":"string","example":"---\nname: Token API\ndescription: Real-time token, balance, transfer, holder, DEX, NFT, Polymarket, and Hyperliquid data across EVM, SVM, and TVM networks.\n---\n\n# Token API\n\n> Quick reference for AI agents using Token API. The authoritative machine-readable contract is `GET /openapi`.\n\n..."}}}}}}},"/llms.txt":{"get":{"operationId":"getLlmsText","summary":"LLM Documentation Index","description":"Returns the public llms.txt documentation index for AI tools discovering Token API.","tags":["Documentation"],"security":[],"responses":{"200":{"description":"Successful Response","content":{"text/markdown; charset=UTF-8":{"schema":{"type":"string","example":"# Token API\n\n> Real-time token, balance, transfer, holder, DEX, NFT, Polymarket, and Hyperliquid data across EVM, SVM, and TVM networks.\n\n..."}}}}}}},"/openapi":{"get":{"operationId":"getOpenapiSpec","summary":"OpenAPI Specification","description":"Returns the public OpenAPI specification for Token API.","tags":["Documentation"],"security":[],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"object","example":{"openapi":"3.1.0","info":{},"servers":[],"paths":{},"components":{},"tags":[]}}}}}}}}}}