DUdune

Submit contracts for decoding

Changed on

Submit up to 100 contracts (with their ABIs) for decoding in one request. Each item is validated and queued independently; the response reports a per-item result matched by index. Successful items are queued as "pending" and can be tracked with GET /v1/contracts/submissions or at dune.com/workspace. Submissions are attributed to the user who created the API key. "upgrade" submissions and protected namespaces are always routed to manual review.

post/v1/contracts/decode

Request

  • Base URL
    https://api.dune.com/api
  • URL
    https://api.dune.com/api/v1/contracts/decode
  • Auth
    none declared. Required headers: X-Dune-Api-Key

Query parameters

api_keystring

API Key, alternative to using the HTTP header X-Dune-Api-Key

Headers

X-Dune-Api-Keystring required

API Key for the service

Request body

Example request

{
  "submissions": [
    {
      "address": "0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984",
      "blockchain_name": "ethereum",
      "contract_name": "UniswapToken",
      "idempotency_key": "abi-refresh-2026-09-09/0",
      "project_name": "uniswap",
      "submission_type": "new"
    }
  ]
}

Response

OK

Example response

{
  "results": [
    {
      "error": "abi must be valid JSON",
      "status": "pending",
      "submission_id": "01J8Z2X4K7Q9R3T5V6W8Y0A1B2"
    }
  ]
}

Changes