Ethscriptions Endpoints

1. Get All Ethscriptions

Returns a list of all Ethscriptions within the specified parameter range.

API

GET https://ethinscription.org/api/indexer/ethscriptions

Query Parameters

page (integer)

per_page (integer)

sort_order (string): "asc" or "desc"

Example

GET https://ethinscription.org/api/indexer/ethscriptions?page=1001&per_page=2&sort_order=asc

Responses

{"code":200,"data":[{"id":2001,"transaction_hash":"0x072cc7a696f30e1f0cbba60b3a29dcd3194684851f1d63cc50ce6ba58adfec20","block_number":17495371,"transaction_index":305,"block_timestamp":1686954575,"block_blockhash":"0xdda1fc48fb94484bd6f64a09fe83f57485a78ffdca3b98a57b5ea5bded7741bc","event_log_index":null,"ethscription_number":2000,"creator":"0x369615bc57975b06c418f42d3fda3754a385b97b","initial_owner":"0x369615bc57975b06c418f42d3fda3754a385b97b","current_owner":"0xadba73e659756a21f8a5649ede1209e4bd895749","previous_owner":"0x369615bc57975b06c418f42d3fda3754a385b97b","content_uri":"data:image\/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAAn0lEQVR42mNgGAVUBP+RMNUN\/K9m6AXH6HJkGY5sIAz\/v4FdnBxLsBqEC5PtCxAghqY4Dmjmg9sbG7BFKC5Mng96e3v\/b9myBScGyZNtAcxwfC5Hkiff9TSxABb+tAqi\/yRGMnnJdFmeDtgSZIxsORKffAuwWQLDILnBbQHMEJglyOFOEwto4gNkS9AxpZUPRuqhpuFYLaB2tYnNApIBADo4o2bXvmRrAAAAAElFTkSuQmCC","content_sha":"0xf2c80cf2350a207d91dceda6765d60c7eb6e2fd4151679ea6063614ff660af76","esip6":false,"mimetype":"image\/png","media_type":"image","mime_subtype":"png","gas_price":"20237690475.0","gas_used":27200,"transaction_fee":"550465180920000.0","value":"0.0","created_at":"2024-01-11 11:11:48","updated_at":"2024-01-11 13:09:27"},{"id":2002,"transaction_hash":"0xb7442b846204abb4282b8858692ea3a8c330a5ab5a75e9f2d52f9e025eb10b88","block_number":17495371,"transaction_index":337,"block_timestamp":1686954575,"block_blockhash":"0xdda1fc48fb94484bd6f64a09fe83f57485a78ffdca3b98a57b5ea5bded7741bc","event_log_index":null,"ethscription_number":2001,"creator":"0x4936b305102f442080d4711f14c5f0318e3caf74","initial_owner":"0x4936b305102f442080d4711f14c5f0318e3caf74","current_owner":"0x5fd2e3ba05c862e62a34b9f63c45c0df622ac112","previous_owner":"0x4936b305102f442080d4711f14c5f0318e3caf74","content_uri":"data:image\/png;base64,iVBORw0KGgoAAAANSUhEUgAAABgAAAAYCAYAAADgdz34AAAA0klEQVR42mNgGAWjQMx8yX98mGLDpZxP4MVkW0KM4SRZAFMMo0V0auBsZIzFcOJ9gGw4VCMGRjIUHRNnAdRwBpjGTB5XOEY2EIs4w927dxsIWoDEBWvs4Y2GYxD\/9sYGrOJEWYBsOMygtYoJcIxPnCwLYIbBMEwMXRymiVgL\/v+\/qYZhIC5MjgXw8J9ZE4nLQIotYIBZgM0SGAbJkZQPcFmADePKJxRZoCHNCcYguWPHjmHgR9FqJFkCDwaa+QA5rPFYQjbAl+4pNhyXBVQFVLEAAAREu7vRWlZ7AAAAAElFTkSuQmCC","content_sha":"0x021d569b623f14dfafaa28e409d009b1e5df0b0f5d17d7205e978202df521e2d","esip6":false,"mimetype":"image\/png","media_type":"image","mime_subtype":"png","gas_price":"20237690475.0","gas_used":28560,"transaction_fee":"577988439966000.0","value":"0.0","created_at":"2024-01-11 11:11:48","updated_at":"2024-01-11 11:17:27"}],"pagination":{"page":1001,"per_page":2,"total":2425872}}

2. Get All Ethscriptions

Returns list of Ethscriptions owned by specific ETH address

API

GET https://ethinscription.org/api/indexer/ethscriptions/owned_by/{address}

Query Parameters

page (integer)

per_page (integer)

sort_order (string): "asc" or "desc"

Example

GET https://ethinscription.org/api/indexer/ethscriptions/owned_by/0x33f3601c9b44ced2b4043f5e2db65bff289c57c3?page=1&per_page=6&sort_order=asc

Responses

{"code":200,"data":[{"id":287476,"transaction_hash":"0x95024f7f1cf7ffadcf0327987902b424f231a884092105199abb49eeb27ce237","block_number":17557664,"transaction_index":106,"block_timestamp":1687710299,"block_blockhash":"0xbb253b6f8fc105dd2a7c1b717adb246792e8e96bfba634a87468441c55aed140","event_log_index":null,"ethscription_number":287475,"creator":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","initial_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","current_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","previous_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","content_uri":"data:,123.com","content_sha":"0x8c64ecd5687aa94a1ca7ce712aeb4cbc329148ced01a6af144c125456040ee05","esip6":false,"mimetype":"text\/plain","media_type":"text","mime_subtype":"plain","gas_price":"14676285602.0","gas_used":21208,"transaction_fee":"311254665047216.0","value":"0.0","created_at":"2024-01-11 16:22:45","updated_at":"2024-01-11 16:22:45"},{"id":288014,"transaction_hash":"0x00bbb3336eb12568f231ba032a97856f1206194b6ec0a35090e6f39caf6abcbf","block_number":17557674,"transaction_index":196,"block_timestamp":1687710431,"block_blockhash":"0xaed1b3e60e511bba8b525456e6634b500238a70289ca242dab21c5024bd4ee4b","event_log_index":null,"ethscription_number":288013,"creator":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","initial_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","current_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","previous_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","content_uri":"data:,4.com","content_sha":"0xc49590f15953059cf18f48a8aa94e82ac67d84f16e453c5d7586b9ffe0adc905","esip6":false,"mimetype":"text\/plain","media_type":"text","mime_subtype":"plain","gas_price":"12842069300.0","gas_used":21176,"transaction_fee":"271943659496800.0","value":"0.0","created_at":"2024-01-11 16:22:50","updated_at":"2024-01-11 16:22:50"},{"id":288348,"transaction_hash":"0x13cabdbe3bc89baa9fab8f3a07267d7f800526100b772354e3dbe1a5184177d0","block_number":17557684,"transaction_index":138,"block_timestamp":1687710551,"block_blockhash":"0x818419015f8baeee483a3d688526dc71971f3f211a1ea86838cdfb48cf62bf9a","event_log_index":null,"ethscription_number":288347,"creator":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","initial_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","current_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","previous_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","content_uri":"data:,88.com","content_sha":"0xd28cb354994376af140ac175d8ed658c20d021440a94c5f1b12032eb6fe28c0b","esip6":false,"mimetype":"text\/plain","media_type":"text","mime_subtype":"plain","gas_price":"14765193613.0","gas_used":21192,"transaction_fee":"312903983046696.0","value":"0.0","created_at":"2024-01-11 16:22:54","updated_at":"2024-01-11 16:22:54"},{"id":288379,"transaction_hash":"0xa97800b82950473aefed0494dfbd18beb6317c6dfb9282b1d636e1519af8a32c","block_number":17557685,"transaction_index":164,"block_timestamp":1687710563,"block_blockhash":"0x3572d025ac542e70caa46395047097fa316633c1b1dabe6c9fcbaf3793719b07","event_log_index":null,"ethscription_number":288378,"creator":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","initial_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","current_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","previous_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","content_uri":"data:,99.com","content_sha":"0x9b954ccefaf4f2f9f489d0158be86e53631140a8f4e9078a82211765459b717e","esip6":false,"mimetype":"text\/plain","media_type":"text","mime_subtype":"plain","gas_price":"15127514330.0","gas_used":21192,"transaction_fee":"320582283681360.0","value":"0.0","created_at":"2024-01-11 16:22:54","updated_at":"2024-01-11 16:22:54"},{"id":288429,"transaction_hash":"0xe7d5408e0fb492eb491e7c4af9d7fb8c58e6e44182723b9e4c0752075cab8d16","block_number":17557687,"transaction_index":136,"block_timestamp":1687710587,"block_blockhash":"0xfe9e9600efbe7d3d34ba468e16a796915cc4afe92494d99628a6eef915d06b60","event_log_index":null,"ethscription_number":288428,"creator":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","initial_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","current_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","previous_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","content_uri":"data:,77.com","content_sha":"0x150bae7b4e5561900b7a7be7f2d427e07e2dec629f27c3b6c65aca84ee80830f","esip6":false,"mimetype":"text\/plain","media_type":"text","mime_subtype":"plain","gas_price":"16330442359.0","gas_used":21192,"transaction_fee":"346074734471928.0","value":"0.0","created_at":"2024-01-11 16:22:55","updated_at":"2024-01-11 16:22:55"},{"id":288513,"transaction_hash":"0x7c29cec71c50766c488d9988c2a37e72f99faa41df65af4f1b96ec5ab797484d","block_number":17557689,"transaction_index":516,"block_timestamp":1687710611,"block_blockhash":"0xd5a2d65e069f890d5d461aff0323d671a6c8d8c820baff4ac86243e39819cbe1","event_log_index":null,"ethscription_number":288512,"creator":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","initial_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","current_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","previous_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","content_uri":"data:,66.com","content_sha":"0xf109118f006a74a6eebd649b9ff311f6d1a49e9f72befd36da7e9909e77c2610","esip6":false,"mimetype":"text\/plain","media_type":"text","mime_subtype":"plain","gas_price":"15389131677.0","gas_used":21192,"transaction_fee":"326126478498984.0","value":"0.0","created_at":"2024-01-11 16:22:57","updated_at":"2024-01-11 16:22:57"},{"id":288542,"transaction_hash":"0xbd7a2176143945bf376bc53c39d8809444fa0310798a3aa64fc5124a60090bfe","block_number":17557691,"transaction_index":84,"block_timestamp":1687710635,"block_blockhash":"0xdda09d379be5b7e9fb82c394752ee5673526aa0756d26a21e66f8b2b3985dfce","event_log_index":null,"ethscription_number":288541,"creator":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","initial_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","current_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","previous_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","content_uri":"data:,55.com","content_sha":"0x23b57dcf250c331b8ea115e7154f8f4842dad6f642f100c513d4c6fe8c616a8b","esip6":false,"mimetype":"text\/plain","media_type":"text","mime_subtype":"plain","gas_price":"16547582713.0","gas_used":21192,"transaction_fee":"350676372853896.0","value":"0.0","created_at":"2024-01-11 16:22:58","updated_at":"2024-01-11 16:22:58"},{"id":288609,"transaction_hash":"0xb0ce99f946bb968e5478b20443b0036d16d2a504c740c088eb95362fac760c24","block_number":17557692,"transaction_index":192,"block_timestamp":1687710647,"block_blockhash":"0x73fd3fe24558f2416dff6ff0998e8e021633f6f4be3a78ec0c2f59bbdb3846ec","event_log_index":null,"ethscription_number":288608,"creator":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","initial_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","current_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","previous_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","content_uri":"data:,44.com","content_sha":"0x4d32c0fcbcd6e2df74123df885c970c98856c580c1a23c66ff43a71636fdfca7","esip6":false,"mimetype":"text\/plain","media_type":"text","mime_subtype":"plain","gas_price":"16216475192.0","gas_used":21192,"transaction_fee":"343659542268864.0","value":"0.0","created_at":"2024-01-11 16:22:58","updated_at":"2024-01-11 16:22:58"},{"id":288653,"transaction_hash":"0x02ceb5dd6de6b6254ca9f81be616a5be15c740457ec7b11cd7685ca30be6f106","block_number":17557694,"transaction_index":151,"block_timestamp":1687710671,"block_blockhash":"0x8ea6fca99cb380b3275c265819b25e5159dd0e0cd87e92bded129ad015f8babe","event_log_index":null,"ethscription_number":288652,"creator":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","initial_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","current_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","previous_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","content_uri":"data:,33.com","content_sha":"0xc824ebdf34c8488d7a1a014d9ab42ca9d03654075e2b4f54737330d362d19061","esip6":false,"mimetype":"text\/plain","media_type":"text","mime_subtype":"plain","gas_price":"17179331650.0","gas_used":21192,"transaction_fee":"364064396326800.0","value":"0.0","created_at":"2024-01-11 16:22:58","updated_at":"2024-01-11 16:22:58"},{"id":288689,"transaction_hash":"0xa5a8245e8c2fff7410b6b7697c67818c714048a42f6eac16fcb7c8840a2cf02d","block_number":17557696,"transaction_index":113,"block_timestamp":1687710695,"block_blockhash":"0x4b9eed9a0d4d0cce27272d5c9d3738db788d6992ed6a551af7b4bd3383112bff","event_log_index":null,"ethscription_number":288688,"creator":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","initial_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","current_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","previous_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","content_uri":"data:,22.com","content_sha":"0x3a9ee528daf6321e1e796bd965c8394126cda1d73d64de4df1ad5535f4cf0ec1","esip6":false,"mimetype":"text\/plain","media_type":"text","mime_subtype":"plain","gas_price":"16707155442.0","gas_used":21192,"transaction_fee":"354058038126864.0","value":"0.0","created_at":"2024-01-11 16:22:59","updated_at":"2024-01-11 16:22:59"},{"id":289255,"transaction_hash":"0x7ac629393427c9393503986b626acd20f6aca0e84cdc46274f89b03e6c821da5","block_number":17557719,"transaction_index":112,"block_timestamp":1687710971,"block_blockhash":"0xd19c8d64b3a123cd8e0a8c4895d5bde9f50a9b74eb57c6d7a3ea1b1861a2a103","event_log_index":null,"ethscription_number":289254,"creator":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","initial_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","current_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","previous_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","content_uri":"data:,1234.btc","content_sha":"0x8962e15337047b9329c0695d12c41da645134ca17fd9ece2ae7bddeac1ca986e","esip6":false,"mimetype":"text\/plain","media_type":"text","mime_subtype":"plain","gas_price":"15032563782.0","gas_used":21224,"transaction_fee":"319051133709168.0","value":"0.0","created_at":"2024-01-11 16:23:07","updated_at":"2024-01-11 16:23:07"},{"id":299793,"transaction_hash":"0xc2bc4541a2d5fe7a7a23aba30d5d2948d2831114d2156ad59d8927b11d706035","block_number":17560500,"transaction_index":98,"block_timestamp":1687744823,"block_blockhash":"0x48edbfe0cf1db73d0ebd76122cf89599cbecec1f5c62dc1efb4c620bd723d776","event_log_index":null,"ethscription_number":299792,"creator":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","initial_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","current_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","previous_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","content_uri":"data:,{\"p\":\"erc-20\",\"op\":\"mint\",\"tick\":\"punk\",\"id\":\"8800\",\"amt\":\"1\"}","content_sha":"0xabd466a7842f4c9f6db07c1044a22b822b3b5f5e874bcfd1e2fc1afc08bcaadb","esip6":false,"mimetype":"text\/plain","media_type":"text","mime_subtype":"plain","gas_price":"12725591748.0","gas_used":22088,"transaction_fee":"281082870529824.0","value":"0.0","created_at":"2024-01-11 16:32:18","updated_at":"2024-01-11 16:32:18"}],"pagination":{"page":1,"per_page":12,"total":301}}

3.Get Specific Ethscription

Returns JSON data of Ethscription

API

GET https://ethinscription.org/api/indexer/ethscriptions/{ethscription_number}

Example

GET https://ethinscription.org/api/indexer/ethscriptions/300012

Responses

{"id":300013,"transaction_hash":"0xed7af70a58acc464aca7512e214f23f928548db30848e1202522fd633aa9e246","block_number":17560663,"transaction_index":47,"block_timestamp":1687746803,"block_blockhash":"0xdbb61e2b753b3b2f5a20dca0e0b4c956f3a73f8d2568bcd9ab2e16505be0dc4f","event_log_index":null,"ethscription_number":300012,"creator":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","initial_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","current_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","previous_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","content_uri":"data:,{\"p\":\"erc-20\",\"op\":\"mint\",\"tick\":\"punk\",\"id\":\"7637\",\"amt\":\"1\"}","content_sha":"0x8f88374b6d6108e668cf5de5ae62f180b1e74cdd4fe3fbfb9e376532fe6b675e","esip6":false,"mimetype":"text\/plain","media_type":"text","mime_subtype":"plain","gas_price":"11952609875.0","gas_used":22088,"transaction_fee":"264009246919000.0","value":"0.0","created_at":"2024-01-11 16:32:41","updated_at":"2024-01-11 16:32:41","valid_transfers":[{"id":321506,"ethscription_transaction_hash":"0xed7af70a58acc464aca7512e214f23f928548db30848e1202522fd633aa9e246","transaction_hash":"0xed7af70a58acc464aca7512e214f23f928548db30848e1202522fd633aa9e246","from_address":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","to_address":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","block_number":17560663,"block_timestamp":1687746803,"block_blockhash":"0xdbb61e2b753b3b2f5a20dca0e0b4c956f3a73f8d2568bcd9ab2e16505be0dc4f","event_log_index":null,"transfer_index":0,"transaction_index":47,"enforced_previous_owner":null,"created_at":"2024-01-11 16:32:41","updated_at":"2024-01-11 16:32:41"}]}

4.Get data of an Ethscription

Returns Ethscription's raw decoded data in the correct mimetype

API

GET https://ethinscription.org/api/indexer/ethscriptions/{ethscription_number}/data

Example

GET https://ethinscription.org/api/indexer/ethscriptions/300012/data

Responses

data:,{"p":"erc-20","op":"mint","tick":"punk","id":"7637","amt":"1"}

5.Check If Content Exists as Ethscription

Check If Content Exists as Ethscription

API

GET https://ethinscription.org/api/indexer/ethscriptions/exists/{sha256}

Example

https://ethinscription.org/api/indexer/ethscriptions/exists/8f88374b6d6108e668cf5de5ae62f180b1e74cdd4fe3fbfb9e376532fe6b675e

Responses

{"result":true,"ethscription":{"id":300013,"transaction_hash":"0xed7af70a58acc464aca7512e214f23f928548db30848e1202522fd633aa9e246","block_number":17560663,"transaction_index":47,"block_timestamp":1687746803,"block_blockhash":"0xdbb61e2b753b3b2f5a20dca0e0b4c956f3a73f8d2568bcd9ab2e16505be0dc4f","event_log_index":null,"ethscription_number":300012,"creator":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","initial_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","current_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","previous_owner":"0x33f3601c9b44ced2b4043f5e2db65bff289c57c3","content_uri":"data:,{\"p\":\"erc-20\",\"op\":\"mint\",\"tick\":\"punk\",\"id\":\"7637\",\"amt\":\"1\"}","content_sha":"0x8f88374b6d6108e668cf5de5ae62f180b1e74cdd4fe3fbfb9e376532fe6b675e","esip6":false,"mimetype":"text\/plain","media_type":"text","mime_subtype":"plain","gas_price":"11952609875.0","gas_used":22088,"transaction_fee":"264009246919000.0","value":"0.0","created_at":"2024-01-11 16:32:41","updated_at":"2024-01-11 16:32:41"}}

Last updated