{
  "openrpc": "1.2.6",
  "info": {
    "title": "Ethereum OFAC Address Check",
    "description": "Quicknode Ethereum OFAC Address Check reference",
    "version": "1.0.0"
  },
  "methods": [
    {
      "name": "ofac_chainAddresses",
      "summary": "Returns every sanctioned address on the latest list for a chain.",
      "description": "Returns every sanctioned address on the latest list for a chain.",
      "params": [
        {
          "name": "chain",
          "description": "The chain identifier whose sanctioned addresses to return, such as eth. Use ofac_chains to retrieve current identifiers",
          "required": true,
          "schema": {
            "type": "string"
          }
        }
      ],
      "result": {
        "name": "result",
        "description": "An array of sanctioned blockchain addresses for the requested chain",
        "schema": {
          "type": "array",
          "items": {}
        }
      },
      "tags": [
        {
          "name": "ofac"
        }
      ],
      "externalDocs": {
        "description": "Quicknode docs",
        "url": "https://www.quicknode.com/docs/ethereum/ofac_chainAddresses"
      },
      "examples": [
        {
          "name": "ofac_chainAddresses example",
          "params": [
            {
              "name": "chain",
              "value": "eth"
            }
          ],
          "result": {
            "name": "ofac_chainAddresses result",
            "value": [
              "0x0330070fd38ec3bb94f58fa55d40368271e9e54a",
              "0x038989cbb1710c72b9920dc4fa529158f463e72c",
              "0x04dba1194ee10112fe6c3207c0687def0e78bacf"
            ]
          }
        }
      ]
    },
    {
      "name": "ofac_chains",
      "summary": "Returns all chains and their sanctioned-address counts on the latest list.",
      "description": "Returns all chains and their sanctioned-address counts on the latest list.",
      "params": [],
      "result": {
        "name": "result",
        "description": "The chains included in the latest sanctioned-address list",
        "schema": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "chain": {
                "type": "string",
                "description": "The chain identifier used by the OFAC Address Check methods"
              },
              "address_count": {
                "type": "integer",
                "description": "The number of sanctioned addresses for the chain"
              }
            }
          }
        }
      },
      "tags": [
        {
          "name": "ofac"
        }
      ],
      "externalDocs": {
        "description": "Quicknode docs",
        "url": "https://www.quicknode.com/docs/ethereum/ofac_chains"
      },
      "examples": [
        {
          "name": "ofac_chains example",
          "params": [],
          "result": {
            "name": "ofac_chains result",
            "value": [
              {
                "chain": "arb",
                "address_count": 1
              },
              {
                "chain": "bch",
                "address_count": 7
              },
              {
                "chain": "bnb",
                "address_count": 1
              },
              {
                "chain": "bsc",
                "address_count": 1
              },
              {
                "chain": "bsv",
                "address_count": 1
              },
              {
                "chain": "btg",
                "address_count": 1
              },
              {
                "chain": "dash",
                "address_count": 5
              },
              {
                "chain": "doge",
                "address_count": 2
              },
              {
                "chain": "etc",
                "address_count": 1
              },
              {
                "chain": "eth",
                "address_count": 100
              },
              {
                "chain": "ltc",
                "address_count": 13
              },
              {
                "chain": "sol",
                "address_count": 4
              },
              {
                "chain": "trx",
                "address_count": 198
              },
              {
                "chain": "usdc",
                "address_count": 2
              },
              {
                "chain": "usdt",
                "address_count": 93
              },
              {
                "chain": "xbt",
                "address_count": 527
              },
              {
                "chain": "xmr",
                "address_count": 11
              },
              {
                "chain": "xrp",
                "address_count": 1
              },
              {
                "chain": "xvg",
                "address_count": 1
              },
              {
                "chain": "zec",
                "address_count": 4
              }
            ]
          }
        }
      ]
    },
    {
      "name": "ofac_check",
      "summary": "Checks whether an address appears on the OFAC SDN sanctioned-address list for a chain.",
      "description": "Checks whether an address appears on the OFAC SDN sanctioned-address list for a chain.",
      "params": [
        {
          "name": "chain",
          "description": "The chain identifier to screen, such as eth. Use ofac_chains to retrieve current identifiers",
          "required": true,
          "schema": {
            "type": "string"
          }
        },
        {
          "name": "address",
          "description": "The blockchain address to screen",
          "required": true,
          "schema": {
            "type": "string"
          }
        }
      ],
      "result": {
        "name": "result",
        "description": "The sanctions screening result",
        "schema": {
          "type": "object",
          "properties": {
            "address": {
              "type": "string",
              "description": "The screened blockchain address"
            },
            "chain": {
              "type": "string",
              "description": "The chain identifier used for screening"
            },
            "list_version": {
              "type": "integer",
              "description": "The sanctioned-address list version used for screening"
            },
            "sanctioned": {
              "type": "boolean",
              "description": "Whether the address appears on the OFAC SDN sanctioned-address list"
            }
          }
        }
      },
      "tags": [
        {
          "name": "ofac"
        }
      ],
      "externalDocs": {
        "description": "Quicknode docs",
        "url": "https://www.quicknode.com/docs/ethereum/ofac_check"
      },
      "examples": [
        {
          "name": "ofac_check example",
          "params": [
            {
              "name": "chain",
              "value": "eth"
            },
            {
              "name": "address",
              "value": "0x0330070fd38ec3bb94f58fa55d40368271e9e54a"
            }
          ],
          "result": {
            "name": "ofac_check result",
            "value": {
              "address": "0x0330070fd38ec3bb94f58fa55d40368271e9e54a",
              "chain": "eth",
              "list_version": 1,
              "sanctioned": true
            }
          }
        }
      ]
    },
    {
      "name": "ofac_getList",
      "summary": "Returns a specific sanctioned-address list artifact by version and its detached Ed25519 signature.",
      "description": "Returns a specific sanctioned-address list artifact by version and its detached Ed25519 signature.",
      "params": [
        {
          "name": "version",
          "description": "The sanctioned-address list version to return",
          "required": true,
          "schema": {
            "type": "integer"
          }
        }
      ],
      "result": {
        "name": "result",
        "description": "The signed sanctioned-address list",
        "schema": {
          "type": "object",
          "properties": {
            "artifact": {
              "type": "object",
              "properties": {
                "version": {
                  "type": "integer",
                  "description": "The sanctioned-address list version"
                },
                "upstream_published_at": {
                  "type": "string",
                  "description": "The publication date of the upstream OFAC SDN source in YYYY-MM-DD format"
                },
                "generated_at": {
                  "type": "string",
                  "description": "The UTC timestamp when the artifact was generated"
                },
                "source": {
                  "type": "string",
                  "description": "The URL of the upstream OFAC SDN source"
                },
                "chains": {
                  "type": "object",
                  "properties": {
                    "eth": {
                      "type": "array",
                      "items": {},
                      "description": "An example chain entry containing Ethereum sanctioned addresses. Other chain identifiers use the same array format"
                    }
                  },
                  "description": "A map of chain identifiers to arrays of sanctioned blockchain addresses"
                },
                "sha256": {
                  "type": "string",
                  "description": "The SHA-256 digest of the artifact"
                }
              },
              "description": "The versioned sanctioned-address list artifact"
            },
            "signature": {
              "type": "string",
              "description": "The Base64-encoded detached Ed25519 signature for the artifact"
            }
          }
        }
      },
      "tags": [
        {
          "name": "ofac"
        }
      ],
      "externalDocs": {
        "description": "Quicknode docs",
        "url": "https://www.quicknode.com/docs/ethereum/ofac_getList"
      },
      "examples": [
        {
          "name": "ofac_getList example",
          "params": [
            {
              "name": "version",
              "value": 1
            }
          ],
          "result": {
            "name": "ofac_getList result",
            "value": {
              "artifact": {
                "version": 1,
                "upstream_published_at": "2026-08-20",
                "generated_at": "2026-08-20T20:38:07Z",
                "source": "https://sanctionslistservice.ofac.treas.gov/api/download/SDN.XML",
                "chains": {
                  "eth": [
                    "0x0330070fd38ec3bb94f58fa55d40368271e9e54a",
                    "0x038989cbb1710c72b9920dc4fa529158f463e72c",
                    "0x04dba1194ee10112fe6c3207c0687def0e78bacf"
                  ]
                },
                "sha256": "a59df1bafec28dc8f8cb6d47f09261efcc1e3ea74a67b405a9c53b1d2b9b299c"
              },
              "signature": "AFB/sLdJZWVB9PVbThiyGeECH4dhJw2b0xL6x/cx9IxpONwvIXUMeuldLhfYo5kfUet6iQ1VcIjB5gH22QakDQ=="
            }
          }
        }
      ]
    },
    {
      "name": "ofac_latestList",
      "summary": "Returns the latest published sanctioned-address list artifact and its detached Ed25519 signature.",
      "description": "Returns the latest published sanctioned-address list artifact and its detached Ed25519 signature.",
      "params": [],
      "result": {
        "name": "result",
        "description": "The signed sanctioned-address list",
        "schema": {
          "type": "object",
          "properties": {
            "artifact": {
              "type": "object",
              "properties": {
                "version": {
                  "type": "integer",
                  "description": "The sanctioned-address list version"
                },
                "upstream_published_at": {
                  "type": "string",
                  "description": "The publication date of the upstream OFAC SDN source in YYYY-MM-DD format"
                },
                "generated_at": {
                  "type": "string",
                  "description": "The UTC timestamp when the artifact was generated"
                },
                "source": {
                  "type": "string",
                  "description": "The URL of the upstream OFAC SDN source"
                },
                "chains": {
                  "type": "object",
                  "properties": {
                    "eth": {
                      "type": "array",
                      "items": {},
                      "description": "An example chain entry containing Ethereum sanctioned addresses. Other chain identifiers use the same array format"
                    }
                  },
                  "description": "A map of chain identifiers to arrays of sanctioned blockchain addresses"
                },
                "sha256": {
                  "type": "string",
                  "description": "The SHA-256 digest of the artifact"
                }
              },
              "description": "The versioned sanctioned-address list artifact"
            },
            "signature": {
              "type": "string",
              "description": "The Base64-encoded detached Ed25519 signature for the artifact"
            }
          }
        }
      },
      "tags": [
        {
          "name": "ofac"
        }
      ],
      "externalDocs": {
        "description": "Quicknode docs",
        "url": "https://www.quicknode.com/docs/ethereum/ofac_latestList"
      },
      "examples": [
        {
          "name": "ofac_latestList example",
          "params": [],
          "result": {
            "name": "ofac_latestList result",
            "value": {
              "artifact": {
                "version": 1,
                "upstream_published_at": "2026-08-20",
                "generated_at": "2026-08-20T20:38:07Z",
                "source": "https://sanctionslistservice.ofac.treas.gov/api/download/SDN.XML",
                "chains": {
                  "eth": [
                    "0x0330070fd38ec3bb94f58fa55d40368271e9e54a",
                    "0x038989cbb1710c72b9920dc4fa529158f463e72c",
                    "0x04dba1194ee10112fe6c3207c0687def0e78bacf"
                  ]
                },
                "sha256": "a59df1bafec28dc8f8cb6d47f09261efcc1e3ea74a67b405a9c53b1d2b9b299c"
              },
              "signature": "AFB/sLdJZWVB9PVbThiyGeECH4dhJw2b0xL6x/cx9IxpONwvIXUMeuldLhfYo5kfUet6iQ1VcIjB5gH22QakDQ=="
            }
          }
        }
      ]
    },
    {
      "name": "ofac_listVersions",
      "summary": "Returns the version numbers of all published sanctioned-address lists.",
      "description": "Returns the version numbers of all published sanctioned-address lists.",
      "params": [],
      "result": {
        "name": "result",
        "description": "An array of published sanctioned-address list version numbers",
        "schema": {
          "type": "array",
          "items": {}
        }
      },
      "tags": [
        {
          "name": "ofac"
        }
      ],
      "externalDocs": {
        "description": "Quicknode docs",
        "url": "https://www.quicknode.com/docs/ethereum/ofac_listVersions"
      },
      "examples": [
        {
          "name": "ofac_listVersions example",
          "params": [],
          "result": {
            "name": "ofac_listVersions result",
            "value": [
              1
            ]
          }
        }
      ]
    }
  ],
  "servers": [
    {
      "name": "OFAC Address Check",
      "url": "https://docs-demo.quiknode.pro"
    }
  ]
}